Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.x.com/llms.txt

Use this file to discover all available pages before exploring further.

The Spaces lookup endpoints let you retrieve information about live or scheduled Spaces. Look up Spaces by their ID or find Spaces created by specific users.

​
Overview

By ID

Get details for a specific Space

Multiple Spaces

Look up multiple Spaces at once

By creator

Find Spaces by their hosts

Buyers

Get users who purchased tickets

​
Endpoints

MethodEndpointDescription
GET/2/spaces/:idGet Space by ID
GET/2/spacesGet Spaces by IDs
GET/2/spaces/by/creator_idsGet Spaces by creator user IDs
GET/2/spaces/:id/buyersGet ticket buyers for a Space
GET/2/spaces/:id/tweetsGet Posts shared in a Space

​
Response fields

By default, the response includes id and state. Request additional fields:
FieldDescription
titleSpace title
host_idsHost user IDs
speaker_idsSpeaker user IDs
participant_countNumber of participants
scheduled_startScheduled start time
started_atActual start time
ended_atEnd time
is_ticketedWhether Space has tickets

​
Space states

StateDescription
liveCurrently active
scheduledScheduled for future
endedHas ended

​
Example request

curl "https://api.x.com/2/spaces/1DXxyRYNejbKM?\
space.fields=title,host_ids,participant_count,scheduled_start,state" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​
Getting started

Prerequisites

Quickstart

Make your first Spaces lookup request

Search Spaces

Find Spaces by keyword

API Reference

Full endpoint documentation

Sample code

Working code examples