Data API / X / Trends

Get Trends

Get the trending topics for a location, identified by its Yahoo WOEID (Where On Earth ID), with an optional count (default 30). Use this for a real-time read on what a specific market is talking about right now — useful for timing content or spotting emerging stories. Returns trend names and volumes under trends. Once you pick a trend, search its posts with get_twitter_tweet_advanced_search.

Parameters

query

woeidintegerRequired
The WOEID of the location. Example: 2418046.
countintegerOptional
The number of trends to return. Default is 30.

Example request

curl -G "https://openapi.felo.ai/v1/beta/twitter/trends" \
  --data-urlencode "woeid=<integer>" \
  -H "Authorization: Bearer $FELO_API_KEY"

Response

Response fields

trendsobject[]Optional
namestringOptional
targetobjectOptional
querystringOptional
rankintegerOptional
meta_descriptionstringOptional
statusstringOptional
Allowed values: success · error
msgstringOptional