Skip to main content

Trending

Trending

Get real-time trending topics from X. Returns up to 50 trending hashtags and topics for any supported country, taken from X's native trending data.

GET/v2/trendingGet trending topics for a specific country.
ParameterTypeRequiredDefaultDescription
countrystringoptionalworldwideCountry name or code (e.g. "Vietnam", "Japan", "US", "GB"). Case-insensitive. Supports 62 countries.
BASH
curl "https://xcrop.io/api/v2/trending?country=US" \
  -H "Authorization: Bearer $XCROP_API_KEY"
ResponseJSON
{
  "data": [
    { "name": "#SmackDown", "url": "https://x.com/search?q=%23SmackDown", "query": "%23SmackDown", "volume": 41200 },
    { "name": "Verstappen", "url": "https://x.com/search?q=Verstappen", "query": "Verstappen", "volume": null },
    { "name": "#SuperBowl", "url": "https://x.com/search?q=%23SuperBowl", "query": "%23SuperBowl", "volume": 18300 }
  ],
  "meta": {
    "total": 50,
    "source": "place",
    "location": { "name": "United States", "woeid": 23424977 },
    "country": "united-states",
    "country_label": "United States",
    "latency_ms": 1840
  }
}

volume is the tweet count X reports for a trend and is null when X does not publish one. meta.country and meta.country_label echo the country the trends were fetched for.

Supported Countries

62 countries available (plus Worldwide): Algeria, Argentina, Australia, Austria, Bahrain, Belarus, Belgium, Brazil, Canada, Chile, Colombia, Denmark, Dominican Republic, Ecuador, Egypt, France, Germany, Ghana, Greece, Guatemala, India, Indonesia, Ireland, Israel, Italy, Japan, Jordan, Kenya, Korea, Kuwait, Latvia, Lebanon, Malaysia, Mexico, Netherlands, New Zealand, Nigeria, Norway, Oman, Pakistan, Panama, Peru, Philippines, Poland, Portugal, Puerto Rico, Qatar, Russia, Saudi Arabia, Singapore, South Africa, Spain, Sweden, Switzerland, Thailand, Turkey, Ukraine, United Arab Emirates, United Kingdom, United States, Venezuela, Vietnam.

ℹ
Returns up to 50 trending topics per country. You can use country names ("United States"), country codes ("US"), or common aliases ("USA", "UK"). Uses flat credit pricing (100 credits per call). Results are fetched live on every call.

More in REST API

Full documentation with search: xcrop.io/docs