# Twitter/X Tweet Search API

> Twitter/X Tweet Search API is a paid API for AI agents from twitter-scraper.api.klymax402.com, paid per call via x402, $0.012/call, status unknown (last checked 2026-09-15).

Searches Twitter/X for tweets matching a query and returns up to 20 results with text, engagement metrics, author info, and timestamps.

## Facts

- Endpoint: GET https://twitter-scraper.api.klymax402.com/api/search
- Price: $0.012/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/twitter-x-tweet-search-api-7deef50d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_W1_nZaAThbCB90pismI81

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-tweet-search-api-7deef50d
```

Example prompt: Search Twitter for the top 15 tweets about 'OpenAI GPT-5' posted since 2025-01-01 and show me the text, author, and engagement numbers for each.

## When to prefer this

Choose this endpoint when you need to retrieve real-time or recent public tweet data for a given keyword, hashtag, mention, or user-based query, especially in agentic workflows requiring social listening, brand monitoring, or trend analysis. Prefer this over general web search when you specifically need structured tweet data with engagement metrics and author attribution from Twitter/X.

## Known failure modes

- No tweets found for the query — returns empty results
- Query syntax errors (malformed operators) may return unexpected results
- Twitter rate limiting or scraping blocks may cause partial or failed responses
- Date-based filters (since:) may yield no results if the timeframe is too narrow
- Count values outside 1-20 range may be clamped or cause errors

## How this service works

Search Twitter/X for tweets matching a query -- returns up to 20 results with text, engagement, author, and timestamps.

## Output

Returns up to 20 tweet objects, each containing the tweet text, author handle and display name, engagement metrics (likes, retweets, replies), and publication timestamp. Results are matched to the search query and may include keyword, hashtag, mention, and operator-based filtering.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "count": {
   "type": "number",
   "description": "Number of tweets to return (1-20, default 10)"
  },
  "query": {
   "type": "string",
   "description": "Search query -- supports keywords, phrases, hashtags (#), mentions (@), and operators (from:user, since:2026-01-01)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/twitter-x-tweet-search-api-7deef50d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twitter-scraper.api.klymax402.com](https://www.zero.xyz/host/twitter-scraper.api.klymax402.com/llms.txt)