# YouTube Audience Insights (`exporter24/youtube-audience-insights`) Actor

Understand a YouTube creator's audience with insights into demographics, location, interests, account age, and performance.

- **URL**: https://apify.com/exporter24/youtube-audience-insights.md
- **Developed by:** [exporter24](https://apify.com/exporter24) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $350.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?

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

## YouTube Audience Insights

Understand who follows a public YouTube creator. The Actor creates one structured report in the run’s default Dataset.

### Input

| Input | What it means | Example and notes |
| --- | --- | --- |
| `profileUrl` | Public creator profile to analyze. | Required. Use a profile page, not an individual post or video: `https://www.youtube.com/@theAIsearch`. |

### Example input

```json
{
  "profileUrl": "https://www.youtube.com/@theAIsearch"
}
```

### Report output

A successful run writes one Dataset item with the following sections. Some metrics depend on what the platform makes available for this profile; when one metric cannot be calculated, the other available sections are still returned.

| Result field | What it tells you |
| --- | --- |
| `creator` | Profile summary: platform, profile ID, username, display name, profile URL, follower count, and post count. |
| `audience.genderDistribution` | Estimated share of the sampled audience in each gender group. Each value is a decimal share from 0 to 1. |
| `audience.ageDistribution` | Estimated share of the sampled audience in each age group. Each value is a decimal share from 0 to 1. |
| `audience.topCountries` | Countries with the largest audience shares. Each entry has `countryCode` (two-letter code) and `audienceShare` (0–1). |
| `audience.topAudienceSegments` | Audience interest or lifestyle segments that are prominent in the sample. |
| `audience.creatorTopics` | Topics associated with the creator’s content. |
| `audience.frequentlyMentionedTags` | Tags associated with audience activity; each entry includes a topic and, when available, mention count. |
| `audience.followerCountDistribution` | Share of sampled accounts in these follower-count ranges: `0–10`, `10–100`, `100–1k`, `1k–10k`, and `10k+`. |
| `audience.accountAgeDistribution` | Share of sampled accounts by account age: `<90 days`, `90–180 days`, `180 days–1 year`, `1–2 years`, `2–4 years`, and `4+ years`. |
| `audience.audienceAccountsWithUnder10FollowersShare` | Estimated share of sampled audience accounts with fewer than 10 followers; useful as one audience-quality signal. |
| `performance.medianViews / medianLikes / medianComments` | Typical creator content performance, summarized with medians so one unusually viral post has less influence. |
| `performance.engagementRate / viewRate` | Typical engagement and view rates, expressed as decimal shares from 0 to 1. |
| `report.generatedAt` | UTC time when this report was generated. |

Demographic and country values are proportions: `0.25` means 25%. Profile counts are totals for the creator account; audience distributions summarize the sample used for analysis. Individual audience records and sample counts are not included.

### How to use the insights

This report is designed to help you assess audience fit, compare creator profiles, and plan campaign outreach. It is based on a sample of publicly available audience data rather than every follower. The analysis checks that the sample reaches its minimum size before creating a report, helping ensure the results contain enough observations to reveal useful patterns.

Use the estimates to guide decisions about audience fit and campaign planning. They summarize observed patterns and are not exact counts of every follower.

### Free plan and pricing

- Free plan: up to **3 successful reports per UTC calendar month, shared across all five Audience Insights Actors**. You can use any mix of YouTube, TikTok, Instagram, Facebook, and X. The allowance resets on the first day of each month.
- A report is created only when enough public audience samples are available. If the sample is below the minimum, no Dataset item is created, there is no per-report item charge, and the unsuccessful run does not use a free report.
- Paid use is charged per successful report item at the rate shown on the Store page. Apify’s Actor start event is currently priced at $0.01 per GB of allocated memory (minimum one event).

### FAQ

#### Why are some metrics missing?

Available metrics vary by platform and profile. The Actor returns each insight that can be calculated from the available public data, so one missing metric does not remove the rest of the report.

#### Does the report include every follower?

The report summarizes a sample of public audience data. We require a minimum sample size before returning a report, and the resulting distributions are intended to reveal useful audience patterns. They are estimates, not exact follower totals.

#### Can I analyze a post or video URL?

Use a public YouTube creator profile URL. Post, video, or content URLs are not profile inputs.

#### What happens if the sample is too small?

The Actor explains that it could not create a reliable report, writes no Dataset item, and does not use a free report allowance. Try a creator with more public audience activity.

### Related tools

- **Discover creators by niche:** [YouTube Keyword Search](https://apify.com/exporter24/youtube-keyword-search).
- **Find creators like a profile:** [YouTube Similar Creator Search](https://apify.com/exporter24/youtube-similar-search).
- **Find one creator’s email:** [YouTube Email Finder](https://apify.com/exporter24/youtube-email-scraper).
- **Find emails for multiple profiles:** [YouTube Email Bulk Finder](https://apify.com/exporter24/youtube-email-bulk-scraper).
- **Live API workflows:** See the [NanoInfluencer Public API](https://www.nanoinfluencer.ai/public-api/docs) for real-time profile and search requests.

# Actor input Schema

## `profileUrl` (type: `string`):

Public creator profile URL on YouTube. Do not use a post or video URL.

## Actor input object example

```json
{
  "profileUrl": "https://www.youtube.com/@theAIsearch"
}
```

# Actor output Schema

## `datasetItems` (type: `string`):

One item per successful audience analysis. No item is written when the sample is insufficient.

## `taskMetadata` (type: `string`):

Status, profile URL, task ID, and report completion metadata.

# 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 = {
    "profileUrl": "https://www.youtube.com/@theAIsearch"
};

// Run the Actor and wait for it to finish
const run = await client.actor("exporter24/youtube-audience-insights").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 = { "profileUrl": "https://www.youtube.com/@theAIsearch" }

# Run the Actor and wait for it to finish
run = client.actor("exporter24/youtube-audience-insights").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 '{
  "profileUrl": "https://www.youtube.com/@theAIsearch"
}' |
apify call exporter24/youtube-audience-insights --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,exporter24/youtube-audience-insights"
        }
    }
}
```

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/vzxE2JxmPLUwQQJR9/builds/MDpLerTHpXBsflmpi/openapi.json
