Get X Trends
Retrieve trending topics on X for a given location using its WOEID (Where On Earth ID). Worldwide is 1 and the United States is 23424977. Only locations X publishes trends for are accepted. An unsupported WOEID is rejected and is not replaced with the Worldwide list.
Billing metadata: successful billable responses include the X-Desearch-Cost-Usd, X-Desearch-Usage-Count, X-Desearch-Service, and X-Desearch-Currency headers. JSON object responses also include optional cost_usd, usage_count, service, and currency fields. For example, usage_count=10 at $0.015 / 1,000 resolves to cost_usd=0.00015. JSON arrays, text, and streaming responses keep their body shape and expose billing metadata only through headers.
Request
- Base URL: https://api.desearch.ai
- URL: https://api.desearch.ai/twitter/trends
- Auth: API key in header Authorization
Query parameters
WOEID of a location X publishes trends for. Worldwide is 1. The United States is 23424977. An unsupported WOEID is rejected.
The number of trends to return. Minimum is 30, maximum is 100.
Response
A JSON object containing the list of trending topics.
Changes
No recorded changes to this operation across all 1 revision of this API.