# fetcher.sh Twitter Trends API

> fetcher.sh Twitter Trends API is a paid API for AI agents from fetcher.sh, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-13).

Fetches current trending topics on Twitter/X, paid per call in USDC via x402

## Facts

- Endpoint: GET https://fetcher.sh/api/twitter/trends
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fetcher-sh-twitter-trends-api-5d2ecac4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_y3GWr38IYl_zNrBmv0DGz

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 fetcher-sh-twitter-trends-api-5d2ecac4
```

Example prompt: What's trending on Twitter right now? Pull the current top trending topics for me — I want to see what's blowing up on X today.

## When to prefer this

Choose this endpoint when you need current Twitter/X trending topics without setting up OAuth credentials, developer app accounts, or monthly subscriptions. Ideal for AI agents that need pay-per-call access to social trend data, or for use cases requiring real-time trend signals at low cost ($0.005/call). Prefer this over Twitter's official API when avoiding credential management overhead is a priority, or when operating in an agentic environment using x402 micropayments on Base.

## Known failure modes

- Twitter/X platform changes breaking scraper (returns empty or malformed data)
- Rate limiting or blocking by Twitter resulting in failed fetch
- Invalid or unsupported location/region parameter returning no results
- Payment failure via x402 protocol blocking the call
- Temporary service downtime on fetcher.sh infrastructure

## How this service works

fetcher.sh is an x402 web-data and scraping API: 111 endpoints for Twitter/X, YouTube, TikTok, Instagram, Reddit, Google, App Store, and Yelp — paid per call in USDC on Base, Polygon, Arbitrum, Monad or Solana, or with prepaid credits. Built for AI agents: no accounts, no OAuth, no subscriptions.

## Output

Returns a list of currently trending topics on Twitter/X, typically including trend names, associated hashtags, tweet/post volume or rank, and potentially a category or location context. Data is scraped in real time from the platform.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fetcher-sh-twitter-trends-api-5d2ecac4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fetcher.sh](https://www.zero.xyz/host/fetcher.sh/llms.txt)