Twitter / X
Query public users, posts, communities and 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.
- Type: integer Format: int64woeidrequired
The WOEID of the location. Example: 2418046.
- Type: integer Format: int64countmin:30
The number of trends to return. Default is 30.
- Type: object · TrendsResponse200
Successful response
- Type: stringmsg
- Type: string enumstatusvalues
- success
- error
- Type: array object[] · Trend[]trends
- metaType: string
_description - nameType: string
- rankType: integer Format: int64
Signed 64-bit integers (long type).
- targetType: object
- queryType: string
application/json - 400
The request could not be processed. Check the request parameters.
- 401
A valid Felo API key is required.
- 402
The request cannot proceed because a billing requirement is not met.
- 403
The account is not permitted to perform this operation.
- 429
A request or spending limit has been reached.
- 502
The service could not complete the request.
- 503
The API or billing service is temporarily unavailable.
- 504
The service timed out while processing the request.
- default
The operation failed. Keep the response request ID when contacting Felo support.
curl 'https://openapi.felo.ai/v1/beta/twitter/trends?woeid=1' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"trends": [
{
"name": "string",
"target": {
"query": "string"
},
"rank": 1,
"meta_description": "string"
}
],
"status": "success",
"msg": "string"
}