X Broadcast Viewer History & Replay Link Scraper

What it returns

8 fields from the published dataset schema. Export as JSON, CSV or Excel, or read the dataset through the Apify API.

• type
• title
• state
• broadcaster.username
• viewersNow
• viewersTotal
• startedAt
• url

Not in the schema among the core X (Twitter) fields: post_id, text, author, posted_at, likes, reposts. The field matrix shows which other tools return them.

How it differs from the other X (Twitter) Actors

Among the 12 catalogue Actors for X (Twitter) with a published schema, only this one returns viewersNow, viewersTotal.

Pick another Actor if you need

Input

Example input

Built from the input form's published example values and defaults.

{
  "broadcastIds": [
    "https://x.com/i/broadcasts/1YGNrbPLejQGw"
  ],
  "includeViewerStats": true,
  "includeViewerTimeline": false,
  "maxViewerTimelinePoints": 0,
  "includeReplayVideo": false,
  "includeChatHistory": false,
  "maxChatMessages": 100,
  "includeThumbnail": true,
  "includeBroadcasterProfile": true
}

Run it from code or an AI agent

The same run through the Apify API, with the example input. You need an Apify API token; the run is billed to your account at the Store price.

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run_input = {
    "broadcastIds": [
        "https://x.com/i/broadcasts/1YGNrbPLejQGw"
    ],
    "includeViewerStats": True,
    "includeViewerTimeline": False,
    "maxViewerTimelinePoints": 0,
    "includeReplayVideo": False,
    "includeChatHistory": False,
    "maxChatMessages": 100,
    "includeThumbnail": True,
    "includeBroadcasterProfile": True
}

run = client.actor("dataspryva/x-broadcast-viewer-history-and-replay-link-scraper").call(run_input=run_input)
if run is None:
    raise RuntimeError("The Actor run was not found.")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

import { ApifyClient } from "apify-client";

const client = new ApifyClient({ token: "<YOUR_APIFY_TOKEN>" });
const input = {
    "broadcastIds": [
        "https://x.com/i/broadcasts/1YGNrbPLejQGw"
    ],
    "includeViewerStats": true,
    "includeViewerTimeline": false,
    "maxViewerTimelinePoints": 0,
    "includeReplayVideo": false,
    "includeChatHistory": false,
    "maxChatMessages": 100,
    "includeThumbnail": true,
    "includeBroadcasterProfile": true
};

const run = await client.actor("dataspryva/x-broadcast-viewer-history-and-replay-link-scraper").call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

curl -X POST "https://api.apify.com/v2/actors/dataspryva~x-broadcast-viewer-history-and-replay-link-scraper/run-sync-get-dataset-items"   -H "Authorization: Bearer $APIFY_TOKEN"   -H "Content-Type: application/json"   -d '{"broadcastIds":["https://x.com/i/broadcasts/1YGNrbPLejQGw"],"includeViewerStats":true,"includeViewerTimeline":false,"maxViewerTimelinePoints":0,"includeReplayVideo":false,"includeChatHistory":false,"maxChatMessages":100,"includeThumbnail":true,"includeBroadcasterProfile":true}'

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=dataspryva/x-broadcast-viewer-history-and-replay-link-scraper",
      "headers": {
        "Authorization": "Bearer <YOUR_APIFY_TOKEN>"
      }
    }
  }
}

What a run costs

The result rate falls on higher Apify plans. Each figure is the published per-result rate times the number of results.

• Every run also has a start event, charged per GB of memory (minimum one): $0.10 on Free, $0.03 on Business. At its default memory of 1 GB a run starts at $0.10 on Free. Fewer, larger runs keep this small.
• The Free plan includes $5 of monthly usage (Apify pricing, checked 2026-11-11); at the Free rate that covers at most about 5,050 results, less start events and platform usage.
• Worked example: 10,000 results in one run on the Free plan cost $10 ($9.90 for results + $0.10 start), plus Apify platform usage (compute), billed separately by Apify.
• Pay per event. Platform usage (compute) is billed by Apify on top of the event prices. Compare other tools in the cost estimator.

Where it fits among X (Twitter) routes

It ranks 8 of 12 catalogue Actors for X (Twitter) on the published formula (fields, price, reliability, freshness). Its line is highlighted on the map.

What people use it for

• Broadcast audience analysis
• Replay discovery
• Chat extraction

Other catalogue Actors for X (Twitter)

Similar Actors

Questions people ask

Sources

• X Broadcast Viewer History & Replay Link Scraper on Apify Store
• Published build with input and output schema (JSON)
• X API v2 documentation