{"uid":"cap_F6NcOobfRVzGX-QivH3tI","slug":"twitr-sh-x-twitter-community-reader-a4a40d54","name":"twitr.sh X/Twitter Community Reader","description":"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.","url":"https://twitr.sh/api/tools/x_communities","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"q":{"type":"string","description":"search: query within the community."},"id":{"type":"string","description":"Community ID."},"kind":{"enum":["info","members","moderators","tweets","search"],"type":"string","description":"What to read."},"resultsLimit":{"type":"integer","maximum":10000,"minimum":1,"description":"Mandatory for members/moderators/tweets/search: max items, billed per item."}}},"responseSchema":{"type":"json","example":{"items":[{"id":"2079908425904042170","name":"Build in Public","description":"Founders sharing progress, metrics, and lessons.","memberCount":48210}],"runId":"tw_example","payment":{"amount":"0.001200","currency":"USD","protocol":"x402"},"duration":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0024","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0024/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0024","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0024","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1OIXwUfGcBdOKyru9B1Rh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0024","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Reads X/Twitter Community data including profile info, member/moderator rosters, community tweets, and keyword search within a community.","exampleAgentPrompt":"Pull up the member roster for X/Twitter community ID 1234567890 — I want up to 200 members listed.","exampleUseCases":[{"title":"Community profile and size check","prompt":"Get me the profile info for X community ID 1599437842388996096 — I want to know its name, description, and member count."},{"title":"Moderator roster for community audit","prompt":"List all the moderators of X/Twitter community ID 1599437842388996096, up to 50 of them."},{"title":"Keyword search inside community","prompt":"Search for tweets about 'agentic AI' inside X community ID 1599437842388996096, return up to 100 results."}],"resultDescription":"Returns structured data about the community depending on the requested kind: profile info (name, description, member count, rules, etc.) for 'info'; paginated list of member profiles for 'members'; list of moderator profiles for 'moderators'; community tweet timeline for 'tweets'; or keyword-matched tweets within the community for 'search'. Rosters and tweets are billed per item returned.","failureModes":["Invalid or non-existent community ID returns an error","Missing 'resultsLimit' for members/moderators/tweets/search kinds causes a validation error","Search query missing when kind='search' causes a validation error","Private or restricted communities may return access-denied errors","resultsLimit out of range (below 1 or above 10000) triggers schema validation failure"],"whenToPreferThis":"Use this endpoint when you need to read data scoped specifically to an X/Twitter Community — its profile, its member or moderator list, its internal tweet feed, or keyword results within it. Prefer this over the general tweet search endpoint when you want results confined to a specific community rather than all of Twitter. Choose this over the user timeline endpoint when the focus is on community membership, moderation, or community-curated content rather than individual user activity.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T12:34:49.807Z","isFirstParty":false}