# Influencer Analytics API - Sponsorships, Brand Spend, CreatorDB (`nabeelbaghoor/influencer-analytics-sponsorship-brand-spend-api`) Actor

Search YouTube, Instagram and TikTok influencers by niche, country, followers and engagement, then pull profiles, contact emails, audience demographics, performance history, sponsorships and transcripts, plus brand spend, CPM and sponsored creators. Bring your own CreatorDB key.

- **URL**: https://apify.com/nabeelbaghoor/influencer-analytics-sponsorship-brand-spend-api.md
- **Developed by:** [Nabeel Hassan](https://apify.com/nabeelbaghoor) (community)
- **Categories:** Social media, Marketing, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 creator, brand or list row returneds

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

## Influencer Analytics API - Sponsorships, Brand Spend, CreatorDB

Find YouTube, Instagram and TikTok influencers by niche, country, followers and engagement, then export their profiles, contact emails, audience demographics, performance history, recent content, sponsorships and transcripts, and see which brands sponsor whom and what they spend. Uses your own CreatorDB API key, never changes anything in your account, and charges only for rows that carry data.

### What it collects

- **Creator search** on YouTube, Instagram or TikTok with real filters: name keyword, creator country and content language, niches, YouTube topics, categories, hashtags, follower range, engagement rate, average views, 30 day follower growth, last upload, business email, sponsored content, verified accounts, and main audience country, gender and age. Any other documented filter (more than 100 on YouTube) goes in through the advanced filters list. Sort by followers, engagement, views, growth or platform score.
- **Natural language search**: describe the creators you want in plain words and the provider turns it into a search, or answers with suggestions when the description is too broad.
- **Creator profiles**: display name, bio, followers or subscribers, total content, country, main and secondary languages, verification, business and private account flags, hashtags with usage stats, topics, niches, category breakdown, other links, related creators and last upload.
- **Contact emails** for YouTube, Instagram and TikTok creators.
- **Performance**: upload counts over 7, 30 and 90 days, rankings, likes, comments, views, length and engagement of recent and all-time videos, shorts, posts and reels, growth rates, and on YouTube the estimated CPM and price range for a video or a short.
- **Performance history**: one row per day for up to 365 days with followers, content count and performance blocks.
- **Audience demographics**: audience countries, gender split, average age and age breakdown.
- **Recent content**: recent videos, shorts, image posts, reels and TikToks with publish time, title or caption, views, likes, comments, shares, engagement rate, hashtags, sponsored flag, tagged creators and audio.
- **Sponsorships** (YouTube, Instagram): each brand that sponsored the creator with the sponsored videos, posts or reels and their performance.
- **YouTube subtitles**: the available tracks of a video and the chosen track as the provider's JSON subtitle file, for transcript analysis.
- **Brand intelligence**: brand search by name, industry, headquarters country, sponsoring region and platform, sponsored creator, active campaign and estimated spend; the full brand directory; brand profiles with industries, key people, socials and competitors; the creators a brand sponsored; sponsored creator performance with estimated cost and CPM; the audience of a brand's sponsored creators; and a spend summary with estimated spend, CPM and CPE.
- **Topics and niches** to fill the search filters, and **credit usage** per day.
- Read only, pay per result, bring your own key.

### Input

| Field | What it does |
| --- | --- |
| What to read | One of the 20 modes above. Creator search is the default. |
| Platform | YouTube, Instagram or TikTok. Sponsorship modes take YouTube or Instagram. |
| Name keyword, creator countries, content languages, niches, topics, categories, hashtags | Creator search filters. Countries are ISO 3166-1 alpha-3 (USA), languages ISO 639-3 (eng). |
| Minimum and maximum followers, minimum engagement rate, minimum average views, minimum 30 day growth, posted within days | Creator search ranges. Rates are decimals: 0.03 is 3 percent. |
| Has a business email, has sponsored content, verified only, main audience countries, gender and age | Creator search flags and audience filters. |
| Advanced filters | Any documented filterName as {"filterName", "op", "value"}, for creator search and brand search. |
| Sort creators by, sort descending | Creator search order. |
| Description | Natural language search. |
| Creators | Creator modes: channel IDs, handles or profile URLs, one per line. |
| History days | Performance history, 1 to 365. |
| Video IDs, subtitle language, prefer human captions | YouTube video subtitles. |
| Brand name, industries, brand countries, sponsoring regions, sponsoring platforms, sponsored YouTube channel IDs, sponsored Instagram handles, active campaign only, minimum 30 day spend, sort brands by | Brand search and the brand directory. |
| Brand IDs, sponsored creator and performance sort | Brand modes. A brand ID is usually the brand's domain, such as nike.com. |
| Usage start and end date | API credit usage. |
| Maximum results, requests per minute | Row cap and pacing. |
| CreatorDB API key | Your own key, as a secret input. |

A typical flow: run creator search, copy the handles or channel IDs into Creators, then run profiles, contact emails or audience demographics on them.

### Credits on the CreatorDB side

CreatorDB meters its API in credits, separately from this actor's price. Full-bundle prices from its Credit Usage page: creator search 1 credit per call per 10 filters (charged even when nothing matches), profile 2, performance 1.5 to 3, performance history 3 to 5 by range, audience 10, contact 15, content 3, sponsorship 5, subtitle track list 1 and download 3, topics and niches 1, brand search 2 per page, brand directory 1 per page, brand profile 2, and the brand creators, performance, audience and summary 15 each. Natural language search costs a few credits by token use. Lookups of an ID the provider has not indexed cost nothing, and errors cost nothing.

### FAQ

#### What is an influencer analytics API used for?

Finding and vetting creators, and studying brands' creator marketing, from code or a spreadsheet instead of a dashboard. An agency builds a shortlist of US beauty YouTubers with 100K to 1M subscribers, then pulls their emails and audience age and gender. A brand team checks which creators its competitors sponsored on Instagram and what they paid per thousand views. A media buyer tracks a creator's daily subscriber growth before a deal. A research team transcribes recent videos for topic analysis.

#### Which data source does this actor read?

The CreatorDB API v3 at apiv3.creatordb.app, through the routes in its public OpenAPI document at docs.creatordb.app: the YouTube, Instagram and TikTok search, profile, contact, performance, performance history, audience, content detail, sponsorship and niche endpoints, the YouTube topic and subtitle endpoints, natural language search, the sponsor search, list, information, creators, performance, audience and summary endpoints, and usage. The host and routes were checked live on 2026-10-04.

#### Do I need a CreatorDB API key?

Yes. This actor is bring-your-own-key and never ships one. Create a key in the CreatorDB dashboard under API (your account needs credits to create one), paste it into the input, or set it once as the `DATA_API_KEY` environment secret. A missing or refused key, an account out of credits, and a key over its own spend limit each end the run cleanly with a message saying which it was.

#### Which platforms are covered?

YouTube, Instagram and TikTok for creator search, profiles, contact emails, performance, history, audience, content and niches. Sponsorship data, brand sponsored creators and brand spend cover YouTube and Instagram; the provider does not track TikTok sponsorships. Topics and subtitles are YouTube only. Estimated CPM, price and brand spend are YouTube estimates.

#### How do I find the right niche or topic values?

Run the niches mode for the platform, or the topics mode for YouTube. Each row has an `id` such as `id_smartphone_ScienceTechnology` that the niches and topics filters take, the readable `name` and `category`, and in `value` the number of creators tagged with it.

#### How do I get creator contact emails in bulk?

Run creator search with "Has a business email" ticked, then put the returned handles or channel IDs in Creators and run the contact emails mode. Each row has `emails` and the first one in `email`. Creators with no email on file give a free row with found set to false.

#### What does a creator the provider does not know do?

It becomes a free row with found set to false and a note. The provider does not index every account; new ones can be submitted for indexing in the CreatorDB dashboard. A malformed handle or channel ID is caught before any call with a message saying what shape is expected.

#### Can this actor change anything in my CreatorDB account?

No. The routes that submit creators or brands for indexing are not used, and the optional fractional `fields` parameter is never sent, so every call returns the full response at the provider's full-bundle price and works on any key.

#### How is it priced?

Pay per result in three tiers: list rows (search results, brands, sponsored creators, content items, history days, topics and niches), reports (profiles, performance, sponsorships, subtitle files, brand profiles, sponsored creator performance), and premium rows (contact emails, audience demographics, brand audience and spend summaries). Lookups that find nothing and credit usage rows are free. Your CreatorDB credits apply separately.

### Example output

```json
{
  "mode": "creatorProfiles",
  "modeLabel": "Creator profiles",
  "recordType": "profile",
  "platform": "youtube",
  "requested": "@examplechef",
  "found": true,
  "id": "UCabcdefghijklmnopqrstuv",
  "name": "Example Chef",
  "handle": "@examplechef",
  "url": "https://www.youtube.com/channel/UCabcdefghijklmnopqrstuv",
  "country": "USA",
  "followers": 1250000,
  "date": "2026-10-01T15:00:00.000Z",
  "title": null,
  "value": null,
  "retrievedAt": "2026-10-04T09:14:52.118Z",
  "note": null,
  "channelId": "UCabcdefghijklmnopqrstuv",
  "uniqueId": "@examplechef",
  "displayName": "Example Chef",
  "mainLanguage": "eng",
  "totalSubscribers": 1250000,
  "totalContents": 640,
  "isVerified": true,
  "hasSponsors": true,
  "subscriberGrowth": { "g7": 0.0031, "g30": 0.0142, "g90": 0.0405 },
  "niches": ["id_recipes_HowtoStyle"],
  "lastPublishTime": 1790866800000
}
```

Values are illustrative; every field is one the provider documents. Search rows carry the creator's handle, ID and follower count; content rows carry `contentType`, `views`, `likes` and `engagementRate`; history rows carry one `date` each; sponsorship rows carry the brand in `id` and `name` with the sponsored content; brand rows carry `brandId`, `industries` and spend fields.

### Keyword map

influencer analytics API, influencer search API, influencer discovery, creator database, YouTube influencer API, Instagram influencer API, TikTok influencer API, influencer email finder, creator contact emails, audience demographics API, influencer engagement rate, YouTube CPM estimate, sponsored content tracking, brand sponsorship intelligence, brand influencer spend, competitor influencer marketing, YouTube transcripts API, CreatorDB API.

# Actor input Schema

## `mode` (type: `string`):

Creator search finds YouTube, Instagram or TikTok creators with the filters below. Natural language search takes a plain description. The creator modes read one row per creator (or per video, day or brand) for the creators listed below. YouTube video subtitles read transcripts for video IDs. Topics and niches list the taxonomy values the niche and topic filters take. The brand modes search and list sponsoring brands and read their sponsored creators, performance, audience and spend for the brand IDs listed below. API credit usage reads your key's usage per day.

## `platform` (type: `string`):

The platform for creator search, the creator modes and niches. Sponsorships and the brand sponsored creator modes cover YouTube and Instagram only. Natural language search picks the platform from the description.

## `keyword` (type: `string`):

Creator search. Fuzzy match on the creator display name, such as cooking or tech review.

## `creatorCountries` (type: `array`):

Creator search. Countries the creator is based in, as three letter ISO 3166-1 alpha-3 codes such as USA, GBR, DEU, JPN.

## `creatorLanguages` (type: `array`):

Creator search. Main content language as three letter ISO 639-3 codes such as eng, spa, por, jpn.

## `niches` (type: `array`):

Creator search. Niche IDs, as the niches mode lists them for the platform, such as id_smartphone_ScienceTechnology.

## `topics` (type: `array`):

Creator search on YouTube. Topic IDs, as the topics mode lists them, such as id_gaming_Entertainment.

## `categories` (type: `array`):

Creator search. The main channel category on YouTube, or the professional account category on Instagram and TikTok.

## `hashtags` (type: `array`):

Creator search. Creators who use these hashtags (with or without #).

## `minFollowers` (type: `integer`):

Creator search. More than this many subscribers (YouTube) or followers (Instagram, TikTok).

## `maxFollowers` (type: `integer`):

Creator search. Fewer than this many subscribers or followers.

## `minEngagementRate` (type: `number`):

Creator search. Average engagement rate of recent content as a decimal, such as 0.03 for 3 percent: recent videos on YouTube and TikTok, recent posts and reels on Instagram.

## `minAvgViews` (type: `integer`):

Creator search. Average views of recent videos (YouTube, TikTok) or recent reels (Instagram).

## `minFollowerGrowth30d` (type: `number`):

Creator search. Follower or subscriber growth rate over the last 30 days as a decimal, such as 0.05 for 5 percent.

## `postedWithinDays` (type: `integer`):

Creator search. Only creators whose last upload is within this many days.

## `hasEmail` (type: `boolean`):

Creator search. Only creators with a contact email on file.

## `hasSponsors` (type: `boolean`):

Creator search on YouTube and Instagram. Only creators who have published sponsored content.

## `verifiedOnly` (type: `boolean`):

Creator search on Instagram and TikTok. Only verified accounts.

## `audienceCountries` (type: `array`):

Creator search. The country with the largest audience share, as ISO 3166-1 alpha-3 codes.

## `audienceGender` (type: `string`):

Creator search. The dominant gender of the audience.

## `audienceAge` (type: `string`):

Creator search. The primary age range of the audience. TikTok has no 13-17 group.

## `advancedFilters` (type: `array`):

Creator search and brand search. Any other documented filter as a list of objects with filterName, op (=, in, >, <) and value, plus isFuzzySearch on string filters. Example: \[{"filterName": "avgRecentShortsViews", "op": ">", "value": 100000}]. Every filterName is checked against the documented list for the platform.

## `sortBy` (type: `string`):

Creator search. Mapped to the matching documented field on each platform.

## `sortDescending` (type: `boolean`):

Creator search, brand search, the brand directory and the brand creator modes. Highest first.

## `description` (type: `string`):

Natural language search. A description of the creators you want, up to 1000 characters, such as: US based YouTube beauty creators with over 1M subscribers.

## `creators` (type: `array`):

The creator modes. One per line on the chosen platform: a YouTube channel ID (UC...), a handle such as @mrbeast or nike, or a profile URL (youtube.com/@name, youtube.com/channel/UC..., instagram.com/name, tiktok.com/@name).

## `pastDayRange` (type: `integer`):

Creator performance history. How many past days of daily snapshots, 1 to 365. The provider charges more credits for longer ranges.

## `videoIds` (type: `array`):

YouTube video subtitles. One YouTube video ID or URL per line. The creator recent content mode lists video IDs.

## `subtitleLanguage` (type: `string`):

YouTube video subtitles. A two letter language code such as en, es or zh-Hant. Empty takes the first track.

## `preferHumanCaptions` (type: `boolean`):

YouTube video subtitles. Take creator uploaded captions over auto-generated ones when both exist.

## `brandName` (type: `string`):

Brand search. Fuzzy match on the brand name or alias, such as nike.

## `industries` (type: `array`):

Brand search. Industry values from the provider's Industry List, such as Consumer Electronics or Video Games.

## `brandCountries` (type: `array`):

Brand search. ISO 3166-1 alpha-3 codes.

## `sponsoringRegions` (type: `array`):

Brand search. Countries where the brand's sponsored creators are mainly based, as ISO 3166-1 alpha-3 codes.

## `sponsoringPlatforms` (type: `array`):

Brand search. Brands with sponsorships on these platforms.

## `sponsoredYoutubeChannelIds` (type: `array`):

Brand search. Brands that sponsored these YouTube channels.

## `sponsoredInstagramHandles` (type: `array`):

Brand search. Brands that sponsored these Instagram accounts.

## `activeCampaignOnly` (type: `boolean`):

Brand search. Only brands with sponsored content in the last 30 days.

## `minEstimatedSpend30d` (type: `integer`):

Brand search. Estimated spend on sponsored YouTube creators over the last 30 days.

## `brandSortBy` (type: `string`):

Brand search (all choices) and the brand directory (name or total sponsored content).

## `brandIds` (type: `array`):

The brand modes. One brand ID per line, usually the brand's main domain such as nike.com; brand search lists them.

## `sponsoredCreatorSortBy` (type: `string`):

Brand sponsored creators.

## `sponsoredPerformanceSortBy` (type: `string`):

Brand sponsored creator performance. Averages across the brand's sponsored content per creator.

## `usageStartDate` (type: `string`):

API credit usage. YYYY-MM-DD. Defaults to 7 days ago.

## `usageEndDate` (type: `string`):

API credit usage. YYYY-MM-DD, at most 365 days after the start. Defaults to today.

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

Row cap for the run. Searches page 100 rows a call and stop here.

## `requestsPerMinute` (type: `integer`):

Pacing of calls to the provider. Lower it if the provider rate limits your key.

## `apiKey` (type: `string`):

Your own CreatorDB API key (API, then Create key, in the CreatorDB dashboard). Optional here if the DATA_API_KEY secret is set. Never logged.

## Actor input object example

```json
{
  "mode": "searchCreators",
  "platform": "youtube",
  "creatorCountries": [
    "USA"
  ],
  "minFollowers": 100000,
  "audienceGender": "any",
  "audienceAge": "any",
  "sortBy": "followers",
  "sortDescending": true,
  "pastDayRange": 30,
  "preferHumanCaptions": true,
  "brandSortBy": "totalSponsoredContent",
  "sponsoredCreatorSortBy": "lastSponsoredDate",
  "sponsoredPerformanceSortBy": "publishTime",
  "maxResults": 100,
  "requestsPerMinute": 60
}
```

# Actor output Schema

## `records` (type: `string`):

One row per creator, profile, audience, content item, history day, sponsorship, transcript, brand or usage day.

# 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 = {
    "creatorCountries": [
        "USA"
    ],
    "minFollowers": 100000
};

// Run the Actor and wait for it to finish
const run = await client.actor("nabeelbaghoor/influencer-analytics-sponsorship-brand-spend-api").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 = {
    "creatorCountries": ["USA"],
    "minFollowers": 100000,
}

# Run the Actor and wait for it to finish
run = client.actor("nabeelbaghoor/influencer-analytics-sponsorship-brand-spend-api").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 '{
  "creatorCountries": [
    "USA"
  ],
  "minFollowers": 100000
}' |
apify call nabeelbaghoor/influencer-analytics-sponsorship-brand-spend-api --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,nabeelbaghoor/influencer-analytics-sponsorship-brand-spend-api"
        }
    }
}
```

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/p0nn1T6mRZ43RwLUF/builds/s008OUdlpKm2AZxQg/openapi.json