# X (Twitter) Spaces API

X

Returns an X (formerly Twitter) Space from its link or ID: whether it is live, scheduled or over, its title, host, start and end, how many listen now and how many tuned in. It also has the co-hosts, speakers, the listeners X names, topics, replay plays, the post it was shared in, and on request the live or recorded audio's HLS playlist. [Overview and pricing](https://socialtap.dev/apis/x/space/index.md)

GET `/v1/x/space`

## Example

cURL:

```shell
curl -G 'https://socialtap.dev/v1/x/space' \
  --data-urlencode 'streams=true' \
  --data-urlencode 'url=https://x.com/i/spaces/1MnxnMDeQLeJO' \
  -H "x-api-key: $SOCIALTAP_API_KEY"
```

TypeScript SDK:

```typescript
import { SocialTap } from "socialtap";

const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY

const res = await client.x.space.get({ url: "https://x.com/i/spaces/1MnxnMDeQLeJO", streams: true });
console.log(res.data);
console.log(res.credits.charged, res.meta.request_id);
```

Node.js (fetch):

```javascript
const params = new URLSearchParams({
  streams: "true",
  url: "https://x.com/i/spaces/1MnxnMDeQLeJO",
});
const res = await fetch(`https://socialtap.dev/v1/x/space?${params}`, {
  headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" },
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
const { data, meta } = body;
console.log(data, meta.credits_charged);
```

Python (requests):

```python
import os

import requests

res = requests.get(
    "https://socialtap.dev/v1/x/space",
    params={"streams": "true", "url": "https://x.com/i/spaces/1MnxnMDeQLeJO"},
    headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]},
)
body = res.json()
if not res.ok:
    raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
data, meta = body["data"], body["meta"]
print(data, meta["credits_charged"])
```

Go (net/http):

```go
package main

import (
	"encoding/json"
	"fmt"
	"log"
	"net/http"
	"net/url"
	"os"
)

func main() {
	q := url.Values{}
	q.Set("streams", "true")
	q.Set("url", "https://x.com/i/spaces/1MnxnMDeQLeJO")
	req, err := http.NewRequest("GET", "https://socialtap.dev/v1/x/space?"+q.Encode(), nil)
	if err != nil {
		log.Fatal(err)
	}
	req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY"))
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		log.Fatal(err)
	}
	defer res.Body.Close()
	var body struct {
		Data  json.RawMessage `json:"data"`
		Meta  map[string]any  `json:"meta"`
		Error *struct {
			Code    string `json:"code"`
			Message string `json:"message"`
		} `json:"error"`
	}
	if err := json.NewDecoder(res.Body).Decode(&body); err != nil {
		log.Fatal(err)
	}
	if body.Error != nil {
		log.Fatalf("%s: %s", body.Error.Code, body.Error.Message)
	}
	fmt.Println(string(body.Data), body.Meta["credits_charged"])
}
```

200 OK:

```json
{
  "data": {
    "approximate_fields": [],
    "category": "Twitter Spaces",
    "ended_at": "2024-06-29T03:21:43Z",
    "host": {
      "avatar_url": "https://pbs.twimg.com/profile_images/2073898788222017536/62S5ZHzN.jpg",
      "display_name": "Diligent Denizen 🇺🇸",
      "id": "1585809424135995392",
      "is_verified": true,
      "url": "https://x.com/DiligentDenizen",
      "username": "DiligentDenizen"
    },
    "id": "1MnxnMDeQLeJO",
    "metrics": {
      "concurrent_viewer_count": null,
      "like_count": null,
      "view_count": 5253
    },
    "platform": "x",
    "platform_specific": {
      "x": {
        "cohosts": [
          {
            "avatar_url": "https://pbs.twimg.com/profile_images/1999972200779005953/JP18SAS8.jpg",
            "display_name": "R A W S A L E R T S",
            "id": "1176026136117166080",
            "is_verified": true,
            "url": "https://x.com/rawsalerts",
            "username": "rawsalerts"
          },
          {
            "avatar_url": "https://pbs.twimg.com/profile_images/2008597896032309249/sTx9-Sf9.jpg",
            "display_name": "Penny2x",
            "id": "1522405142888255488",
            "is_verified": true,
            "url": "https://x.com/imPenny2x",
            "username": "imPenny2x"
          }
        ],
        "content_type": "visual_audio",
        "created_at": "2024-06-24T16:20:08Z",
        "host_follower_count": 217622,
        "is_clipping_available": false,
        "is_employee_only": false,
        "is_replay_available": true,
        "listeners": [],
        "media_key": "28_1805274721325563904",
        "mentioned_account_ids": [
          "19737700",
          "732548050728701953",
          "926868226654404608"
        ],
        "metrics": {
          "replay_view_count": 45098
        },
        "replay_url": "https://prod-fastly-a.video.pscp.tv/Transcoding/v1/hls/f2IR1xcGgGuT5AfB4tqgZj5amktfmjYfY8rnZQpaoqBebP0BBC8IA2Vgf-rSeebBj7sVa7ltpXEWlTgHQtXjSQ/non_transcode/us-east-1/periscope-replay-direct-prod-us-east-1-public/audio-space/playlist_16727112769395525869.m3u8?type=replay",
        "speakers": [
          {
            "avatar_url": "https://pbs.twimg.com/profile_images/1986153204057309184/Vkq3fC52.jpg",
            "display_name": "WOLF",
            "id": "1306359926164516864",
            "is_verified": true,
            "url": "https://x.com/WOLF_Financial",
            "username": "WOLF_Financial"
          },
          {
            "avatar_url": "https://pbs.twimg.com/profile_images/2076747174545653760/5ZzO9ccZ.jpg",
            "display_name": "Mandy",
            "id": "1517929379879436288",
            "is_verified": true,
            "url": "https://x.com/MarindaVannoy1",
            "username": "MarindaVannoy1"
          },
          {
            "avatar_url": "https://pbs.twimg.com/profile_images/2103637188210475008/8K7R9COt.jpg",
            "display_name": "The Honey Badger",
            "id": "926868226654404608",
            "is_verified": true,
            "url": "https://x.com/Nance726",
            "username": "Nance726"
          }
        ],
        "topics": [
          "Twitter Spaces",
          "Social media",
          "World news"
        ],
        "updated_at": "2024-06-29T03:23:30Z"
      }
    },
    "post_id": "1806855425960161611",
    "scheduled_start_at": "2024-06-29T01:30:40Z",
    "started_at": "2024-06-29T01:01:16Z",
    "status": "ended",
    "streams": [],
    "text": null,
    "thumbnail_url": null,
    "title": "🚨@XSPACES Q & A FEEDBACK W/ 𝕏 LEAD MEDIA ENGINEER @marmars",
    "unknown_fields": [],
    "url": "https://x.com/i/spaces/1MnxnMDeQLeJO"
  },
  "meta": {
    "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f",
    "platform": "x",
    "source": "api",
    "is_cached": false,
    "credits_charged": 1,
    "latency_ms": 1000,
    "fetched_at": "2026-10-25T12:00:00Z",
    "input": {
      "kind": "live",
      "id": "1MnxnMDeQLeJO",
      "url": "https://x.com/i/spaces/1MnxnMDeQLeJO"
    },
    "credits_remaining": 9999,
    "client_request_id": null,
    "warnings": []
  }
}
```

Long arrays and strings are shortened for display; real responses are complete.

> [!NOTE]
>
> **Good to know**
>
> - streams and platform_specific.x.replay_url are filled only with streams=true. Without it, a live Space lists streams in unknown_fields.
> - metrics.concurrent_viewer_count counts the people listening now and is null unless the Space is live. metrics.view_count counts everyone who tuned in live, and platform_specific.x.metrics.replay_view_count the plays of its recording.
> - platform_specific.x.listeners holds the listeners X names, at most 50, while the Space is live, and is empty once it ends.
> - A Space that never existed and one its host deleted look the same on X, and both return not_found.
> - When X's Space API fails, the Space comes from X's newer query or its page, which lack the media key, playlist, listeners, topics and post: those are then null or listed in unknown_fields.

## Authorizations

`x-api-key`stringheaderrequired

Your API key. [Authentication](https://socialtap.dev/docs/authentication/index.md)

## Query parameters

| Name | Type | Description | Example |
| --- | --- | --- | --- |
| `url` required | `string`<br>max 2,048 chars | The Space: its link on x.com or twitter.com (x.com/i/spaces/\<id>, its /peek view, mobile hosts and any query too) or its ID. | `https://x.com/i/spaces/1MnxnMDeQLeJO` |
| `streams` optional | `boolean` | Also return the Space's HLS playlist: in streams while it is live, in platform_specific.x.replay_url once it is over and X keeps the recording. One more upstream request, at the same price. | — |

`url` takes X live broadcast links; another kind of link, or another platform's, fails free with [`invalid_input`](https://socialtap.dev/docs/errors/index.md#invalid_input). Unknown parameters are rejected with a suggestion, never ignored ([Requests](https://socialtap.dev/docs/requests/index.md)).

**Parameters every endpoint accepts**

| Name | Type | Description | Example |
| --- | --- | --- | --- |
| `max_age` optional | `integer`<br>min 0 | Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh. The Cache-Control: max-age=N request header is equivalent; max_age wins when both are sent. | — |
| `fields` optional | `string` | Return only these fields of each item: comma-separated paths in the schema's notation (id,text,metrics.view_count,segments\[\].text; a parent path keeps the whole object). Unknown paths are rejected. Applied after the cache, so it changes neither the price nor cache hits; page and meta are always returned whole. | — |

## Response

### 200

`{data, meta}`. `data` is a [live](https://socialtap.dev/resources/live/index.md) object; `meta` describes the request ([meta](https://socialtap.dev/docs/reference/index.md#meta)). Fields only X has are under `platform_specific.x`.

| Field | Type | Description |
| --- | --- | --- |
| `data.platform` | `string` | Platform ID (tiktok, youtube, …). |
| `data.id` | `string` | Platform-native ID of the broadcast (string; TikTok room ID, YouTube video ID). |
| `data.url` | `string` (uri) | Public page of the broadcast (TikTok: the host's LIVE page, tiktok.com/@\<username>/live). |
| `data.status` | `string` | live: on air now; scheduled: announced, not started; ended: over. New values may be added; treat an unknown value as not live.<br>One of `live`, `scheduled`, `ended` |
| `data.title` | `string` or `null` | The broadcast's title as the host set it. |
| `data.text` | `string` or `null` | Description as plain text; null where the platform has none. |
| `data.category` | `string` or `null` | The topic or game the broadcast is filed under, as the platform names it. |
| `data.host` | `object` | The broadcasting account. |
| `data.host.id` | `string` or `null` | Platform-native account ID; null when only the handle is known. |
| `data.host.username` | `string` or `null` | Handle without the @; null when the account has none. |
| `data.host.display_name` | `string` or `null` | Display name shown on the profile. |
| `data.host.url` | `string` (uri) or `null` | Canonical profile URL. |
| `data.host.avatar_url` | `string` (uri) or `null` | Profile picture URL. Platform CDN URLs can expire within hours. |
| `data.host.is_verified` | `boolean` or `null` | Platform verification badge; null where the platform has no badge. |
| `data.started_at` | `string` (date-time) or `null` | When the broadcast went on air, RFC 3339 UTC; null while scheduled or when not shown. |
| `data.ended_at` | `string` (date-time) or `null` | When it went off air, RFC 3339 UTC; null while live or scheduled, and when the platform does not say. |
| `data.scheduled_start_at` | `string` (date-time) or `null` | When a scheduled broadcast is due to start, RFC 3339 UTC; null when none was announced. |
| `data.thumbnail_url` | `string` (uri) or `null` | Cover or preview image URL. Platform CDN URLs can expire within hours. |
| `data.post_id` | `string` or `null` | ID of the post the platform keeps the broadcast as (equals post.id: a YouTube or Rumble video; on X, the post the Space was shared in); null when it keeps none (TikTok LIVE) or none yet. |
| `data.streams` | `object[]` | Playback links of the broadcast while live, one per rendition and format, best first; \[\] when not live or when the platform's links only work from SocialTap's network (YouTube). |
| `data.streams[].quality` | `string` or `null` | The platform's label for the rendition (Original, 1080p60, 720p, …). |
| `data.streams[].format` | `string` | Delivery format of url: hls (an .m3u8 playlist), dash (an .mpd manifest, TikTok's CMAF) or flv (HTTP-FLV). New values may be added; treat unknown values as other.<br>One of `hls`, `dash`, `flv` |
| `data.streams[].url` | `string` (uri) | Playback URL, signed and expiring: see expires_at. |
| `data.streams[].expires_at` | `string` (date-time) or `null` | When url stops working, RFC 3339 UTC, read from the platform's signed URL; null when unknown. |
| `data.streams[].width` | `integer` or `null` | Width in pixels; null for audio-only or when not stated. |
| `data.streams[].height` | `integer` or `null` | Height in pixels; null for audio-only or when not stated. |
| `data.streams[].video_codec` | `string` or `null` | Video codec, lowercase (h264, h265); null for audio-only or when not stated. |
| `data.streams[].bitrate_kbps` | `integer` or `null` | Target bitrate in kbit/s, when the platform states it. |
| `data.streams[].is_audio_only` | `boolean` or `null` | The rendition carries sound only. |
| `data.metrics` | `object` | Counts at fetch time; null = hidden or not exposed, 0 = zero. |
| `data.metrics.concurrent_viewer_count` | `integer` or `null` | X: listening. People watching now; null when not live or not shown. |
| `data.metrics.view_count` | `integer` or `null` | X: tuned in. Cumulative views since the broadcast began (TikTok counts entries into the room). |
| `data.metrics.like_count` | `integer` or `null` | Likes or hearts; null when hidden or not exposed. |
| `data.platform_specific` | `object` | Fields only this platform has, under its ID (platform_specific.\<platform>); each null when unknown. |
| `data.platform_specific.x` | `object` or `null` | An X Space's own fields. |
| `data.platform_specific.x.media_key` | `string` or `null` | X's media key of the Space's audio (28_\<number>), which its stream API takes. |
| `data.platform_specific.x.content_type` | `string` or `null` | X's word for the Space's kind (audio, visual_audio); null when X does not say. Its stream is audio either way. |
| `data.platform_specific.x.topics` | `string[]` | The topics the host filed the Space under, category first; \[\] when none. |
| `data.platform_specific.x.is_replay_available` | `boolean` or `null` | X keeps the Space's recording for replay. A scheduled Space says what the host chose. |
| `data.platform_specific.x.replay_url` | `string` (uri) or `null` | The recording's HLS playlist (AAC audio), with streams=true on an ended Space X keeps a replay of; null otherwise. |
| `data.platform_specific.x.is_clipping_available` | `boolean` or `null` | Listeners can clip the Space. |
| `data.platform_specific.x.is_employee_only` | `boolean` or `null` | Only X's employees can join. |
| `data.platform_specific.x.created_at` | `string` (date-time) or `null` | When the host created the Space (scheduled or started it), RFC 3339 UTC. |
| `data.platform_specific.x.updated_at` | `string` (date-time) or `null` | When X last updated the Space, RFC 3339 UTC. |
| `data.platform_specific.x.host_follower_count` | `integer` or `null` | The host's follower count at fetch time; null when the source does not show it. |
| `data.platform_specific.x.cohosts` | `object[]` | The Space's co-hosts (X's admins besides the host); \[\] when none. |
| `data.platform_specific.x.cohosts[].id` | `string` or `null` | Platform-native account ID; null when only the handle is known. |
| `data.platform_specific.x.cohosts[].username` | `string` or `null` | Handle without the @; null when the account has none. |
| `data.platform_specific.x.cohosts[].display_name` | `string` or `null` | Display name shown on the profile. |
| `data.platform_specific.x.cohosts[].url` | `string` (uri) or `null` | Canonical profile URL. |
| `data.platform_specific.x.cohosts[].avatar_url` | `string` (uri) or `null` | Profile picture URL. Platform CDN URLs can expire within hours. |
| `data.platform_specific.x.cohosts[].is_verified` | `boolean` or `null` | Platform verification badge; null where the platform has no badge. |
| `data.platform_specific.x.speakers` | `object[]` | The accounts with the right to speak: those on stage now while live, everyone who spoke once ended. |
| `data.platform_specific.x.speakers[].id` | `string` or `null` | Platform-native account ID; null when only the handle is known. |
| `data.platform_specific.x.speakers[].username` | `string` or `null` | Handle without the @; null when the account has none. |
| `data.platform_specific.x.speakers[].display_name` | `string` or `null` | Display name shown on the profile. |
| `data.platform_specific.x.speakers[].url` | `string` (uri) or `null` | Canonical profile URL. |
| `data.platform_specific.x.speakers[].avatar_url` | `string` (uri) or `null` | Profile picture URL. Platform CDN URLs can expire within hours. |
| `data.platform_specific.x.speakers[].is_verified` | `boolean` or `null` | Platform verification badge; null where the platform has no badge. |
| `data.platform_specific.x.listeners` | `object[]` | The listeners in the room now that X names, at most 50, while the Space is live (metrics.concurrent_viewer_count counts them all); \[\] once it ends, since X names no past listeners. |
| `data.platform_specific.x.listeners[].id` | `string` or `null` | Platform-native account ID; null when only the handle is known. |
| `data.platform_specific.x.listeners[].username` | `string` or `null` | Handle without the @; null when the account has none. |
| `data.platform_specific.x.listeners[].display_name` | `string` or `null` | Display name shown on the profile. |
| `data.platform_specific.x.listeners[].url` | `string` (uri) or `null` | Canonical profile URL. |
| `data.platform_specific.x.listeners[].avatar_url` | `string` (uri) or `null` | Profile picture URL. Platform CDN URLs can expire within hours. |
| `data.platform_specific.x.listeners[].is_verified` | `boolean` or `null` | Platform verification badge; null where the platform has no badge. |
| `data.platform_specific.x.mentioned_account_ids` | `string[]` | IDs of the accounts X lists the Space as mentioning (the host tags them); \[\] when none. |
| `data.platform_specific.x.metrics` | `object` or `null` | The Space's own counts. |
| `data.platform_specific.x.metrics.replay_view_count` | `integer` or `null` | Plays of the Space's recording. |
| `data.approximate_fields` | `string[]` | JSON paths of values rounded by the platform or parsed from display text. A list path means the list may be incomplete. \[\] when all exact. |
| `data.unknown_fields` | `string[]` | JSON paths of lists whose \[\] means unknown rather than none (a source that cannot see them); null already means unknown for every other field. \[\] when every list is known. |

not_found, private_or_unavailable and no_live are item-level: the request was fine, the item can't be returned.

### 400

400 Bad Request: 1 error code. Free: errors cost nothing.

| Code | HTTP | Retry | Meaning | What to do |
| --- | --- | --- | --- | --- |
| `invalid_input` | 400 | No | A parameter is missing or malformed, or the link is not one this endpoint takes. | Fix the parameter named in param as the message says. For a link of the wrong kind, call an endpoint listed in details.endpoints, when there is one. |

### 401

401 Unauthorized: 1 error code. Free: errors cost nothing.

| Code | HTTP | Retry | Meaning | What to do |
| --- | --- | --- | --- | --- |
| `unauthorized` | 401 | No | The x-api-key header is missing, or its key is unknown or revoked. On the dashboard's routes: the session cookie is missing or expired. | Send a valid API key in the x-api-key header. No key yet? A person gets one at details.signup_url; an AI agent follows details.agent_auth_url. |

### 402

402 Payment Required: 2 error codes. Free: errors cost nothing.

| Code | HTTP | Retry | Meaning | What to do |
| --- | --- | --- | --- | --- |
| `insufficient_credits` | 402 | No | The account does not have enough credits for this request. | Have a person buy credits at details.purchase_url (or make them a checkout link with details.checkout), then repeat the request. Do not retry automatically. |
| `spend_limit_reached` | 402 | No | The API key reached its spend limit for this period. The account may still have credits. | Wait until details.resets_at, or raise the key's spend limit (PATCH /v1/api_keys/{id}). Do not retry automatically. |

### 403

403 Forbidden: 2 error codes. Free: errors cost nothing.

| Code | HTTP | Retry | Meaning | What to do |
| --- | --- | --- | --- | --- |
| `forbidden` | 403 | No | The API key is valid but may not make this request, and details.reason says why: the account is suspended, the key lacks the route's scope, has expired, or was used from an IP outside its allowlist, or a rotated key's previous secret was used for a call that needs the admin scope. A running job stops with it too when its account is suspended or the key that created it is revoked or expires. It is about the key, never the item: a private item is private_or_unavailable, also 403, so branch on the code. | Act on details.reason. suspended: contact [support](mailto:support@socialtap.dev). scope: use a key with details.required_scope. previous_secret: use the new secret. key_expired or key_revoked: create a new key. ip_not_allowed: call from an allowed IP. |
| `private_or_unavailable` | 403 | No | The item exists but is not public: it is private, age- or region-restricted, or needs a login to view. It shares 403 with forbidden (which is about the key), so branch on the code. | Only public items can be fetched. Do not retry. |

### 404

404 Not Found: 2 error codes. Free: errors cost nothing.

| Code | HTTP | Retry | Meaning | What to do |
| --- | --- | --- | --- | --- |
| `not_found` | 404 | No | The item does not exist or was deleted. On GET /v1/requests/{id}/response: the response was not kept (details.reason says why). | Check the link or ID. Do not retry. |
| `no_live` | 404 | No | The account exists but has no live broadcast to show: nothing on air or scheduled, and no past broadcast the platform still shows. | Do not retry now. Ask again later, when the account may be live. |

### 429

429 Too Many Requests: 1 error code. Free: errors cost nothing.

| Code | HTTP | Retry | Meaning | What to do |
| --- | --- | --- | --- | --- |
| `rate_limited` | 429 | Yes, later | The account passed its runaway-protection ceiling: a high per-account limit that stops a broken client loop (plans have no rate limit). Requests without an API key (signup, the MCP server's tool listing and find_endpoint) are limited per IP address instead. It also stops an account whose failed requests in the last hour cost far more than its successful ones paid for: failures are free within a limit (the message says so), and successes raise it. | Wait the seconds in the retry-after header, then retry. If your steady traffic needs more, ask [support](mailto:support@socialtap.dev) to raise the ceiling; without an API key, send one. |

### 451

451: 1 error code. Free: errors cost nothing.

| Code | HTTP | Retry | Meaning | What to do |
| --- | --- | --- | --- | --- |
| `unavailable_for_legal_reasons` | 451 | No | We removed this item after a copyright notice or another legal request, so we don't return it. The request was free. A list leaves such items out instead, with an items_omitted warning. | Do not retry. The item stays unavailable unless the notice is withdrawn. |

### 500

500 Internal Error: 1 error code. Free: errors cost nothing.

| Code | HTTP | Retry | Meaning | What to do |
| --- | --- | --- | --- | --- |
| `internal` | 500 | Yes, later | An unexpected error on SocialTap's side. | Retry with backoff. If it keeps happening, contact [support](mailto:support@socialtap.dev) with the request_id. |

### 502

502 Bad Gateway: 1 error code. Free: errors cost nothing.

| Code | HTTP | Retry | Meaning | What to do |
| --- | --- | --- | --- | --- |
| `upstream_error` | 502 | Yes, later | The platform failed, or answered with something we could not read. | Retry with backoff. Failed requests are free. |

### 503

503 Unavailable: 2 error codes. Free: errors cost nothing.

| Code | HTTP | Retry | Meaning | What to do |
| --- | --- | --- | --- | --- |
| `upstream_blocked` | 503 | Yes, later | The platform refused every attempt, our own retries included. | Retry later with backoff. Failed requests are free. |
| `overloaded` | 503 | Yes, later | SocialTap was at capacity, or paused by its operators, and did not start the request. Nothing was fetched or charged. | Retry after the seconds in the retry-after header. Failed requests are free. |

## Pricing

From **1 credit** per request. Charged only for successful requests. Errors are free. The price depends on the source that produced the result, reported as `meta.source`; sources are tried cheapest first: Platform API → Public page.

| Source | Price per successful request | Per 1,000 requests |
| --- | --- | --- |
| Any source | 1 credit | $0.75–$1.97 |

**Balance, sources and what you were charged**

Your balance must be at least **1 credit** to start a request; with less, it is refused with [`insufficient_credits`](https://socialtap.dev/docs/errors/index.md#insufficient_credits) (HTTP 402) and costs nothing. Only that minimum is set aside when the request starts.

| meta.source | Source | What it means |
| --- | --- | --- |
| `api` | Platform API | The platform's public, logged-out API. |
| `page` | Public page | Data embedded in the platform's public web page. |

`meta.credits_charged` and the `x-credits-charged` header show what you paid. [How credits work](https://socialtap.dev/docs/credits/index.md) · [Packs](https://socialtap.dev/pricing/index.md)

Endpoint ID `x.space` · operationId `x.space.get` · [Product overview](https://socialtap.dev/apis/x/space/index.md)

---

[HTML version](https://socialtap.dev/docs/reference/x/space/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)
