# fetcher.sh Twitter Search API

> fetcher.sh Twitter Search 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-15).

Search Twitter/X for tweets matching a query, returning results paid per call in USDC via x402

## Facts

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

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-search-api-990a738b
```

Example prompt: Search Twitter for the latest tweets about 'OpenAI GPT-5' and show me what people are saying — I want recent posts, no login required, just pay per result.

## When to prefer this

Choose this endpoint when you need Twitter/X search data without setting up Twitter API credentials, OAuth flows, or developer accounts. Ideal for AI agents that need lightweight, pay-per-call access to social media data using USDC on Base — especially when avoiding recurring subscription costs or when operating in agentic pipelines that handle micropayments natively via x402.

## Known failure modes

- Query returns no results if the term is too obscure or rate-limited on the scraping side
- Payment failure if insufficient USDC balance on Base
- Twitter/X anti-scraping blocks may cause intermittent failures or stale data
- Malformed query parameters may return an error or empty result set
- Rate limiting at the fetcher.sh level if too many calls are made in quick succession

## 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 tweets matching the search query, typically including tweet text, author handle, timestamp, engagement counts (likes, retweets, replies), and tweet URLs — all fetched without requiring OAuth credentials or a Twitter developer account.

## 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-search-api-990a738b/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)