# twit.sh Retweeted By

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

Returns a paginated list of Twitter/X users who have retweeted a specific tweet, identified by numeric tweet ID.

## Facts

- Endpoint: GET https://twit.sh/tweets/retweeted_by
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/twit-sh-retweeted-by-80f07726
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_14-2Ywc2uTrbGJHiL42Xt

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-retweeted-by-80f07726
```

Example prompt: Who retweeted tweet ID 1234567890? Give me the full list of users with their follower counts.

## When to prefer this

Use this endpoint when you need to identify the specific users who retweeted a given tweet — for audience analysis, influencer discovery, campaign monitoring, or community mapping. It is preferable to scraping or manual lookup because it returns structured user profile data including follower metrics, requires no API key registration, and is payable autonomously per-request via USDC on Base. Choose this over search-based endpoints when you have a known tweet ID and want the retweet audience rather than the tweet content itself.

## Known failure modes

- Invalid or non-numeric tweet ID returns an error response
- Tweet ID not found or deleted returns empty data array
- Payment failure (insufficient USDC balance) returns HTTP 402 and no data
- Rate limiting or upstream Twitter/X API errors may cause transient failures
- next_token from a different endpoint or expired token causes pagination errors

## 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

A JSON array of user objects for each account that retweeted the specified tweet. Each object includes the user's numeric ID, username, display name, verified status, bio description, and public metrics (followers count, following count, tweet count, like count). A meta object with a next_token is included when more pages of results 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": "9253672",
    "name": "Hal Finney",
    "username": "halfin",
    "verified": false,
    "description": "Running bitcoin.",
    "public_metrics": {
     "like_count": 300,
     "tweet_count": 600,
     "followers_count": 134000,
     "following_count": 200
    }
   }
  ],
  "meta": {
   "next_token": "abc123"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/twit-sh-retweeted-by-80f07726/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)