# X Tweet Search via x402 (botsmith.dev)

> X Tweet Search via x402 (botsmith.dev) is a paid API for AI agents from x402.botsmith.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-21, last successful call 2026-07-24).

Search X (Twitter) posts using full advanced-search syntax and return up to 20 results per call as clean JSON with engagement metrics, entities, and pagination cursor.

## Facts

- Endpoint: GET https://x402.botsmith.dev/x/search?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Last successful call: 2026-07-24
- Success rate: 71% of calls made through Zero
- Rating: 1.3 / 5 from 1 review
- Activations on Zero: 7
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x-tweet-search-via-x402-botsmith-dev-f81d80d4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_emA6uDm4kX1EAsOzOMM2R

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 x-tweet-search-via-x402-botsmith-dev-f81d80d4
```

Example prompt: Search X for the latest posts mentioning 'x402 from:coinbase' since 2026-07-01, sorted by Latest, and give me up to 20 results with their engagement numbers.

## When to prefer this

Use this endpoint when you need to search X/Twitter posts without holding an X developer account or API key, especially when you need advanced-search operators (from:, since:, until:, boolean) and want clean structured JSON output with engagement metrics. Prefer this over scraping or the official X API when cost predictability ($0.01/call), no-auth access, and entity extraction (hashtags, mentions, links) matter.

## Known failure modes

- Invalid or unsupported query syntax returns an error response
- Cursor value is malformed or expired, preventing pagination
- Query exceeds 400-character max length
- No tweets found matching the query returns an empty tweets array
- Payment of $0.01 USDC not fulfilled via x402 protocol results in 402 response
- Rate limiting or X platform unavailability causes timeout or partial results

## How this service works

X Tweet Search ($0.02/call): Search X (Twitter) posts with full advanced-search syntax (from:, since:, until:, exact phrases, boolean operators). Returns up to 20 posts per call as clean JSON with metrics and entities, plus a cursor for the next page. No X account or API key needed.

## Output

Returns a JSON object containing an array of up to 20 tweets, each with id, url, full text, author (handle, name, id), creation timestamp, language, engagement metrics (likes, retweets, replies, quotes, views), hashtags, mentions, and expanded outbound links. Also includes a hasNextPage boolean and a nextCursor string for fetching 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",
     "required": [
      "query",
      "type"
     ],
     "properties": {
      "type": {
       "enum": [
        "Latest",
        "Top"
       ],
       "type": "string",
       "default": "Latest",
       "description": "Sort by recency or engagement"
      },
      "query": {
       "type": "string",
       "maxLength": 400,
       "minLength": 1,
       "description": "Search query, e.g. \"x402 from:coinbase since:2026-07-01\""
      },
      "cursor": {
       "type": "string",
       "pattern": "^[A-Za-z0-9+/=_-]{1,400}$",
       "description": "Pagination cursor from a previous call"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "tweets",
      "hasNextPage",
      "nextCursor"
     ],
     "properties": {
      "tweets": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "id",
         "url",
         "text",
         "createdAt",
         "lang",
         "author",
         "metrics",
         "hashtags",
         "links",
         "mentions"
        ],
        "properties": {
         "id": {
          "type": "string"
         },
         "url": {
          "anyOf": [
           {
            "type": "string"
           },
           {
            "type": "null"
           }
          ]
         },
         "lang": {
          "anyOf": [
           {
            "type": "string"
           },
           {
            "type": "null"
           }
          ]
         },
         "text": {
          "type": "string"
         },
         "links": {
          "type": "array",
          "items": {
           "type": "string"
          },
          "description": "Expanded outbound URLs"
         },
         "author": {
          "type": "object",
          "required": [
           "handle",
           "name",
           "id"
          ],
     
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x-tweet-search-via-x402-botsmith-dev-f81d80d4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.botsmith.dev](https://www.zero.xyz/host/x402.botsmith.dev/llms.txt)