{"uid":"cap_7IT8Gv70gtQHMkYW15PdB","slug":"readx-x-twitter-spaces-details-api-2ad6ac79","name":"ReadX — X/Twitter Spaces Details API","description":"ReadX is a read-only X/Twitter JSON API. Profiles, timelines, tweets, search, lists, followers & following — pay per call with x402 micropayments in USDC on Base or Solana. No API keys.","url":"https://readx.sh/api/spaces/%7Bid%7D","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"required":{"type":"string"},"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"code":0,"data":{"state":"Ended","title":"The @BorderlandsFilm cast is live with @Fandango at SDCC!","is_live":false,"ended_at":"2024-07-27T00:09:14.898Z","space_id":"1vOxwrneqBqJB","host_name":"Movies","started_at":"2024-07-26T23:31:16.881Z","stream_type":"replay","downloadable":true,"host_username":"Movies","is_replay_available":true,"total_live_listeners":465,"total_replay_watched":59649}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5oSg3Oi-gePA77CLaQrzy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches metadata and status details for a specific X/Twitter Space by its ID, including title, host, listener counts, state, and replay availability.","exampleAgentPrompt":"Can you pull up the details for X Space 1vOxwrneqBqJB — I want to know who hosted it, whether the replay is available, and how many people tuned in live?","exampleUseCases":[{"title":"Monitoring Space replay availability","prompt":"Check if the Twitter Space with ID 1vOxwrneqBqJB has a replay available yet, and tell me how many people watched it live."},{"title":"Researching brand live audio events","prompt":"I want to know when the Movies account's SDCC Space started and ended, who hosted it, and what the total listener count was — can you look up Space 1vOxwrneqBqJB?"},{"title":"Aggregating Space analytics for a creator","prompt":"Pull the stats for Twitter Space 1vOxwrneqBqJB — I need the title, start time, end time, number of live listeners, and total replay views for my report."}],"resultDescription":"Returns a JSON object with code 0 on success and a data object containing: space state (e.g. Ended, Live), title, is_live boolean, ended_at and started_at ISO timestamps, space_id, host_name, host_username, stream_type (e.g. replay), downloadable boolean, is_replay_available boolean, total_live_listeners count, and total_replay_watched count.","failureModes":["Invalid or non-existent Space ID returns an error code or empty data","Payment not provided or insufficient USDC results in HTTP 402 response requiring x402 micropayment","Space data may be unavailable if the Space was deleted or restricted","Rate limits may apply if many calls are made in rapid succession"],"whenToPreferThis":"Use this endpoint when you need structured metadata about a specific X/Twitter Space — including host info, listener counts, replay status, and timestamps — without needing an official Twitter API key. It is ideal for agents that need to monitor, analyze, or report on X Spaces programmatically using pay-per-call micropayments instead of OAuth credentials.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:48:44.053Z","isFirstParty":false}