{"uid":"cap_oE-uK6IJVOOYjKIG8a9U0","slug":"twitter-x-community-search-12276537","name":"Twitter/X Community Search","description":"Search public X communities by query.","url":"https://twitter.use.x402atlas.com/search-communities","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["query"],"properties":{"query":{"type":"string","maxLength":200,"minLength":1,"description":"Community search text"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["queried_at","data","result_count"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":true}},"cursor":{"type":"string","description":"Opaque cursor for the next page, when supplied by X"},"queried_at":{"type":"string","format":"date-time"},"result_count":{"type":"integer","minimum":0}}}}}}},"responseSchema":{"type":"json","example":{"data":[{"name":"Technology","rest_id":"1493264213904560130","description":"A community for technology discussions","member_count":120000}],"cursor":"NEXT_PAGE_CURSOR","queried_at":"2026-07-26T12:00:00Z","result_count":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BnI_lb7Z9X7kHrdZvewQ_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search public X (Twitter) communities by a text query and return matching community results.","exampleAgentPrompt":"Can you search X communities for ones related to 'machine learning' and show me what comes up?","exampleUseCases":[{"title":"Discovering niche interest communities","prompt":"Find me public X communities about sustainable investing — I want to see what groups exist on that topic."},{"title":"Brand community research","prompt":"Search X communities for any groups related to 'electric vehicles' so I can see where EV enthusiasts hang out."},{"title":"Developer community scouting","prompt":"Look up X communities around 'open source software development' and give me a list of what's available."}],"resultDescription":"Returns a JSON object containing a list of matching public X community objects (with community metadata), a total result count, a query timestamp, and optionally an opaque pagination cursor for retrieving subsequent pages.","failureModes":["Empty query string returns a validation error (minLength:1 not met)","Query exceeding 200 characters is rejected","No matching communities found returns an empty data array with result_count of 0","X API rate limits or downtime may cause upstream errors","Payment failure (x402) prevents the call from being processed"],"whenToPreferThis":"Use this endpoint when you need to discover or enumerate public X communities matching a keyword or topic — ideal for community research, brand monitoring, or helping users find groups to join. Prefer this over general tweet search when the goal is to find community spaces rather than individual posts or users.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:42:33.016Z","isFirstParty":false}