# Twitter/X Trends API — fetcher.sh

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

Returns current trending topics on Twitter/X, payable per-call in USDC with no OAuth or subscription required.

## Facts

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

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-trends-api-fetcher-sh-d6abd517
```

Example prompt: What topics are trending on Twitter/X right now? Pull the current trends list from fetcher.sh — no Twitter account needed, just pay per call.

## When to prefer this

Choose this endpoint when you need current Twitter/X trending topics without setting up OAuth credentials, a developer account, or a paid Twitter API subscription. Ideal for agents, automation pipelines, or dashboards that need occasional trend lookups on a pay-per-call basis in USDC. Prefer over the official Twitter API when you want frictionless per-call billing without account management overhead.

## Known failure modes

- Insufficient USDC balance or payment failure — returns 402 Payment Required
- Twitter/X platform rate limiting or scraping blocks — may return 429 or 503
- No trends available for a requested location — returns empty list or error
- Invalid location parameter — returns 400 Bad Request
- Twitter/X platform downtime — returns 503 Service Unavailable

## How this service works

Twitter / X (x.com) data and scraping API: Search tweets, resolve profiles by handle or ID, and pull timelines, replies, followers, lists, and trends. 15 REST endpoints from $0.002 – $0.005 per call — no account, no OAuth, no subscription. Pay with x402 (USDC on Base, Polygon, Arbitrum, Monad or Solana) or prepaid credits.

## Output

A list of currently trending topics on Twitter/X, typically including trend names, associated hashtags, tweet volume counts where available, and URLs to the trend pages. Data reflects real-time or near-real-time trending state on 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/twitter-x-trends-api-fetcher-sh-d6abd517/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twitter.fetcher.sh](https://www.zero.xyz/host/twitter.fetcher.sh/llms.txt)