# botsmith X Trends

> botsmith X Trends is a paid API for AI agents from x402.botsmith.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-31).

Returns the top 30 trending topics on X (Twitter) for a given location identified by Yahoo WOEID, with rank and search query for each trend.

## Facts

- Endpoint: GET https://x402.botsmith.dev/x/trends?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/botsmith-x-trends-703e67f3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yOV1F5W-lTUihY4YFZlA4

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 botsmith-x-trends-703e67f3
```

Example prompt: What are the top 30 trending topics on X right now in the United States? Use WOEID 23424977.

## When to prefer this

Choose this endpoint when you need real-time trending topic data from X/Twitter for a specific country or major city without needing an X API key or account. It is ideal for agents that monitor social sentiment, track viral topics, or need to seed further X searches. Prefer it over scraping or official X API when you want a simple pay-per-call model with no OAuth setup.

## Known failure modes

- Invalid or unsupported WOEID returns no trends or an error response
- Location has no trend data available (X only supports trends for certain countries and cities)
- X backend unavailability causing empty or stale trend data
- Payment failure via x402 protocol resulting in 402 response

## How this service works

X Trends ($0.005/call): Top 30 trending topics on X (Twitter) right now for a location by Yahoo WOEID: 1 worldwide, 23424977 United States, 23424975 United Kingdom, 23424856 Japan, 23424748 Australia, 2459115 New York, 44418 London. Each with rank and the search query to pull its posts. The location actually served is echoed back. No X account or API key needed.

## Output

A ranked list of up to 30 trending topics on X for the requested location, each with a rank integer, display name, and search query string usable to pull posts. Also includes the actual location served (WOEID + name) and the ISO 8601 timestamp when X computed the trends.

## 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",
       "default": 1,
       "maximum": 2147483647,
       "minimum": 1,
       "description": "Yahoo WOEID of a country or city; 1 = worldwide"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "location",
      "trends",
      "asOf"
     ],
     "properties": {
      "asOf": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "null"
        }
       ],
       "description": "ISO 8601 time X computed the trends"
      },
      "trends": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "rank",
         "name",
         "query"
        ],
        "properties": {
         "name": {
          "type": "string"
         },
         "rank": {
          "type": "integer",
          "maximum": 9007199254740991,
          "minimum": -9007199254740991
         },
         "query": {
          "anyOf": [
           {
            "type": "string"
           },
           {
            "type": "null"
           }
          ],
          "description": "Search query for this trend, usable with /x/search"
         }
        },
        "additionalProperties": false
       }
      },
      "location": {
       "type": "object",
       "required": [
        "woeid",
        "name"
       ],
       "properties": {
        "name": {
         "anyOf": [
          {
           "type": "string"
          },
          {
           "type": "null"
          }
         ]
        },
        "woeid": {
         "type": "integer",
         "maximum": 9007199254740991,
         "minimum": -9007199254740991
        }
       },
       "description": "Location served",
       "additionalProperties": false
      }
     },
     "additionalPropert
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/botsmith-x-trends-703e67f3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.botsmith.dev](https://www.zero.xyz/host/x402.botsmith.dev/llms.txt)