# Twitter Trends Scraper (x402)

> Twitter Trends Scraper (x402) is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Returns structured snapshots of Twitter/X trending topics for a specified country across multiple time windows, billed per successful call via x402 micropayments.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/twitter-trends?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/twitter-trends-scraper-x402-32ce94e1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PZ4iHJlaTP5ubrnFrfI3_

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-trends-scraper-x402-32ce94e1 -d '<json body>'
```

Example prompt: Pull the current live Twitter trends plus the snapshot from 1 hour ago for the United States, and give me up to 200 trend rows.

## When to prefer this

Choose this endpoint when you need structured, multi-snapshot Twitter trend data for a specific country or globally, especially if you want to compare trends across time windows within a single call. It is pay-per-success, so failed or empty runs are free. Prefer this over manual scraping or general-purpose web scrapers when you need clean, row-level trend data (rank, volume, URL, timestamp) without building your own parser.

## Known failure modes

- Dated country archive pages (day2, day3) may be unavailable for certain countries, returning empty or partial results — not charged
- Empty result set if trends cannot be scraped for the requested country/time window
- Network or upstream Twitter page structure changes could cause parsing failures — not charged if empty
- Invalid country enum value returns a validation error

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

A JSON object with a count and an array of trend items, each containing: trend name, rank, tweet volume, trend URL, country, the time period label, and the observedAt timestamp. Multiple time-window snapshots are merged into a single list up to the maxItems cap.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "day2": {
   "type": "boolean",
   "default": false,
   "description": "Try the dated country archive from 2 days ago. Dated country pages may be unavailable."
  },
  "day3": {
   "type": "boolean",
   "default": false,
   "description": "Try the dated country archive from 3 days ago. Dated country pages may be unavailable."
  },
  "live": {
   "type": "boolean",
   "default": true,
   "description": "Include the current top 50 trend snapshot."
  },
  "hour1": {
   "type": "boolean",
   "default": true,
   "description": "Include the trend snapshot from about 1 hour ago."
  },
  "hour3": {
   "type": "boolean",
   "default": false,
   "description": "Include the trend snapshot from about 3 hours ago."
  },
  "hour6": {
   "type": "boolean",
   "default": false,
   "description": "Include the trend snapshot from about 6 hours ago."
  },
  "hour12": {
   "type": "boolean",
   "default": false,
   "description": "Include the trend snapshot from about 12 hours ago."
  },
  "hour24": {
   "type": "boolean",
   "default": false,
   "description": "Include the oldest available recent snapshot, usually 23 hours ago."
  },
  "country": {
   "enum": [
    "worldwide",
    "algeria",
    "argentina",
    "australia",
    "austria",
    "bahrain",
    "belarus",
    "belgium",
    "brazil",
    "canada",
    "chile",
    "colombia",
    "denmark",
    "dominican-republic",
    "ecuador",
    "egypt",
    "france",
    "germany",
    "ghana",
    "greece",
    "guatemala",
    "india",
    "indonesia",
    "ireland",
    "israel",
    "italy",
    "japan",
    "jordan",
    "kenya",
    "korea",
    "kuwait",
    "latvia",
    "lebanon",
    "malaysia",
    "mexico",
    "netherlands",
    "new-zealand",
    "nigeria",
    "norway",
    "oman",
    "pakistan",
    "panama",
    "peru",
    "philippines",
    "poland",
    "portugal",
    "puerto-rico",
    "qatar",
    "russia",
    "saudi-arabia",
    "singapore",
    "south-africa",
    "spain",
    "sweden",
    "switzerland",
    "thailand",
    "turkey",
    "ukraine",
    "united-arab-emirates",
    "united-kingdom",
    "united-states",
    "venezuela",
    "vietnam"
   ],
   "type": "string",
   "default": "united-states",
   "description": "Country whose public trending topics to collect. Worldwide collects global trends."
  },
  "maxItems": {
   "type": "integer",
   "default": 400,
   "minimum": 0,
   "description": "Stop after this many trend rows across selected snap
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "rank": null,
    "time": null,
    "trend": null,
    "volume": null,
    "country": null,
    "trendUrl": null,
    "observedAt": null,
    "timePeriod": null
   }
  ],
  "product": "twitter-trends"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/twitter-trends-scraper-x402-32ce94e1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)