# YouTube Video Content Brief Intelligence (`neuton/youtube-video-content-brief-intelligence`) Actor

Build deterministic source-only content briefs from complete public YouTube video metadata.

- **URL**: https://apify.com/neuton/youtube-video-content-brief-intelligence.md
- **Developed by:** [Neuton Scripts](https://apify.com/neuton) (community)
- **Categories:** Social media, Marketing, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$25.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.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **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 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

## YouTube Video Content Brief Intelligence

Build deterministic source-only content briefs from complete public YouTube video metadata. Built for content strategists, creator agencies, media researchers, and AI content workflows.

### Buyer question

**Can I build a source-linked video brief without pretending to watch or transcribe the video?**

### Start in 30 seconds

```json
{
  "videoUrlsOrIds": [
    "c347oYQO57A"
  ],
  "maxResults": 1
}
```

[Open the workflow-specific starter Task](https://apify.com/neuton/youtube-video-content-brief-intelligence/examples/sample-yt-content-brief-mkbhd-video?utm_source=apify_store\&utm_medium=actor_readme\&utm_campaign=youtube_content_brief_activation\&utm_content=source_only_brief_task), run the bounded example, inspect the Dataset and free `RUN_SUMMARY`, then replace the sample videos.

### Choose this Actor when

Choose this Actor for a repeatable complete source-linked video content brief workflow. Use a broad metadata scraper when you only need raw fields; use this specialist when the evidence rule and billing boundary matter.

### First run checklist

1. Keep `maxResults` at 1 and run the included public example.
2. Inspect the evidence fields and compare Dataset rows with `RUN_SUMMARY`.
3. Confirm the result matches the public video description or player metadata.
4. Save a Task, schedule, webhook, or API workflow only after the sample is useful.

### Evidence and billing

The brief uses title, description, keywords, duration, date, views, and links only. It never claims the video was watched or transcribed.

Launch PPE price: **$25.00 per 1,000 complete source-linked video content briefs**, or **$2.50 for 100**. Diagnostics, duplicates, incomplete fetches, baselines, unchanged checks, empty classifications, and unsupported inferences are never billed.

Build the brief only from title, description, keywords, duration, date, views, and links. Do not claim to have watched or transcribed the video.

### Output schema

Billable Dataset fields: `videoId`, `videoUrl`, `title`, `channelId`, `publishDate`, `durationSeconds`, `viewCount`, `description`, `keywords`, `externalDomains`, `contentSignals`, `evidenceDirect`, `analysisHash`, `scrapedAt`. The separate `RUN_SUMMARY` reports videos requested, videos observed, rows saved, free exclusions, and monitor state. Error-only or placeholder rows never enter the Dataset.

### Source boundaries

The Actor uses public YouTube video player metadata without login, cookies, a browser, or a residential proxy. Cloud runs use Apify's rotating datacenter proxy because YouTube can require sign-in from shared Actor IPs. It does not return captions, transcripts, subtitles, comments, search results, channel feeds, private videos, members-only content, or age-gated content.

### Automation and AI agents

Use Apify Tasks, schedules, API, webhooks, ChatGPT, Claude, Neuton Actors MCP, n8n, Make, Zapier, a warehouse, RAG pipeline, or agent workflow.

Hosted Apify MCP endpoint: `https://mcp.apify.com/?tools=neuton/youtube-video-content-brief-intelligence`

### Explore the YouTube data family

- [YouTube Video Metadata Scraper](https://apify.com/neuton/youtube-video-metadata-scraper) for complete raw public video fields
- [YouTube Description Links Intelligence](https://apify.com/neuton/youtube-description-links-intelligence) for all explicit outbound links
- [Neuton Actors MCP](https://apify.com/neuton/neuton-actors-mcp-server) for AI-agent workflows

### SEO keywords

YouTube scraper, YouTube metadata API, YouTube Shorts scraper, YouTube sponsor links, YouTube chapters extractor, YouTube video monitor, creator intelligence, Apify YouTube Actor.

### Responsible use

Use public metadata for legitimate creator, media, marketing, research, education, and automation workflows. Do not bypass access controls, collect private content, misrepresent sponsorship evidence, or make unsupported audience claims. Review YouTube's current terms and applicable privacy, advertising, and copyright rules before production use.

# Actor input Schema

## `videoUrlsOrIds` (type: `array`):

Public YouTube watch URLs, Shorts URLs, youtu.be URLs, or 11-character video IDs. Up to 50.

## `maxResults` (type: `integer`):

Maximum complete unique videos inspected and eligible for output.

## Actor input object example

```json
{
  "videoUrlsOrIds": [
    "c347oYQO57A"
  ],
  "maxResults": 1
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (type: `string`):

No description

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("neuton/youtube-video-content-brief-intelligence").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("neuton/youtube-video-content-brief-intelligence").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 '{}' |
apify call neuton/youtube-video-content-brief-intelligence --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,neuton/youtube-video-content-brief-intelligence"
        }
    }
}

```

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/aNxgCVMjTha41DSUs/builds/uWwwZ180vS9DRvZYn/openapi.json