# X/Twitter Quote Tweets Lookup via Surplus Intelligence

> X/Twitter Quote Tweets Lookup via Surplus Intelligence is a paid API for AI agents from www.surplusintelligence.ai, paid per call via x402, $0.248000/call, status unknown (last checked 2026-09-15).

Fetches the list of quote tweets for a given tweet ID using the Twitter v2 API, billed per call via x402 micropayment.

## Facts

- Endpoint: GET https://www.surplusintelligence.ai/x402/api/twitter/v2/tweets/:tweetId/quote_tweets
- Price: $0.248000/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/www-surplusintelligence-ai-b844ddc6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_igep6PC4nzooA4u3eMau3

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-b844ddc6
```

Example prompt: Can you pull all the quote tweets for tweet ID 1234567890123456789 — grab up to 50 results?

## When to prefer this

Use this endpoint when you need to retrieve quote tweets for a specific tweet using the Twitter v2 API without managing your own Twitter developer credentials, and you prefer pay-per-call micropayment billing via x402 (USDC). Ideal for agents doing social listening, engagement analysis, or content discovery around specific tweets.

## Known failure modes

- Invalid or non-numeric tweetId returns a 400 or Twitter API error
- Tweet not found or deleted returns a 404 or empty data array
- max_results out of range (0 or >100) returns a validation error
- Insufficient USDC balance or x402 payment failure results in a 402 Payment Required
- Rate limiting from upstream Twitter API returns a 429 error
- Private or protected tweet returns an authorization error

## How this service works

X/Twitter API v2 via Surplus Intelligence: Quote tweets (10 units)

## Output

Returns a JSON object with an array of tweet data objects representing quote tweets for the specified tweet, along with meta information (such as result count and pagination tokens) and any errors. Up to 100 results per call.

## 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"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "tweetId"
     ],
     "properties": {
      "tweetId": {
       "type": "string",
       "description": "Numeric X/Twitter tweet ID."
      }
     },
     "additionalProperties": false
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "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
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/www-surplusintelligence-ai-b844ddc6/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)