# X402 Atlas Twitter/X Tweet Search

> X402 Atlas Twitter/X Tweet Search is a paid API for AI agents from tweets.use.x402atlas.com, paid per call via x402, $0.005/call, status down (last checked 2026-10-13).

Search Twitter/X tweets using structured filters (keywords, user, hashtags, engagement thresholds, date ranges) and returns paginated tweet results with full text, author profiles, and engagement metrics

## Facts

- Endpoint: GET https://tweets.use.x402atlas.com/search?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: down
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-atlas-twitter-x-tweet-search-4d84d117
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gvvRnY3SNQdPvku-uJeVI

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 x402-atlas-twitter-x-tweet-search-4d84d117
```

Example prompt: Search for the top tweets mentioning 'bitcoin' from Elon Musk since 2024-01-01 that have at least 100 likes, and show me the latest results with full engagement metrics.

## When to prefer this

Use this endpoint when you need to search and filter Twitter/X tweets with fine-grained control over keywords, users, hashtags, engagement thresholds, date ranges, and tweet types. Prefer this over generic web search when the task specifically requires Twitter data with structured engagement metrics and pagination support. Well-suited for social listening, trend monitoring, influencer research, or competitive analysis tasks.

## Known failure modes

- No tweets found matching the query — empty results array returned
- Invalid date format for since/until — returns 400 error
- Missing required search parameter (at least one of words, phrase, any_words, hashtags, from, to, mentioning, search_query) — returns 400 error
- Invalid cursor value — may return empty or unexpected results
- Rate limiting or payment failure — returns 402 Payment Required
- Twitter/X API unavailability — may return 503 or timeout

## How this service works

Search Twitter/X tweets with structured filters. Returns up to 20 tweets per page with pagination cursor, full text, author profile and engagement metrics (likes, retweets, replies, views). Params: words, phrase, any_words, none_words, hashtags, from, to, mentioning, filter, min_likes, min_retweets, min_replies, since, until, within_time, near, since_id, max_id, type (top|latest), cursor; search_query takes raw X search syntax. e.g. GET /search?words=bitcoin&from=elonmusk&min_likes=100.

## Output

Returns up to 20 tweets per page including full tweet text, author username and profile info, engagement metrics (likes, retweets, replies, views), tweet IDs, and a pagination cursor to fetch the next page of results.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "to": {
       "type": "string",
       "description": "Tweets sent in reply to this username"
      },
      "from": {
       "type": "string",
       "description": "Tweets sent by this username (@ optional), e.g. elonmusk"
      },
      "near": {
       "type": "string",
       "description": "Tweets geotagged near this location, e.g. Berlin or The Hague"
      },
      "type": {
       "enum": [
        "top",
        "latest"
       ],
       "type": "string",
       "description": "Result ranking: top (default) or latest. Latest returns tweets in descending ID order — paginate with cursor or max_id."
      },
      "since": {
       "type": "string",
       "description": "Tweets on or after this date, YYYY-MM-DD"
      },
      "until": {
       "type": "string",
       "description": "Tweets before this date, YYYY-MM-DD"
      },
      "words": {
       "type": "string",
       "description": "Tweets containing all these words, e.g. what's happening. At least one of words, phrase, any_words, hashtags, from, to, mentioning, search_query is required."
      },
      "cursor": {
       "type": "string",
       "description": "Pagination cursor from the previous response"
      },
      "filter": {
       "type": "string",
       "description": "Comma-separated content filters: replies, links, quote, media, images, videos"
      },
      "max_id": {
       "type": "string",
       "description": "Tweets at or before this tweet ID (inclusive) — crawl a timeline backward by passing the lowest ID from the current page"
      },
      "phrase": {
       "type": "string",
       "description": "Tweets containing this exact phrase, e.g. happy hour"
      },
      "hashtags": {
       "type": "string",
       "description": "Tweets with these hashtags (comma or space separated, # optional), e.g. ThrowbackThursday"
      },
      "since_id": {
       "type": "string",
       "description": "Tweets after this tweet ID (exclusive)"
      },
      "any_words": {
       "type": "string",
       "description": "Tweets containing
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-atlas-twitter-x-tweet-search-4d84d117/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tweets.use.x402atlas.com](https://www.zero.xyz/host/tweets.use.x402atlas.com/llms.txt)