Social · read$0.0012–$1.20 / call

X/Twitter Communities: Read X Communities, paid by the call.

Read an X/Twitter Community: profile info, member and moderator rosters, the community's tweets, or keyword search inside the community. Fixed price for info; billed per item for rosters, tweets, and search. No signup, no API keys — every request is paid in USDC through the HTTP 402 flow, and the exact price is quoted before you pay.

Quickstart

One endpoint: POST /api/tools/x_communities over HTTP, or the x_communities tool over MCP at POST /api/mcp.

curl -X POST https://twitr.sh/api/tools/x_communities \
  -H 'Content-Type: application/json' \
  -d '{"kind":"info","id":"2079908425904042170"}'

# → 402 Payment Required with the exact USDC price.
# Pay it (x402 on Base/Solana, MPP on Tempo) and retry the same request → 200 + data.
# x402-aware clients do both steps automatically.

How to use it

kind=info (fixed price) or members|moderators|tweets|search (per-item — resultsLimit MANDATORY). id = community ID. search additionally requires q.

The exact quote is returned in the 402 challenge before you pay — an agent always knows the cost first. Failed calls are never charged. Full input schema in the OpenAPI spec.

FAQ

What does the X/Twitter Communities tool do?

Read an X/Twitter Community: profile info, member and moderator rosters, the community's tweets, or keyword search inside the community. Fixed price for info; billed per item for rosters, tweets, and search. It is one of 14 pay-per-call X/Twitter tools on twitr.sh, available over HTTP (POST /api/tools/x_communities) and MCP (tool name x_communities).

How much does X/Twitter Communities cost?

$0.0012–$1.20 per call in USDC. The exact quote is returned in the 402 challenge before you pay — an agent always knows the cost first. Failed calls are never charged.

How do I call X/Twitter Communities without an API key?

POST https://twitr.sh/api/tools/x_communities with your input. The first response is HTTP 402 Payment Required carrying the exact price; pay it in USDC (x402 on Base or Solana, MPP on Tempo) and retry the identical request to get the data. No signup — the wallet is the account.

Can an AI agent use X/Twitter Communities through MCP?

Yes. Call the x_communities tool via the MCP endpoint at POST https://twitr.sh/api/mcp — tools/list is free, tools/call is payment-gated with a JSON-RPC 402. The installable agent skill at https://twitr.sh/skill.md covers the full workflow.

Related tools

X/Twitter ReadRead live X/Twitter data: look up a single tweet or user profile, batch-read up to 100 tweets or users at once, check whether one account follows another, fetch trending topics by region, extract a long-form article, or download tweet media. Pay per call in USDC — no API key, no signup; failed calls are never charged.
$0.0012–$1.20
X/Twitter SearchSearch X/Twitter tweets with the full operator set — keyword, exact phrase, from-user, language, date range, media type, minimum likes/retweets, verified-only — or search user profiles by keyword. Billed per tweet returned against your resultsLimit cap. Built for tracking what people say about a topic, brand, or ticker in real time.
$0.0012–$1.20
X/Twitter TimelineFetch a user's X/Twitter timeline — their tweets, replies, likes, media posts, or mentions — plus follower and following lists, and per-tweet engagement lists (who replied, quoted, retweeted, or favorited). Billed per item returned. The building block for monitoring what an account posts or ranking accounts by activity.
$0.0012–$1.20
Read the docs All 14 tools