Get Available Trends for a Country
View all X (Twitter) Public Data API endpoints →Supply required country to request available country-specific X trends. Accepted country values and formats have not been live-verified; do not assume the three-letter options used by inspiration-posts also apply here. Exact trend fields, ranking, topic-volume availability and unsupported-country behavior are unverified. Capture request value and collection time with the returned trends, and use observed terms as candidate post-search queries rather than precise user-location evidence.
API Features
Live API Demo
🔒 Sign in to try it live
Log in to call this API with your own API key. New accounts get 100 free credits — no card required.
Log in / Sign upNo active API key found. Create one in your Dashboard, then reload this page. Dashboard →
/api/project/twitter/trends API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/twitter/trends?key=<API_KEY>&country=<country>'
Query Result
Use Cases
- Capture available country-specific trends on a schedule to build an observed topic-change log.
- Use validated returned trend terms as candidate keywords for a country-focused editorial search workflow.
- Review emerging public topics for a communications briefing while documenting collection time and selector format.
- Compare equivalent country trend snapshots without assuming topic-volume fields or exact audience geography.
Frequently asked questions
Which country format should I send to the trends endpoint?
country is required, but accepted values and formats have not been live-verified. Validate a supported value for trends rather than assuming the three-letter choices documented for inspiration-posts also apply here.
Are trend volumes and users' locations guaranteed?
No. Exact trend fields, ranking and topic-volume availability remain unverified. Store the chosen country and collection time; a country trend selection does not establish an individual author's physical location.