# twit.sh Quote Tweets Lookup

> twit.sh Quote Tweets Lookup is a paid API for AI agents from twit.sh, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-16).

Fetches the list of quote tweets for a given tweet ID, returning author info, text, and engagement metrics in real time.

## Facts

- Endpoint: GET https://twit.sh/tweets/quote_tweets
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/twit-sh-quote-tweets-lookup-be7aba95
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yRIFWdofrOHN9rURczPNR

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 twit-sh-quote-tweets-lookup-be7aba95
```

Example prompt: Can you pull all the quote tweets for tweet ID 1110302988 and show me who quoted it, what they said, and how many likes each quote got?

## When to prefer this

Use this endpoint when you need real-time quote tweet data for a specific tweet without managing Twitter API credentials. It is ideal for AI agents operating autonomously that need to pay per request in USDC rather than managing OAuth tokens or API key quotas. Prefer it over direct Twitter API access when you need zero-setup, pay-as-you-go social data retrieval at $0.01 per call.

## Known failure modes

- Missing or invalid tweet ID returns an error or empty data array
- Tweet ID for a deleted or private tweet returns no results
- Expired or invalid next_token causes pagination failure
- Rate limiting or payment failure (x402) returns a 402 Payment Required response
- Numeric tweet ID passed as wrong type may cause a validation error

## How this service works

Real-time Twitter/X data for AI agents. No sign-up, no API keys. Pay per request in USDC on Base via x402. Fully autonomous.

## Output

Returns a paginated list of quote tweets for the specified tweet ID. Each item includes the quote tweet's ID, text body, author (id, name, username), creation timestamp, and public engagement metrics (like_count, quote_count, reply_count, retweet_count). A next_token is included in the meta object when additional pages are available.

## 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": [
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "description": "Numeric tweet ID"
      },
      "next_token": {
       "type": "string",
       "description": "Pagination cursor from previous response"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "id": "1110302988",
    "text": "Running bitcoin",
    "author": {
     "id": "9253672",
     "name": "Hal Finney",
     "username": "halfin"
    },
    "created_at": "2009-01-11T03:39:18.000Z",
    "public_metrics": {
     "like_count": 134000,
     "quote_count": 3500,
     "reply_count": 5400,
     "retweet_count": 32000
    }
   }
  ],
  "meta": {
   "next_token": "abc123"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/twit-sh-quote-tweets-lookup-be7aba95/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twit.sh](https://www.zero.xyz/host/twit.sh/llms.txt)