# Twitter/X Trends by WOEID

> Twitter/X Trends by WOEID is a paid API for AI agents from twitter.use.x402atlas.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns ranked Twitter/X trends for a given geographic location (WOEID), including normalized search queries, context, post counts, and grouped related trends.

## Facts

- Endpoint: GET https://twitter.use.x402atlas.com/trends
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/twitter-x-trends-by-woeid-08bcf41d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-tZ64nuAt6obDFTc8DOX4

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability twitter-x-trends-by-woeid-08bcf41d
```

Example prompt: What are the top trending topics on Twitter/X right now worldwide — give me the ranked list with post counts and search queries (use WOEID 1 for worldwide).

## When to prefer this

Choose this endpoint when you need ranked, structured trend data for a specific geographic location on Twitter/X, complete with normalized search queries and post counts. It is ideal for social listening, marketing intelligence, content planning, or real-time monitoring of public discourse. Prefer this over a general Twitter search endpoint when you want what is organically trending (not a keyword-driven search) in a specific location.

## Known failure modes

- Invalid or non-existent WOEID returns an error or empty trend list
- WOEID not supported for trends (some locations have no trend data) returns zero trends
- Rate limiting or payment failure results in a 402 or 429 error
- Trends data may be temporarily unavailable during X/Twitter platform outages

## How this service works

Get ranked Twitter/X trends for a geographic WOEID with normalized search queries, context, post counts and related trends.

## Output

Returns a JSON object with the queried WOEID, timestamp of the query, total trend count, and an array of ranked trends. Each trend includes its rank, display name, normalized search query, optional context description, post count, and an array of grouped/related trend names.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "woeid"
     ],
     "properties": {
      "woeid": {
       "type": "integer",
       "minimum": 1,
       "description": "Yahoo Where On Earth ID returned by /locations; 1 means Worldwide"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "queried_at",
      "woeid",
      "trend_count",
      "trends"
     ],
     "properties": {
      "woeid": {
       "type": "integer",
       "minimum": 1
      },
      "trends": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "rank",
         "name",
         "search_query",
         "grouped_trends"
        ],
        "properties": {
         "name": {
          "type": "string"
         },
         "rank": {
          "type": "integer",
          "minimum": 1
         },
         "context": {
          "type": "string"
         },
         "post_count": {
          "type": "integer",
          "minimum": 0
         },
         "search_query": {
          "type": "string"
         },
         "grouped_trends": {
          "type": "array",
          "items": {
           "type": "string"
          }
         }
        }
       }
      },
      "queried_at": {
       "type": "string",
       "format": "date-time"
      },
      "trend_count": {
       "type": "integer",
       "minimum": 0
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "woeid": 2442047,
  "trends": [
   {
    "name": "#FogoChain",
    "rank": 1,
    "context": "Trending in Los Angeles",
    "post_count": 17100,
    "search_query": "#FogoChain",
    "grouped_trends": []
   },
   {
    "name": "Warren Buffett",
    "rank": 2,
    "context": "Business and finance · Trending",
    "post_count": 21600,
    "search_query": "\"Warren Buffett\"",
    "grouped_trends": [
     "Greg Abel",
     "CEO of Berkshire Hathaway"
    ]
   }
  ],
  "queried_at": "2026-07-26T12:00:00Z",
  "trend_count": 2
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/twitter-x-trends-by-woeid-08bcf41d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twitter.use.x402atlas.com](https://www.zero.xyz/host/twitter.use.x402atlas.com/llms.txt)