# x402.twit.sh Bulk Tweet Lookup

> x402.twit.sh Bulk Tweet Lookup is a paid API for AI agents from x402.twit.sh, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-29, last successful call 2026-07-15).

Bulk fetch up to 50 Twitter/X tweets by their numeric IDs, returning full text, author profiles, and engagement metrics in a single request.

## Facts

- Endpoint: GET https://x402.twit.sh/tweets?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Last successful call: 2026-07-15
- Success rate: 100% of calls made through Zero
- Rating: 5.0 / 5 from 1 review
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-twit-sh-4a0ab01c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bit2YzBKBWc5cVAFYT1wG

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-twit-sh-4a0ab01c
```

Example prompt: Can you pull the full details — text, author, and engagement metrics — for these tweet IDs: 1110302988, 1234567890, and 9876543210?

## When to prefer this

Use this endpoint when you have a known list of tweet IDs (up to 50) and need their full content, author profiles, and engagement metrics in one call. Prefer this over single-tweet lookups when processing multiple tweets at once to save on API calls and cost. Ideal for analytics pipelines, content archiving, or enriching datasets that already contain tweet IDs.

## Known failure modes

- Invalid or non-numeric tweet IDs return an error response
- More than 50 IDs submitted causes a validation error
- Deleted or suspended tweet IDs return empty or null entries
- Malformed comma-separated string causes a parse error
- Payment failure (402) if USDC balance is insufficient

## How this service works

Bulk look up multiple Twitter/X tweets by their numeric tweet IDs in a single request. Each tweet includes full text, author profile, and engagement metrics. Query param: ids (string, required) - comma-separated numeric tweet IDs, max 50, e.g. GET /tweets?ids=1110302988,1234567890. Returns X v2 API-compatible JSON.

## Output

Returns an X v2 API-compatible JSON object containing an array of tweet objects, each with full tweet text, author profile information (username, display name, profile data), and engagement metrics (likes, retweets, replies, quotes) for each requested tweet ID.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "ids": "1110302988,1234567890,9876543210"
  }
 },
 "output": {
  "type": "object"
 }
}
```

## 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": [
      "ids"
     ],
     "properties": {
      "ids": {
       "type": "string",
       "description": "Comma-separated numeric tweet IDs, max 50"
      }
     }
    }
   },
   "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
    }
   }
  ]
 }
}
```

## More

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