# Twitter/X Trending Topics by Location

> Twitter/X Trending Topics by Location is a paid API for AI agents from x402.apidirect.io, paid per call via x402, $0.007/call, status unknown (last checked 2026-10-30).

Returns the current trending topics on Twitter/X for a specific location identified by its WOEID (Where On Earth ID).

## Facts

- Endpoint: GET https://x402.apidirect.io/v1/twitter/trends?utm_source=zero.xyz
- Price: $0.007/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/twitter-x-trending-topics-by-location-2e4ecd72
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_h_i9H136QERbnu6jphnK6

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-trending-topics-by-location-2e4ecd72
```

Example prompt: What are the trending topics on Twitter right now worldwide? Use WOEID 1 to get the global trends.

## When to prefer this

Choose this endpoint when you need real-time Twitter/X trending topics for a specific geographic location identified by WOEID. It is ideal for social listening, content strategy, news monitoring, or competitive analysis tied to Twitter trend data. Prefer this over generic search endpoints when you specifically need location-based Twitter trends rather than keyword search results or posts.

## Known failure modes

- Invalid or unsupported WOEID returns an error or empty result
- WOEID is a required integer — omitting it causes a validation error
- Twitter/X API rate limits or outages may result in failed responses
- Some locations may have no trends data available if Twitter doesn't track that WOEID
- Trends data may be stale if Twitter's underlying API caches results

## How this service works

Get the current trending topics for a specific location on Twitter/X.

## Output

A list of current trending topics on Twitter/X for the specified location, typically including trend names, associated hashtags, tweet volume counts, and related metadata such as trend URLs.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "woeid"
     ],
     "properties": {
      "woeid": {
       "type": "integer",
       "minimum": 1,
       "description": "Where On Earth ID for the location. Use 1 for Worldwide."
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/twitter-x-trending-topics-by-location-2e4ecd72/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.apidirect.io](https://www.zero.xyz/host/x402.apidirect.io/llms.txt)