Get Trending Topics

Get X Explore trending topics for a given country. Use ‘worldwide’ for account-default trends or a country slug such as ‘united-states’.

Back to API Reference

/Trending Endpoints

TwexAPI REST

GET/twitter/{country}/trending

Authorization

AuthorizationBearer token · headerrequired

Global API Bearer Token for TwexAPI. Included as: Authorization: Bearer <YOUR_TWEXAPI_KEY>.

Path Parameters

countrystringrequired

Country slug or 'worldwide' for default explore trends

Allowed:worldwidealgeriaargentinaaustraliaaustriabahrainbelarusbelgiumbrazilcanadachilecolombiadenmarkdominican-republicecuadoregyptfrancegermanyghanagreeceguatemalaindiaindonesiairelandisraelitalyjapanjordankenyakoreakuwaitlatvialebanonmalaysiamexiconetherlandsnew-zealandnigerianorwayomanpakistanpanamaperuphilippinespolandportugalqatarrussiasaudi-arabiasingaporesouth-africaspainswedenswitzerlandthailandturkeyukraineunited-arab-emiratesunited-kingdomunited-statesvenezuelavietnamzimbabwe

Responses

200Standard response with list of trending topics in data field

codeintegerrequired

HTTP status code

msgstringrequired

Response message

dataany

Response data

Show properties

Any of:

any

any

any

any

422Validation Error

detailValidationError[]

Show properties

Array of ValidationError

locstring | integer[]required

Show properties

Array of string | integer

Any of:

string

string

integer

integer

msgstringrequired

typestringrequired

inputany

ctxobject

⚡Interactive Console / Try APIGET/twitter/{country}/trending

Live Console

🌐Target Server:https://api.twexapi.io

● Production Ready

🔍

Public Data Read (TwexAPI Key Only, No Twitter Cookie Required)

This endpoint queries public Twitter data — no Twitter account or Cookie required! Simply enter your TwexAPI Platform Key (Bearer Token) in the "API Authorization" section below to test.

🔑API Authorization

Remember keySync to code samples

TwexAPI Platform Key Bearer TokenRequired

Global API key used across all TwexAPI endpoints. Get it from the console.

⚙️Parameters (1)

countrypath

RequiredCountry slug or 'worldwide' for default explore trends

💡 Quick send:⌘ / Ctrl+Enter

📡

No Response Yet

Configure parameters in the Request tab and click Send Request below.

Request

curl -X GET "https://api.twexapi.io/twitter/worldwide/trending" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://api.twexapi.io/twitter/worldwide/trending", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.get(
    "https://api.twexapi.io/twitter/worldwide/trending",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response

{
  "code": 200,
  "msg": "success",
  "data": {}
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}