Get X/Twitter community members via x402 pay-per-request API — $0.01 USDC per call on Base
What it does
The `/communities/members` endpoint on twit.sh returns a paginated list of users who belong to a specific X (Twitter) Community, including full user profiles and community roles. This data is not available through the official X API. The endpoint accepts a numeric community ID and an optional pagination cursor, returning results in X v2 API-compatible JSON format.
twit.sh is a payment-gated Twitter/X data API that uses the x402 protocol. There are no API keys, accounts, or OAuth flows — agents pay per request in USDC on Base mainnet. When an unauthenticated request hits the endpoint, the server responds with HTTP 402 and a machine-readable payment challenge. The caller settles in USDC, retries with a payment proof header, and receives data. The `/communities/members` endpoint costs $0.01 USDC per request.
The broader twit.sh API covers user lookups (by username, ID, or search), tweet retrieval (by ID, user timeline, search with advanced filters, replies, quote tweets, retweets), list operations (details, members, followers, tweets), community data (details, posts, members), X Articles in markdown, and authenticated write actions (create/delete tweets, like, bookmark, retweet, follow/unfollow). Prices range from $0.0025 to $0.01 USDC per call. All endpoints return publicly available data shaped into clean JSON. An npm CLI skill (`npx twitsh`) is available for integration with AI agents like Claude, Cursor, and Codex.
Capabilities
Use cases
- —Retrieve the member list of an X Community for audience analysis or CRM enrichment
- —Monitor community membership changes over time by paginating through members periodically
- —Build agent workflows that cross-reference community members with follower/following graphs
- —Identify key participants and roles within X Communities for outreach or research
- —Power dashboards that visualize community composition and growth
Fit
Best for
- —AI agents needing programmatic access to X Community membership data without API keys
- —Developers who want pay-per-request Twitter data without managing OAuth credentials
- —Crypto-native applications that can settle micropayments in USDC on Base
- —Research and analytics pipelines that need community-level social graph data not in the official X API
Not for
- —High-volume bulk scraping where per-request costs would accumulate quickly
- —Applications that need real-time streaming or webhook-based community updates
- —Users without USDC on Base mainnet or an x402-compatible payment flow
Quick start
# 1. First request returns 402 with payment challenge
curl https://x402.twit.sh/communities/members?id=1693573582226665701
# 2. After settling USDC on Base, retry with payment proof
curl -H "X-PAYMENT: 0x<proof>" \
"https://x402.twit.sh/communities/members?id=1693573582226665701"Endpoint
Quality
Full OpenAPI schema with clear parameter definitions and pricing is available. The endpoint is live (402 challenge captured). However, there are no response body schemas or example responses for this specific endpoint, and the /docs page returns 404, so documentation beyond the landing page is thin.
Warnings
- —No response schema defined for the 200 response — the shape of returned community member data is undocumented in the OpenAPI spec.
- —The /docs, /api, /pricing, and /README paths all return 404, so documentation is limited to the landing page and OpenAPI spec.
- —Write endpoints (follow, like, tweet, etc.) require raw Twitter session cookies (auth_token, ct0) passed as query parameters, which poses security concerns.
Citations
- —The /communities/members endpoint costs $0.01 USDC per request and retrieves a paginated list of community members with full user profiles and community role.https://x402.twit.sh
- —Community member data is not available in the official X API.https://x402.twit.sh
- —twit.sh uses the x402 payment protocol — agents pay per request in USDC on Base mainnet with no account or API key required.https://x402.twit.sh
- —Prices across the API range from $0.0025 to $0.01 USDC per call.https://x402.twit.sh
- —An npm CLI skill (npx twitsh) is available for integration with AI agents.https://x402.twit.sh