# Surplus Intelligence X/Twitter Recent Tweet Search

> Surplus Intelligence X/Twitter Recent Tweet Search is a paid API for AI agents from www.surplusintelligence.ai, paid per call via x402, $0.052000/call, status unknown (last checked 2026-09-14).

Searches recent tweets on X/Twitter using the v2 API search endpoint, returning up to 100 matching tweets for a given query

## Facts

- Endpoint: GET https://www.surplusintelligence.ai/x402/api/twitter/v2/tweets/search/recent
- Price: $0.052000/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 3
- Tags: x402
- Canonical page: https://www.zero.xyz/c/www-surplusintelligence-ai-6a225f89
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_s7oaG02SwxM8GzVwZ5kFq

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 www-surplusintelligence-ai-6a225f89
```

Example prompt: Search recent tweets about 'OpenAI GPT-5' on X/Twitter and return up to 20 results — I want to see what people are saying about it right now.

## When to prefer this

Use this endpoint when you need to search recent tweets on X/Twitter via a pay-per-call model without managing your own Twitter API credentials or subscription. Ideal for agents that need on-demand social media search with USDC micropayments via the x402 protocol. Prefer this over direct Twitter API access when you want frictionless metered access billed per search at $0.052 per call.

## Known failure modes

- Invalid or overly complex search query syntax returns a 400 error
- Query returns zero results if no recent tweets match
- Rate limit or quota exhaustion returns a 429 or payment-related error
- Payment of 0.052 USDC not fulfilled returns a 402 Payment Required
- max_results out of range (below 1 or above 100) causes validation error

## How this service works

X/Twitter API v2 via Surplus Intelligence: Tweet search (10 units)

## Output

Returns a JSON object with an array of tweet data objects matching the search query, along with metadata including result count and pagination tokens. May also include an errors array if partial failures occurred.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "query": "artificial intelligence",
   "max_results": 10
  }
 }
}
```

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "query": {
       "type": "string",
       "description": "X/Twitter recent search query."
      },
      "max_results": {
       "type": "integer",
       "maximum": 100,
       "minimum": 1,
       "description": "Maximum number of results to return."
      }
     },
     "additionalProperties": true
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "data": {},
      "meta": {
       "type": "object"
      },
      "errors": {
       "type": "array"
      }
     },
     "additionalProperties": true
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "data",
  "meta"
 ],
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "id",
     "text",
     "edit_history_tweet_ids"
    ],
    "properties": {
     "id": {
      "type": "string"
     },
     "text": {
      "type": "string"
     },
     "edit_history_tweet_ids": {
      "type": "array",
      "items": {
       "type": "string"
      }
     }
    }
   }
  },
  "meta": {
   "type": "object",
   "required": [
    "newest_id",
    "oldest_id",
    "next_token",
    "result_count"
   ],
   "properties": {
    "newest_id": {
     "type": "string"
    },
    "oldest_id": {
     "type": "string"
    },
    "next_token": {
     "type": "string"
    },
    "result_count": {
     "type": "number"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/www-surplusintelligence-ai-6a225f89/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.surplusintelligence.ai](https://www.zero.xyz/host/www.surplusintelligence.ai/llms.txt)