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

Explore All 2 Live Events Endpoints

Pick an endpoint to see what it does, which parameters it accepts, and the JSON your application receives. Authenticate with your API key in the x-api-key header.

GET/v1/twitter/spaces/{space_id}

Get Space Detail

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

Parameters
space_idrequiredThe Twitter Space ID
Sample response
{
  "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"
  }
}
View Get Space Detail documentation

What Can You Build With the Twitter Live Events Details Scraper API

Live event status dashboards

Track known Twitter Spaces and broadcasts in one dashboard. Display whether an audio room is scheduled, live, or ended and whether a video broadcast is running or has finished — all from a single API key.

Space host and audience intelligence

Connect a Space to its creator's user ID, username, and display name. Track current participants, total participation, live listeners, ticketing status, and event timing to understand host activity and audience response.

Broadcast performance and technical monitoring

Monitor live video broadcasts using their current state, total viewer count, media key, start time, and video dimensions. Use the metadata to support operational dashboards, broadcast inventories, or performance reporting.

Event scheduling and historical records

Store scheduled start times, actual start times, end times, audience totals, and final states for known Twitter Spaces. Build internal event calendars or historical datasets for recurring audio programming.

More Twitter Data APIs

Why Choose ScrapeBadger?

Build Faster

Sub-100ms response times. Most of that is your network latency, not our infrastructure. Deploy, test, iterate the same day instead of week-long proofs-of-concept.

Scale Confidently

99.9% uptime SLA. Your data pipeline doesn't stop because X changed a selector. Monitoring, patching, and infrastructure are all us. You focus on what you built.

All X Data on One Platform

Tweets, profiles, followers, communities, trends, geo, real-time Streams — 40+ endpoints. Whatever you need from X, it's here. No fragmented tooling, no API gaps forcing you to bolt on a second service.

Integrate Anywhere

RESTful API, SDK support (Python, Node, Go, PHP), MCP, CLI, and no code. Use it in an existing system or a new greenfield; the response shape never surprises you.

Integrate With Your Stack

Use ScrapeBadger through an official SDK, a standard API request, a real-time connection, or the tools already in your workflow.

Python SDK

Build asynchronous data pipelines with typed responses, automatic pagination, retry handling, and access to the complete Twitter API.

Node.js SDK

Add Twitter data to Node.js and TypeScript applications with type definitions, async pagination, and support for both ESM and CommonJS.

REST API

Connect from any backend or programming language using standard HTTP requests. Responses arrive as structured JSON that can be stored, transformed, or passed into another service.

WebSockets and Webhooks

Receive new tweets through a persistent WebSocket connection or deliver them directly to your application through signed webhooks. Available with Twitter Streams for account and query monitoring.

MCP for AI Tools

Give compatible AI agents access to Twitter profiles, tweets, search, trends, communities, lists, and monitoring tools through ScrapeBadger's MCP server.

ScrapeBadger CLI

Search tweets, retrieve profiles, inspect trends, and export results as JSON, CSV, Markdown, or terminal-friendly tables without writing an application.

Trusted by Developers Worldwide

See what our customers say about ScrapeBadger Twitter API.

We switched from the official Twitter API and cut our costs by 95%. The pagination is seamless, and we've never hit a rate limit. Best decision we made this year.

MC
Marcus Chen
Lead Data Engineer at DataFlow Analytics
2 weeks ago

The follower and engagement endpoints are incredibly detailed. We use it for influencer research and competitor analysis. Response times are sub-100ms consistently.

SM
Sarah Mitchell
Marketing Director at SocialPulse Agency
1 month ago

Started with the Apify actor, then moved to the API for more control. The 1,000 free credits were enough to build our MVP. Now processing 2M+ tweets monthly.

JR
James Rodriguez
Founder at TweetMetrics
3 weeks ago

Perfect for academic research. The community and trends endpoints give us data we couldn't get anywhere else. Documentation could use more examples, but support is responsive.

EW
Emily Watson
Research Scientist at Stanford NLP Lab
1 month ago

We monitor 50,000+ accounts for our clients. ScrapeBadger handles it without breaking a sweat. The bulk ID endpoints are a game-changer for large-scale monitoring.

AP
Alex Petrov
CTO at MediaMonitor Pro
2 weeks ago

The geo and trends endpoints power our location-based analytics. Setup took 10 minutes. Their Apify actors are also great for quick one-off scrapes.

LP
Lisa Park
Product Manager at Trendy AI
3 weeks ago
Pricing

Simple, transparent pricing

Start with pay-as-you-go credits (never expire) or save up to 64% with a monthly or annual subscription. Failed requests never consume credits, and the exact charge is returned in the X-Credits-Used response header.

Not Sure Which Plan Fits Your Needs? Calculate Your Cost and Find the Right Plan.

Every endpoint uses the same model: 1 base credit + 1 credit per item returned. Single-item lookups always cost 2 credits. Paginated list endpoints cost 1 + the number of items in the page. Failed requests cost 0 credits.

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.

Start building with the Live Events API

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

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.