Twitter API v2

Space lookup up Space IDs

GET/2/spaces

Returns a variety of information about the Spaces specified by the requested IDs

Request

Query Params

ids

array[string]

required

A list of space ids

space.fields

array[string]

optional

A comma separated list of Space fields to display.

expansions

array[string]

optional

A comma separated list of fields to expand.

Request samples

Responses

The request was successful(200)

500(500)

The request was successful

HTTP Code: 200

Content Type : JSONapplication/json

data

array[object (Space) {14}]

optional

>= 0 items

created_at

string <date-time>

optional

Creation time of the space

Example:

2021-07-06T18:40:40.000Z

creator_id

string

optional

Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

Example:

2244994945

Match pattern:

^[0-9]{1,19}$

host_ids

array[string]

optional

The user ids for the hosts of the space

string

required

The unique identifier of this Space.

Example:

1SLjjRYNejbKM

Match pattern:

^[a-zA-Z0-9]{1,13}$

invited_user_ids

array[string]

optional

An array of user ids for people who were invited to a space

is_ticketed

boolean

optional

Denotes if the space is a ticketed space

Example:

false

lang

string

optional

The language of the space

Example:

participant_count

integer <int32>

optional

The number of participants in a space

Example:

scheduled_start

string <date-time>

optional

A date time stamp for when a space is scheduled to begin

Example:

2021-07-06T18:40:40.000Z

speaker_ids

array[string]

optional

An array of user ids for people who were speakers in a space

started_at

string <date-time>

optional

When the space was started as a date string

Example:

2021-7-14T04:35:55Z

state

enum<string>

required

The current state of the space.

Allowed values:

livescheduledended

Example:

live

title

string

optional

The title of the space

Example:

Spaces are Awesome

updated_at

string <date-time>

optional

When the space was last updated

Example:

2021-7-14T04:35:55Z

errors

array[null (Problem) {17}]

optional

>= 1 items

object

GenericProblem

optional

A generic problem with no additional information beyond that provided by the HTTP status code.

object

InvalidRequestProblem

optional

A problem that indicates this request is invalid.

object

ClientForbiddenProblem

optional

A problem that indicates your client is forbidden from making this request.

object

ResourceNotFoundProblem

optional

A problem that indicates that a given Tweet, User, etc. does not exist.

object

ResourceUnavailableProblem

optional

A problem that indicates a particular Tweet, User, etc. is not available to you.

object

ResourceUnauthorizedProblem

optional

A problem that indicates you are not allowed to see a particular Tweet, User, etc.

object

FieldUnauthorizedProblem

optional

A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.

object

DisallowedResourceProblem

optional

A problem that indicates that the resource requested violates the precepts of this API.

object

UnsupportedAuthenticationProblem

optional

A problem that indicates that the authentication used is not supported.

object

UsageCapExceededProblem

optional

A problem that indicates that a usage cap has been exceeded.

object

ConnectionExceptionProblem

optional

A problem that indicates something is wrong with the connection

object

ClientDisconnectedProblem

optional

Your client has gone away.

object

OperationalDisconnectProblem

optional

You have been disconnected for operational reasons.

object

RulesCapProblem

optional

You have exceeded the maximum number of rules.

object

InvalidRuleProblem

optional

The rule you have submitted is invalid.

object

DuplicateRuleProblem

optional

The rule you have submitted is a duplicate.

object

ConflictProblem

optional

You cannot create a new job if one is already in progress.

includes

object (Expansions)

optional

media

array[null (Media) {3}]

optional

>= 1 items

places

array[object (Place) {8}]

optional

>= 1 items

polls

array[object (Poll) {5}]

optional

>= 1 items

tweets

array[object (Tweet) {20}]

optional

>= 1 items

users

array[object (User) {14}]

optional

>= 1 items

Not configured

Last modified: 2 years ago