# X (twitter) Space Details Scraper (`datamagnet/x-twitter-space-details-scraper`) Actor Get the basic information for a space by its ID. - **URL**: https://apify.com/datamagnet/x-twitter-space-details-scraper.md - **Developed by:** [Datamagnet](https://apify.com/datamagnet) (community) - **Categories:** Developer tools, Social media, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Space Info Lookup Scraper, Extractor & Data Collector Space Info Lookup is a simple Apify actor that helps you look up a space by its ID and instantly get its basic details in one result. It is ideal for analysts, researchers, community managers, and automation builders who need fast access to space information without manual searching. Paste in a Space ID and get the raw space record back exactly as provided by the source, including all available fields. Use it to quickly confirm whether a space exists, review its core details, and capture the data you need for reporting or workflow automation. ### Key Features - Extract basic space details from a single Space ID in one run. - Collect the full raw space record exactly as returned by the source. - Verify whether a space exists and review its core information quickly. - Capture replay, participant, creator, and timing details in one place. - Support research workflows that need reliable space metadata for analysis. - Save time by avoiding manual lookup and copy-paste work. - Export results for reporting, tracking, or downstream automation. ### Use Cases #### Space Verification Community teams and researchers often need to confirm that a space exists before using it in a report or workflow. This actor returns the space’s ID, state, started and ended times, and availability flags so you can quickly validate the record and move on with confidence. #### Event Tracking If you monitor live audio events, this actor helps you capture the key facts about each space in a consistent format. Fields like `state`, `started`, `ended`, `total_live_listeners`, and `content_type` make it easier to understand when the space happened, how it performed, and what kind of session it was. #### Audience Analysis Marketers and analysts can use the returned listener and replay metrics to understand audience interest. With values such as `total_live_listeners`, `total_replay_watched`, `replay_available`, and `is_space_available_for_replay`, you can compare sessions and identify which spaces drew the most attention. #### Creator Research Creators, agencies, and brand teams can review the `creator` and `participants` sections to understand who hosted and who joined the space. This is useful for mapping speaker networks, identifying recurring hosts, and building a clearer picture of the people involved in a conversation. #### Content Cataloging If you maintain a database of spaces, this actor gives you the core fields needed to organize and label each record. Details like `media_key`, `playlist`, `chunks_base_url`, `community`, and participant lists help you store richer metadata for future reference. ### Input | Field | Type | Required | Description | Example | |---|---|---:|---|---| | id | string | Yes | Enter the Space ID you want to look up. | 1738106896777699464 | ### Output | Field | Type | Description | |---|---|---| | state | string | Shows the current status of the space, such as whether it has ended or is still active. | | id | string | The unique Space ID you searched for. | | ended | string | The time the space ended, shown as a timestamp value. | | started | number | The time the space started, shown as a timestamp value. | | locked | boolean | Indicates whether the space was restricted or locked. | | replay_start_time | null or number | Shows when replay started, if replay is available. | | total_live_listeners | number | The total number of people who listened live. | | total_replay_watched | number | The total number of replay views or listens. | | content_type | string | Describes the type of space content, such as audio or visual audio. | | is_space_available_for_replay | boolean | Indicates whether the space can be replayed. | | media_key | string | A media identifier used to reference the space’s recording. | | replay_available | boolean | Shows whether replay access is available. | | participants | object | Lists the people involved in the space, including admins and speakers. | | participants.admins | array | People who managed or hosted the space. | | participants.speakers | array | People who spoke during the space. | | community | boolean | Indicates whether the space is tied to a community. | | creator | object | Basic information about the person who created the space. | | creator.avatar | null or string | The creator’s profile image, if available. | | creator.display_name | string | The creator’s display name. | | creator.is_blue_verified | boolean | Indicates whether the creator has blue verification. | | creator.screenname | string | The creator’s public username. | | creator.followers_count | number | How many followers the creator has. | | creator.pinned_tweet_ids_str | array | A list of pinned post IDs associated with the creator. | | creator.rest_id | string | The creator’s unique account identifier. | | sharings | array | Any sharing-related entries connected to the space. | | playlist | string | A link to the replay playlist when available. | | chunks_base_url | string | A base link for replay media segments. | ### Sample Output ```json { "state": "Ended", "id": "1yoJMwpbmaXKQ", "ended": "1712035727255", "started": 1712011212266, "locked": false, "replay_start_time": null, "total_live_listeners": 1284588, "total_replay_watched": 210, "content_type": "visual_audio", "is_space_available_for_replay": true, "media_key": "28_1774929779223080960", "replay_available": true, "participants": { "admins": [ { "avatar": "https://pbs.twimg.com/profile_images/2073768040299171840/duhnAwEg_normal.jpg", "display_name": "Bark", "is_verified": true, "is_blue_verified": true, "periscope_user_id": "1zYKbeqYpyQex", "screenname": "barkmeta", "rest_id": "336348053" } ], "speakers": [ { "avatar": "https://pbs.twimg.com/profile_images/2037283714225569792/lz8UC6hl_normal.jpg", "display_name": "Alex 🦷", "is_verified": true, "periscope_user_id": "1ayjVrNWqmZjp", "is_blue_verified": true, "screenname": "Shilllin", "rest_id": "1064982684060057606" } ] }, "community": false, "creator": { "avatar": null, "display_name": "Bark", "is_blue_verified": true, "screenname": "barkmeta", "followers_count": 289114, "pinned_tweet_ids_str": [ "1896702771291926766" ], "rest_id": "336348053" }, "sharings": [], "playlist": "https://prod-fastly-us-east-1.video.pscp.tv/Transcoding/v1/hls/TuGZupq0IW3JTw2-slEt_jGrNF8Rs59Rp0HLJcqd-IDA1RsF8APHPdaJx8fo2bEt-PteyXGtm_mMM8LdxDw0NQ/non_transcode/us-east-1/periscope-replay-direct-prod-us-east-1-public/audio-space/playlist_16734708395013829425.m3u8?type=replay", "chunks_base_url": "https://prod-fastly-us-east-1.video.pscp.tv/Transcoding/v1/hls/TuGZupq0IW3JTw2-slEt_jGrNF8Rs59Rp0HLJcqd-IDA1RsF8APHPdaJx8fo2bEt-PteyXGtm_mMM8LdxDw0NQ/non_transcode/us-east-1/periscope-replay-direct-prod-us-east-1-public/audio-space/" } ```` ### How It Works 1. You enter the Space ID you want to check. 2. The actor looks up that space automatically. 3. It gathers the basic details and returns the full record. 4. You review the result to confirm the space status, creator, participants, and replay details. 5. You export or reuse the data in your own reports, spreadsheets, or workflows. ### Getting Started Getting started is easy and does not require coding knowledge. Click **Try for free**, paste your Space ID into the input field, and click **Run**. In a short time, you will receive the space details in a clean result that you can download or export. Results are available in **JSON, CSV, or Excel**, making it simple to use the data in reports, spreadsheets, or other business tools. ### Frequently Asked Questions #### Do I need technical skills? No. This actor is designed for non-technical users. You only need to paste in a Space ID, run the actor, and review the results. #### How fast does it run? It is built for quick lookups, so most runs finish fast. The exact time depends on the availability of the space and the amount of data returned, but the process is straightforward and lightweight. #### What format is the output? You can work with the results in JSON, CSV, or Excel. That makes it easy to inspect the data directly or move it into a spreadsheet for analysis and reporting. #### Is this legal to use? You should always use data responsibly and in line with the rules that apply to your use case. If you are collecting information for business, research, or internal tracking, make sure your usage complies with the relevant policies and laws in your region. #### Can I schedule it to run automatically? Yes. You can use Apify scheduling and automation tools to run it on a regular basis. This is helpful if you want to keep a list of spaces updated or monitor new records over time. # Actor input Schema ## `id` (type: `string`): Enter the ID of the space you want to look up. ## Actor input object example ```json { "id": "1yoJMwpbmaXKQ" } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "id": "1yoJMwpbmaXKQ" }; // Run the Actor and wait for it to finish const run = await client.actor("datamagnet/x-twitter-space-details-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "id": "1yoJMwpbmaXKQ" } # Run the Actor and wait for it to finish run = client.actor("datamagnet/x-twitter-space-details-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "id": "1yoJMwpbmaXKQ" }' | apify call datamagnet/x-twitter-space-details-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=datamagnet/x-twitter-space-details-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "X (twitter) Space Details Scraper", "description": "Get the basic information for a space by its ID.", "version": "0.0", "x-build-id": "co6iarnWYkgTOmfwB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datamagnet~x-twitter-space-details-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datamagnet-x-twitter-space-details-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/datamagnet~x-twitter-space-details-scraper/runs": { "post": { "operationId": "runs-sync-datamagnet-x-twitter-space-details-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/datamagnet~x-twitter-space-details-scraper/run-sync": { "post": { "operationId": "run-sync-datamagnet-x-twitter-space-details-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "id" ], "properties": { "id": { "title": "Space ID", "type": "string", "description": "Enter the ID of the space you want to look up." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```