Fetch latest posts from any X Community via pay-per-request x402 (USDC on Base).
What it does
The `/communities/posts` endpoint on twit.sh retrieves the latest posts from a specific X (Twitter) Community by its numeric community ID. This data is not available through the official X API. The endpoint returns X v2 API-compatible JSON including author information on each tweet, with pagination support via a `next_token` cursor. It is part of the broader twit.sh suite, which covers user lookups, tweet search, list data, community data, articles, and authenticated actions (like, retweet, follow, post).
Payment is handled entirely via the x402 protocol: the endpoint returns HTTP 402 with a machine-readable USDC payment request on Base mainnet. The agent settles the payment (no gas required on the agent side), retries with a payment proof header, and receives data. No API keys, OAuth, or account creation are needed. The fixed price for this endpoint is $0.01 USDC per request.
The full twit.sh API exposes over 25 endpoints spanning tweets, users, lists, communities, and articles, with prices ranging from $0.0025 to $0.01 USDC per call. An npm CLI skill (`npx twitsh`) is available for integration with AI agents such as Claude Code, Cursor, OpenClaw, and others.
Capabilities
Use cases
- —Monitor discussions and trends within specific X Communities
- —Aggregate community content for social listening dashboards
- —Feed X Community posts into AI agent workflows for analysis
- —Track community engagement and post volume over time
- —Build community-specific content curation tools
Fit
Best for
- —AI agents needing autonomous, keyless access to X Community posts
- —Developers who want pay-per-call Twitter data without managing API keys
- —Social media monitoring of X Communities not covered by the official API
Not for
- —High-volume bulk scraping (pay-per-request cost adds up)
- —Accessing private or restricted community content
- —Use cases requiring official X API compliance or SLAs
Quick start
curl -X GET 'https://x402.twit.sh/communities/posts?id=1693573582226665701'
# Returns 402 with USDC payment challenge.
# After settling via x402, retry with:
curl -X GET 'https://x402.twit.sh/communities/posts?id=1693573582226665701' \
-H 'X-PAYMENT: <payment_proof>'Example
Request
{
"url": "https://x402.twit.sh/communities/posts?id=1693573582226665701&next_token=abc123",
"method": "GET"
}Endpoint
Quality
Full OpenAPI schema with clear parameter definitions, pricing, and protocol details. The endpoint is live (402 challenge captured). However, no example response body schema is documented, and the /docs path returns 404, so response structure must be inferred from the 'X v2 API-compatible' claim.
Warnings
- —No response schema documented for the 200 response — actual JSON structure is undocumented beyond 'X v2 API-compatible'.
- —The /docs, /pricing, and /api paths all return 404, so there is no supplementary documentation site.
- —Community data endpoints are described as 'not available in the official X API' — this may indicate unofficial/scraping-based data sourcing with associated reliability risks.
Citations
- —The /communities/posts endpoint retrieves the latest posts from a specific X Community, not available in the official X API, at $0.01 USDC per request.https://x402.twit.sh
- —Payment is via x402 protocol using USDC on Base mainnet with no API keys or account required.https://x402.twit.sh
- —Data is returned in X v2 API-compatible JSON format.https://x402.twit.sh
- —Prices range from $0.0025 to $0.01 USDC per call across the API.https://x402.twit.sh
- —An npm CLI skill (npx twitsh) is available for AI agent integration.https://x402.twit.sh