# x402.twit.sh Tweet Replies

> x402.twit.sh Tweet Replies 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-14).

Fetches paginated reply tweets for a given Twitter/X tweet ID using the X v2 API

## Facts

- Endpoint: GET https://x402.twit.sh/tweets/replies?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-twit-sh-9906242a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NcS-f72VSmeNm2zP3YsqR

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-9906242a
```

Example prompt: Can you pull all the replies to tweet ID 1110302988 for me? Grab the first page and if there are more, use the pagination token to get the next batch too.

## When to prefer this

Use this endpoint when you need to retrieve replies (comments) to a specific tweet and have the numeric tweet ID. Prefer this over quote-tweet or retweet endpoints when you specifically want direct textual replies. Best suited for agents doing conversation analysis, sentiment monitoring of tweet threads, or aggregating community feedback on a post.

## Known failure modes

- Invalid or non-numeric tweet ID returns an error response
- Tweet ID not found or deleted returns empty data or 404-equivalent
- Missing required 'id' query parameter returns validation error
- Invalid next_token cursor returns pagination error or resets to first page
- Rate limiting or payment failure results in 402 or 429 response

## How this service works

Get replies to a specific Twitter/X tweet. Returns paginated reply tweets for a given tweet ID. Query params: id (string, required) - numeric tweet ID; next_token (string, optional) - pagination cursor, e.g. GET /tweets/replies?id=1110302988. Returns X v2 API-compatible JSON.

## Output

Returns an X v2 API-compatible JSON object containing a list of reply tweets for the specified tweet ID, each with tweet text and author data, plus a next_token cursor for fetching additional pages if more replies exist.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "id": "1445880548472328192"
  }
 }
}
```

## 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/x402-twit-sh-9906242a/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)
