Skip to content
cheapxapi
All endpoints

Get trends

GET/twitter/trends

Trending topics for a location.

Price: $0.0006 per request.

Parameters

  • woeidintegerrequired

    Location WOEID, e.g. 1 for worldwide, 23424977 for the United States.

    Example: 1

  • countinteger

    Number of trends to return.

Example request

curl "https://api.cheapxapi.com/twitter/trends?woeid=1" \
  -H "x-api-key: YOUR_KEY"

Response

Charged. Check status: success means data was returned; error (e.g. user not found) is also HTTP 200.

FieldType
trendsarray of object
trendobject
status"success" | "error"
msgstring
metadataobject
timestampinteger
refresh_interval_millisinteger
woeidobject
context_modestring

Status codes

200
Charged. Check status: success means data was returned; error (e.g. user not found) is also HTTP 200.
400
Invalid parameters (charged), or API key placed in the URL (not charged).
401
Missing or invalid API key (not charged).
402
Insufficient balance (not charged).
403
Account disabled (not charged).
404
Unknown endpoint (charged), or the requested item could not be found (not charged). Note: many endpoints report a missing user/tweet as HTTP 200 with "status":"error" instead; those are charged.
405
Only GET is supported (not charged).
429
Rate limit exceeded (not charged). Retry after the time in the Retry-After header.
503
Temporary service problem, or the endpoint is temporarily unavailable (not charged). Retry with exponential backoff.