Headers
Get your API keyAPI key (`sfk_...`)
Space permalink or id.
min 1 chars · max 4096 chars
Endpoint-specific response payload.
Whether the Space was found.
one of: found, not_found
Space details when available.
Space identifier.
min 1 chars
Space title. May be empty when X has none.
Current Space lifecycle: running, ended, scheduled, canceled, or unknown when upstream uses an unrecognized value.
one of: running, ended, scheduled, canceled, unknown
Canonical public Space URL (`https://x.com/i/spaces/{id}`).
min 1 chars
Media key for the Space stream when available.
When the Space was created (ISO-8601).
Scheduled start time (ISO-8601) when the Space is scheduled.
When the Space actually started (ISO-8601).
When the Space ended (ISO-8601).
Last update time (ISO-8601).
Host / creator compact user card when available.
Numeric X user id as a string.
X screen name (handle) without the leading @.
Display name shown on the profile.
Profile biography text.
Best available square avatar image URL.
Profile banner image URL when available.
Location string from the profile when provided.
Primary outbound link (expanded URL) from the profile.
Whether X marks the profile with legacy verification (not necessarily paid blue).
Whether the account has X blue (paid) verification.
Whether the account is protected (private).
Follower count from X when available.
≥ 0
Following (friends) count from X when available.
≥ 0
Total post (status) count from X when available.
≥ 0
Listed count when X provides it.
≥ 0
Account creation time (ISO-8601) when derivable.
Canonical public profile URL on x.com (`https://x.com/<handle>`).
Avatar crop shape reported by X, such as Circle or Square.
X verification type label when provided (for example a government or organization note).
Pinned tweet ids from X, in display order.
X professional-account metadata when the account is marked professional.
Professional account type from X, when present.
Professional category entries from X.
Professional account rest id from X, when present.
Country codes where the profile is withheld.
Total likes (favorites) on the profile when available.
≥ 0
Media item count when X provides it.
≥ 0
Peak or current live listener count when available.
≥ 0
Replay watch count when available.
≥ 0
Admins, speakers, listeners, and reported total.
Admins currently or previously in the Space.
Numeric X user id as a string.
X screen name without the leading @.
min 1 chars
Display name shown in the Space.
Avatar image URL when available.
Whether X marks this participant with legacy verification. Omitted when unknown.
Whether this participant has X blue (paid) verification. Omitted when unknown.
Periscope user id for this participant when X provides one.
Whether an admin muted this participant.
Whether a guest muted this participant.
When this participant started speaking (ISO-8601).
Speakers currently or previously in the Space.
Numeric X user id as a string.
X screen name without the leading @.
min 1 chars
Display name shown in the Space.
Avatar image URL when available.
Whether X marks this participant with legacy verification. Omitted when unknown.
Whether this participant has X blue (paid) verification. Omitted when unknown.
Periscope user id for this participant when X provides one.
Whether an admin muted this participant.
Whether a guest muted this participant.
When this participant started speaking (ISO-8601).
Listeners currently or previously in the Space.
Numeric X user id as a string.
X screen name without the leading @.
min 1 chars
Display name shown in the Space.
Avatar image URL when available.
Whether X marks this participant with legacy verification. Omitted when unknown.
Whether this participant has X blue (paid) verification. Omitted when unknown.
Periscope user id for this participant when X provides one.
Whether an admin muted this participant.
Whether a guest muted this participant.
When this participant started speaking (ISO-8601).
Reported participant total when X provides one.
≥ 0
Whether a replay of this Space is available. Omitted when unknown.
Topics associated with this Space.
Topic identifier when X provides one.
Topic display name.
min 1 chars
Tweet id that announced or is attached to this Space.
Whether clipping is available for this Space.
Space content type when X reports one, such as audio.
Narrow-cast Space type code when X reports one.
Conversation-control code when X reports one.
Whether joining this Space is disallowed.
Whether this Space is locked.
Whether this Space is muted.
Whether this Space is restricted to employees.
Whether incognito listening is disallowed.
Maximum guest sessions when X reports one.
≥ 0
Maximum admin capacity when X reports one.
≥ 0
User ids mentioned in this Space when X provides them.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.
Code example
curl "https://api.socialfetch.dev/v1/twitter/spaces?url=https://x.com/i/spaces/1YGNrbYyLROGw" \
-H "x-api-key: YOUR_API_KEY"Responses
Space details.