Retrieve quote tweets for any post via x402 pay-per-request Twitter/X API
What it does
The /tweets/quote_tweets endpoint on twit.sh returns a paginated list of tweets that quote a specific tweet, identified by its numeric tweet ID. Each result includes the quoting tweet's content and author information, formatted as X v2 API-compatible JSON. The endpoint is part of the broader twit.sh API, which provides payment-gated access to Twitter/X data — user profiles, timelines, search, lists, communities, articles, and authenticated actions — without requiring API keys or account signup.
Payment is handled via the x402 protocol: an unauthenticated GET request returns HTTP 402 with a machine-readable payment challenge. The caller settles $0.01 USDC on Base mainnet, then retries with a payment proof header to receive data. No gas is required on the caller's side. Pagination is supported via a next_token cursor parameter.
The API is designed for autonomous AI agents. A CLI skill (npx twitsh) is available that handles payment and credential injection automatically, compatible with Claude Code, Cursor, OpenClaw, and other agent frameworks. Data is sourced from publicly available information on the open web.
Capabilities
Use cases
- —Monitoring how a specific tweet is being quoted and discussed across Twitter/X
- —Analyzing sentiment and reach of quote tweets for brand monitoring
- —Building agent workflows that track viral spread of specific posts
- —Aggregating community reactions to announcements or product launches
- —Research on information propagation patterns via quote tweets
Fit
Best for
- —AI agents that need programmatic Twitter/X data without OAuth setup
- —Developers who want pay-per-call pricing instead of monthly API subscriptions
- —Autonomous workflows that need quote tweet data with no human in the loop
Not for
- —High-volume bulk scraping (pay-per-request model adds up)
- —Use cases requiring Twitter write actions (this is a read-only endpoint)
- —Users without USDC on Base mainnet for payment
Quick start
# 1. First request returns 402 with payment challenge
curl 'https://x402.twit.sh/tweets/quote_tweets?id=1110302988'
# 2. After settling USDC payment, retry with proof header
curl -H 'X-PAYMENT: <payment_proof>' \
'https://x402.twit.sh/tweets/quote_tweets?id=1110302988'Endpoint
Quality
Full OpenAPI schema with clear parameter definitions and pricing. The endpoint is live (402 challenge captured). However, no response schema or example response body is documented, and the /docs path returns 404, so the exact shape of returned data must be inferred from the 'X v2 API-compatible' claim.
Warnings
- —No response schema documented — the exact JSON structure of returned quote tweets is not specified beyond 'X v2 API-compatible'
- —No example response body available from probe or docs
- —The /docs, /api, /pricing, and /README paths all return 404 — documentation lives only on the landing page
Citations
- —Endpoint returns quote tweets for a specific tweet by numeric ID, priced at $0.01 USDC per requesthttps://x402.twit.sh
- —Payment is in USDC on Base mainnet via x402 protocol, no API key or account requiredhttps://x402.twit.sh
- —Data is sourced from the open web and returned in X v2 API-compatible JSON formathttps://x402.twit.sh
- —CLI skill available via npx twitsh, compatible with Claude Code, Cursor, OpenClaw, and other agentshttps://x402.twit.sh