# 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, 0 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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# 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(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).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": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,datamagnet/x-twitter-space-details-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/w2bmlygruIg2MD3G1/builds/co6iarnWYkgTOmfwB/openapi.json