# Twitter/X Trending Topics Scraper

> Twitter/X Trending Topics Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Fetches structured snapshots of Twitter/X trending topics for a specified country across multiple time windows (live, hourly, and daily archives).

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/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-x-trending-topics-scraper-98112dc8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TRb2Qi-b3t94SdY550JiN

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-scraper-98112dc8 -d '<json body>'
```

Example prompt: What are the top trending topics on Twitter/X in the United States right now? Include the live snapshot plus the one from about an hour ago, and cap results at 100 trends.

## When to prefer this

Choose this endpoint when you need structured, ranked Twitter/X trend data for a specific country or globally, across multiple time windows, without managing your own scraping infrastructure. It is pay-per-successful-call, so failed or empty runs are free. Prefer this over general web-scraping endpoints when you specifically need Twitter trend rankings with volume data, timestamps, and country segmentation in a ready-to-use JSON format.

## Known failure modes

- Dated country archive pages (day2/day3) may be unavailable for certain countries, returning empty results — no charge applies
- Country not supported or misspelled returns an error or empty dataset
- Rate limiting or scraping blocks from Twitter/X may cause failed runs — no charge applies
- maxItems=0 with many snapshots selected may return very large payloads

## How this service works

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

## Output

Returns a JSON array of trend objects, each containing the trend name, rank, tweet volume, trend URL, country, observed timestamp, and time period label. Multiple snapshots (live, hourly, archived) may be merged into a single result set 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-x-trending-topics-scraper-98112dc8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)