# Collect X broadcast viewer counts for reports

**Use case:** 

Collect the viewing totals X exposes for selected broadcasts, together with state, event times and source URLs. Prepare audience reporting records for your own comparison of broadcasts, using the available watching and watched counts without treating them as verified unique viewers.

## Input

```json
{
  "inputList": [
    "https://x.com/i/broadcasts/1OGwbbXdjjdKB"
  ]
}
```

## Output

```json
{
  "input": {
    "label": "Input",
    "format": "string"
  },
  "status": {
    "label": "Status",
    "format": "string"
  },
  "id": {
    "label": "ID",
    "format": "string"
  },
  "url": {
    "label": "URL",
    "format": "string"
  },
  "state": {
    "label": "State",
    "format": "string"
  },
  "broadcast_status": {
    "label": "Broadcast Status",
    "format": "string"
  },
  "author.id": {
    "label": "Author / ID",
    "format": "text"
  },
  "author.username": {
    "label": "Author / Username",
    "format": "text"
  },
  "author.name": {
    "label": "Author / Name",
    "format": "text"
  },
  "author.profile_url": {
    "label": "Author / Profile URL",
    "format": "link"
  },
  "author.description": {
    "label": "Author / Description",
    "format": "text"
  },
  "author.location": {
    "label": "Author / Location",
    "format": "text"
  },
  "author.created_at": {
    "label": "Author / Created At",
    "format": "date"
  },
  "author.created_timestamp": {
    "label": "Author / Created Timestamp",
    "format": "number"
  },
  "author.followers_count": {
    "label": "Author / Followers Count",
    "format": "number"
  },
  "author.following_count": {
    "label": "Author / Following Count",
    "format": "number"
  },
  "author.posts_count": {
    "label": "Author / Posts Count",
    "format": "number"
  },
  "author.media_posts_count": {
    "label": "Author / Media Posts Count",
    "format": "number"
  },
  "author.likes_given_count": {
    "label": "Author / Likes Given Count",
    "format": "number"
  },
  "author.highlights_count": {
    "label": "Author / Highlights Count",
    "format": "number"
  },
  "author.avatar_url": {
    "label": "Author / Avatar URL",
    "format": "image"
  },
  "author.avatar_url_hd": {
    "label": "Author / Avatar URL HD",
    "format": "image"
  },
  "author.banner_url": {
    "label": "Author / Banner URL",
    "format": "image"
  },
  "author.website.url": {
    "label": "Author / Website / URL",
    "format": "link"
  },
  "author.website.expanded_url": {
    "label": "Author / Website / Expanded URL",
    "format": "link"
  },
  "author.bio_links.url": {
    "label": "Author / Bio Links / URL",
    "format": "array"
  },
  "author.bio_links.expanded_url": {
    "label": "Author / Bio Links / Expanded URL",
    "format": "array"
  },
  "author.bio_links.display_url": {
    "label": "Author / Bio Links / Display URL",
    "format": "array"
  },
  "author.is_verified": {
    "label": "Author / Is Verified",
    "format": "boolean"
  },
  "author.verified_type": {
    "label": "Author / Verified Type",
    "format": "text"
  },
  "author.is_blue_verified": {
    "label": "Author / Is Blue Verified",
    "format": "boolean"
  },
  "author.is_identity_verified": {
    "label": "Author / Is Identity Verified",
    "format": "boolean"
  },
  "author.verification_description": {
    "label": "Author / Verification Description",
    "format": "text"
  },
  "author.verified_since_at": {
    "label": "Author / Verified Since At",
    "format": "date"
  },
  "author.is_protected": {
    "label": "Author / Is Protected",
    "format": "boolean"
  },
  "author.possibly_sensitive": {
    "label": "Author / Possibly Sensitive",
    "format": "boolean"
  },
  "author.professional_type": {
    "label": "Author / Professional Type",
    "format": "text"
  },
  "author.affiliates_count": {
    "label": "Author / Affiliates Count",
    "format": "number"
  },
  "author.creator_subscriptions_count": {
    "label": "Author / Creator Subscriptions Count",
    "format": "number"
  },
  "author.can_highlight_posts": {
    "label": "Author / Can Highlight Posts",
    "format": "boolean"
  },
  "author.can_receive_messages": {
    "label": "Author / Can Receive Messages",
    "format": "boolean"
  },
  "author.can_be_media_tagged": {
    "label": "Author / Can Be Media Tagged",
    "format": "boolean"
  },
  "author.description_language": {
    "label": "Author / Description Language",
    "format": "text"
  },
  "author.profile_image_shape": {
    "label": "Author / Profile Image Shape",
    "format": "text"
  },
  "author.pinned_post_ids": {
    "label": "Author / Pinned Post Ids",
    "format": "array"
  },
  "author.birthdate.day": {
    "label": "Author / Birthdate / Day",
    "format": "number"
  },
  "author.birthdate.month": {
    "label": "Author / Birthdate / Month",
    "format": "number"
  },
  "author.birthdate.year": {
    "label": "Author / Birthdate / Year",
    "format": "number"
  },
  "author.birthdate.visibility": {
    "label": "Author / Birthdate / Visibility",
    "format": "text"
  },
  "author.birthdate.year_visibility": {
    "label": "Author / Birthdate / Year Visibility",
    "format": "text"
  },
  "started_at": {
    "label": "Started At",
    "format": "string"
  },
  "started_at_timestamp": {
    "label": "Started At Timestamp",
    "format": "integer"
  },
  "ended_at": {
    "label": "Ended At",
    "format": "string"
  },
  "ended_at_timestamp": {
    "label": "Ended At Timestamp",
    "format": "integer"
  },
  "image_url": {
    "label": "Image URL",
    "format": "string"
  },
  "media_key": {
    "label": "Media Key",
    "format": "string"
  },
  "width": {
    "label": "Width",
    "format": "integer"
  },
  "height": {
    "label": "Height",
    "format": "integer"
  },
  "total_watched": {
    "label": "Total Watched",
    "format": "integer"
  },
  "total_watching": {
    "label": "Total Watching",
    "format": "integer"
  }
}
```

## About this Actor

This example demonstrates how to use [Twitter Broadcast Scraper – X Metadata & View Counts](https://apify.com/scrapingmonkey/twitter-broadcast-details-scraper.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/scrapingmonkey/twitter-broadcast-details-scraper.md) to learn more, explore other use cases, and run it yourself.


## 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.
This Task's input is already configured above — use it as-is rather than inventing a new one.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/scrapingmonkey/twitter-broadcast-details-scraper.md

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