# PayWeave Twitter – Get Tweet Retweeters

> PayWeave Twitter – Get Tweet Retweeters is a paid API for AI agents from twitter.payweave.services, paid per call via x402, $0.02655/call, status unknown (last checked 2026-09-14).

Returns a paginated list of user profiles who retweeted a specific tweet, identified by its numeric tweet ID.

## Facts

- Endpoint: GET https://twitter.payweave.services/tweets/retweeters
- Price: $0.02655/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/payweave-twitter-get-tweet-retweeters-8a4618a8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_436GDRwjgmdsOGmvNShP1

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 payweave-twitter-get-tweet-retweeters-8a4618a8
```

Example prompt: Who retweeted tweet ID 1693573582226665701? Give me the full list of user profiles, and if there are more pages, use the next_cursor to get them all.

## When to prefer this

Choose this endpoint when you need a paginated, per-tweet list of retweeting user profiles and you want pay-per-call pricing via USDC (x402 protocol) without managing Twitter API credentials or OAuth. Prefer it over direct Twitter API access when you want frictionless crypto micropayment billing and don't want to maintain API keys.

## Known failure modes

- Invalid or non-numeric tweet ID returns a validation error
- Tweet ID for a deleted or private tweet may return empty results or an error
- Expired or invalid next_token causes pagination failure
- Rate limits on the underlying twitterapi.io provider may return 429-equivalent errors
- Payment failure via x402 protocol results in 402 response and no data returned

## How this service works

X/Twitter data — tweets, users, communities, lists, articles, and trends.

## Output

Returns a JSON object containing an array of user-profile objects representing accounts that retweeted the specified tweet, a next_cursor string for pagination, and a has_next_page boolean indicating whether additional pages exist. User objects include standard Twitter profile fields forwarded verbatim from twitterapi.io.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "anyOf": [
      {
       "not": {}
      },
      {
       "type": "object",
       "required": [
        "id"
       ],
       "properties": {
        "id": {
         "type": "string",
         "pattern": "^\\d+$",
         "description": "Numeric ID, e.g. 1693573582226665701"
        },
        "next_token": {
         "type": "string",
         "description": "Pagination cursor from a previous response `next_cursor`. Omit for the first page."
        }
       },
       "additionalProperties": false
      }
     ]
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "const": "GET"
    },
    "bodyType": {
     "type": "string",
     "const": "json"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "example"
   ],
   "properties": {
    "example": {
     "type": "object",
     "properties": {
      "users": {
       "type": "array",
       "items": {
        "type": "object",
        "additionalProperties": {}
       },
       "description": "Array of user-profile objects."
      },
      "members": {
       "type": "array",
       "items": {
        "type": "object",
        "additionalProperties": {}
       },
       "description": "Array of user-profile objects."
      },
      "followers": {
       "type": "array",
       "items": {
        "type": "object",
        "additionalProperties": {}
       },
       "description": "Array of user-profile objects."
      },
      "followings": {
       "type": "array",
       "items": {
        "type": "object",
        "additionalProperties": {}
       },
       "description": "Array of user-profile objects."
      },
      "next_cursor": {
       "type": "string",
       "description": "Cursor to pass as `next_token` for the next page."
      },
      "has_next_page": {
       "type": "boolean",
       "description": "True when more pages are available."
      }
     },
     "description": "User list JSON forwarded verbatim from twitterapi.io.",
     "additionalProperties": true
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/payweave-twitter-get-tweet-retweeters-8a4618a8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twitter.payweave.services](https://www.zero.xyz/host/twitter.payweave.services/llms.txt)
