Find Public Communities by Keyword

View all X (Twitter) Public Data API endpoints →

Pass required query to discover candidate X Communities for a topic. Optional cursor continues results for the same query. Community discovery is separate from searching posts inside Communities; the latter has dedicated latest- and top-ranked endpoints. Exact community identifiers, descriptive keys, ranking behavior and no-match response shape have not been live-verified. Review returned matches for relevance and validate identifiers before using community-info, community-members or community-posts.

API Features

Topic-based Community discovery query seeks Communities related to a supplied keyword rather than posts from a preselected group.
Discovery-versus-post-search split Use this collection for candidate groups; dedicated Community post searches serve ranked discussion discovery.
Community search continuation Optional cursor keeps a discovery query consistent across further available result pages.
Validated Community-ID handoff Returned identifiers must be checked before they seed independent Community information, member or post requests.

Live API Demo

GET /api/project/twitter/communities-search

API Response (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/twitter/communities-search?key=<API_KEY>&query=superman'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

Frequently asked questions

How can I discover X Communities for a topic?

Send required query and use optional cursor for available continuation with the same keyword. Review candidate matches for relevance and validate their Community IDs before requesting information, members or posts. Exact discovery fields remain unverified.

Does Community discovery search the posts inside each group?

This endpoint discovers candidate Communities. Dedicated latest and top Community post search operations use query to discover discussion, while community-posts uses a known community_id for one group's timeline.

Related operations

Guides

View Subscription Plans →