Reddit Scraper API just launched: posts, comments, subreddits, users & full search→
Twitter Scraper APIsLive Events API
Twitter Live Events API

Twitter (X) Live Events Details Scraper API for Space and Broadcast Metadata

Retrieve detailed metadata for Twitter Spaces and live video broadcasts, including event states, scheduling information, creators, participants, listeners, viewers, and video dimensions as structured JSON.

2 Live Events endpoints
1 base credit + 1 credit per item returned
Failed requests cost 0 credits
1,000 free credits
No credit card required
Get Started FreeView Docs
GET /v1/twitter/spaces/{space_id}
TWITTER
{
  "data": {
    "id": "1eaKbrPAqbwKX",
    "title": "The Future of AI",
    "state": "live",
    "host": { "username": "host_user", "followers_count": 50000 },
    "participant_count": 1250,
    "is_ticketed": false,
    "scheduled_start": "2025-01-20T18:00:00Z"
  }
}
Endpoints

2 Live Events Endpoints

All endpoints return structured JSON and authenticate with your API key in the x-api-key header.

GETGet Space Detail

Get complete data for any Twitter Space: title, host info, speakers, listener count, schedule, and recording status.

/v1/twitter/spaces/{space_id}
GETGet Broadcast

Access details of any Twitter broadcast or live video: title, viewer count, broadcaster profile, and stream state.

/v1/twitter/spaces/broadcast/{broadcast_id}
Cost Calculator

Estimate your live events scraping cost

Failed requests never consume credits, and the exact charge is returned in the X-Credits-Used response header.

Total credits for 1,000 live events requests21,000
Loading plans…
Pricing

Simple, transparent pricing

Start with pay-as-you-go credits (never expire) or save up to 64% with a monthly or annual subscription. No hidden fees, no lock-in.

See full pricing details
FAQ

Frequently asked questions

Everything you need to know about the Twitter Live Events API.

What is a Twitter Live Events Details Scraper API?

A Twitter Live Events Details Scraper API turns Twitter Space and live-video broadcast metadata into structured data an application can use. ScrapeBadger provides one endpoint for audio-room details and another for live-video broadcast details.

What is the difference between a Twitter Space and a broadcast?

A Twitter Space is an audio room that can be scheduled, live, or ended. Its response focuses on the creator, participants, listeners, ticketing, and scheduling. A broadcast is a live video event whose response includes its media key, video dimensions, state, timestamps, and viewer count.

Which live-event states can I track?

Space responses include a state field with values such as live, scheduled, and ended. Broadcast responses include a state field with values such as running and ended. The field always reflects the current status available for the requested event.

What audience metrics are available?

Space responses can include the current participant count, total number of users who participated across the event's lifetime, and live-listener count. Broadcast responses can include the total viewer count.

Does the API return audio, video files, recordings, or transcripts?

Both endpoints return event metadata rather than downloadable media or transcripts. Broadcast details include a media_key, but the response does not document a downloadable video URL. Space details do not include an audio recording or transcript field.

How do I retrieve a live event?

Pass a known broadcast_id to Get Broadcast Details or a known space_id to Get Space Details. These endpoints perform direct lookups and do not support event search, listing, cursor pagination, or bulk retrieval.

How much does the Twitter Live Events API cost?

Each endpoint returns one object, so every successful broadcast or Space lookup costs 2 credits: 1 base credit plus 1 credit for the returned item. Failed 4xx and 5xx requests use 0 credits, and the exact charge is returned in the X-Credits-Used response header.

Does the Twitter Live Events API have rate limits?

Yes. Request-per-minute limits depend on the selected ScrapeBadger plan. See the pricing table for the current limits per plan tier.

More Twitter Data APIs

Tweets APIAdvanced Tweet Search APILists APICommunities APITrends APIGeo APIUsers APITwitter StreamsAll Twitter APIs

Start building with the Live Events API

Sign up free and get 1,000 API credits. No credit card required.

Start Free TrialView All Twitter APIs

Disclaimer: ScrapeBadger is not affiliated with, endorsed by, or in any way officially connected with X Corp. (formerly Twitter, Inc.) or any of its subsidiaries or affiliates. The names Twitter, X, and related trademarks are the property of their respective owners.