# CreatorDB Documentation Center

> This file provides an overview of CreatorDB's API documentation and developer resources.

## Docs

### Agent Skills

These skills are designed for AI agents (Claude, GPT, Cursor, Cline, etc.) to discover and use CreatorDB's API without reading the full documentation. Each skill is a self-contained Markdown file with frontmatter following the [agentskills.io specification](https://agentskills.io/specification). Together they cover every endpoint in API v3.

- [creator-search](https://docs.creatordb.app/.well-known/agent-skills/creator-search/SKILL.md): Search for influencers and creators across YouTube, Instagram, and TikTok by criteria (followers, engagement, country, language, niche, audience demographics) using either structured filters or natural language. Use when the user wants to find creators matching specific criteria.
- [creator-enrichment](https://docs.creatordb.app/.well-known/agent-skills/creator-enrichment/SKILL.md): Pull deep per-creator data — profile, contact emails, audience demographics, performance snapshots, performance history — for a known list of YouTube, Instagram, or TikTok creators. Use when the user already has channel IDs or handles and wants details on each.
- [brand-sponsorship](https://docs.creatordb.app/.well-known/agent-skills/brand-sponsorship/SKILL.md): Brand-side influencer marketing intelligence — search and analyze brands, their sponsored creator rosters, estimated spend, CPM, CPE, audience demographics, and the `/sponsor/submit` write path for nominating new brands for indexing. Covers all `/sponsor/*` endpoints. Sponsorship analytics are YouTube + Instagram only (no TikTok).
- [content-search](https://docs.creatordb.app/.well-known/agent-skills/content-search/SKILL.md): Search individual pieces of content (videos, posts, reels, shorts) across all creators on YouTube, Instagram, and TikTok using content-level filters such as performance, hashtags, sponsorship status, audio, post type, and recency. Use when the user's question starts at a piece of content rather than a creator — e.g. "find sponsored videos with >1M views in the last 30 days" or "top performing reels with #skincare last week".
- [content-analysis](https://docs.creatordb.app/.well-known/agent-skills/content-analysis/SKILL.md): Pull and analyze actual creator content — recent videos/posts/reels/shorts, sponsored placements with brand attribution, YouTube subtitles/transcripts, and the topic/niche taxonomy used to classify creators. Use for per-creator content-level analysis, transcription, or LLM-powered theme extraction.
- [account](https://docs.creatordb.app/.well-known/agent-skills/account/SKILL.md): Check API credit usage, remaining quota, and per-endpoint consumption history for a CreatorDB API key. Use for usage dashboards, pre-flight budget checks before bulk jobs, or diagnosing unexpected credit drain.
- [creator-csv-workflow](https://docs.creatordb.app/.well-known/agent-skills/creator-csv-workflow/SKILL.md): End-to-end pattern for enriching a CSV/spreadsheet of creators with CreatorDB data. Orchestrates the other skills — parse and dedupe input, resolve missing IDs via search, enrich via the per-creator endpoints, estimate credit budget, and export an enriched CSV/XLSX. Use when the user pastes a list and wants a structured export back.

The complete skills index is also available at [/.well-known/agent-skills/index.json](https://docs.creatordb.app/.well-known/agent-skills/index.json) for programmatic discovery.

### MCP Server

- [Setting Up the CreatorDB MCP Connector](https://docs.creatordb.app/mcp-server/setting-up-the-creatordb-mcp-connector.md): Connect the CreatorDB MCP server to Claude and other AI clients, and reconnect it to pick up the latest tools.
- [Setting Up CreatorDB Agentic Skills](https://docs.creatordb.app/mcp-server/setting-up-creatordb-agentic-skills.md): A guide on how to install CreatorDB API skills and troubleshoot common installation issues.

### Getting Started

- [Introduction](https://docs.creatordb.app/api-v3/introduction.md): Introduction to CreatorDB API
- [Authentication](https://docs.creatordb.app/api-v3/authentication.md): How to authenticate API requests to CreatorDB
- [Quickstart](https://docs.creatordb.app/api-v3/quickstart.md): Start getting creator data within a few minutes

### User Guides

- [Using Natural Language Search](https://docs.creatordb.app/api-v3/using_natural_language_search.md): Search for YouTube, Instagram, and TikTok creators using natural language descriptions
- [Creator Custom Search Filters](https://docs.creatordb.app/api-v3/creator-custom-search-filters.md): Search for specific creators using advanced filters
- [Configuring Custom Search Filters and Examples](https://docs.creatordb.app/api-v3/configuring_advanced_search_filters.md): Learn how to configure advanced search filters for YouTube, Instagram, TikTok, and sponsor searches
- [Fractional Calls](https://docs.creatordb.app/api-v3/fractional-calls.md): Request only the fields you need and pay proportionally. Use when the user wants to limit API credit costs consumed per call.
- [Field and Item Costs](https://docs.creatordb.app/api-v3/field-and-item-costs.md): Check how much each field costs in fractional calls for supported API endpoints.
- [API Credit Usage](https://docs.creatordb.app/api-v3/api-credit-usage.md): Details about the number of API credits used per call, fractional pricing, and the search response

### API Endpoints

- [Get API Usage](https://docs.creatordb.app/api-reference/general-operations/get-api-usage.md): Retrieve your API usage statistics for a given date range (up to 365 days).
- [Search Creators by Prompt](https://docs.creatordb.app/api-reference/ai-search/search-creators-by-prompt.md): Search across YouTube, Instagram, and TikTok from a natural-language prompt, with results streamed via SSE.

#### YouTube
- [Search Creators](https://docs.creatordb.app/api-reference/youtube/search-creators.md): Find YouTube creators using advanced filters such as subscriber count and video performance, with optional per-result enrichment.
- [Submit Creators](https://docs.creatordb.app/api-reference/youtube/submit-creators.md): Submit new YouTube creators to CreatorDB for indexing, billed per newly accepted creator.
- [Get Profile Information](https://docs.creatordb.app/api-reference/youtube/get-profile-information.md): Retrieve a YouTube creator's profile, including subscriber count, account type, language, and hashtags.
- [Get Contact](https://docs.creatordb.app/api-reference/youtube/get-contact.md): Retrieve a YouTube creator's contact email addresses.
- [Get Performance Information](https://docs.creatordb.app/api-reference/youtube/get-performance-information.md): Retrieve advanced YouTube performance metrics — upload activity, subscriber growth, engagement, and video performance.
- [Get Performance History](https://docs.creatordb.app/api-reference/youtube/get-performance-history.md): Retrieve daily historical performance snapshots for a YouTube creator.
- [Get Audience Demographics](https://docs.creatordb.app/api-reference/youtube/get-audience-demographics.md): Retrieve a YouTube creator's audience demographics — country, gender, and age breakdowns.
- [Search Content](https://docs.creatordb.app/api-reference/youtube/search-content.md): Search YouTube videos, shorts, and streams across all creators using content- and creator-level filters.
- [Get Content Details](https://docs.creatordb.app/api-reference/youtube/get-content-details.md): Retrieve a YouTube creator's most recent videos and shorts with engagement metrics.
- [Get Sponsorship Information](https://docs.creatordb.app/api-reference/youtube/get-sponsorship-information.md): Retrieve a YouTube creator's recent sponsored videos and the brands behind them.
- [List Topics](https://docs.creatordb.app/api-reference/youtube/list-topics.md): List all YouTube topics with their categories and creator counts.
- [List Niches](https://docs.creatordb.app/api-reference/youtube/list-niches.md): List all YouTube niches with their categories and creator counts (finer-grained than topics).
- [Get Video Subtitles](https://docs.creatordb.app/api-reference/youtube/get-video-subtitles.md): Retrieve available subtitle metadata (vssId, language) for a YouTube video.
- [Download Video Subtitles](https://docs.creatordb.app/api-reference/youtube/download-video-subtitles.md): Download a YouTube video's subtitle data as a JSON file.

#### Instagram
- [Search Creators](https://docs.creatordb.app/api-reference/instagram/search-creators.md): Find Instagram creators using advanced filters such as follower count and content performance, with optional per-result enrichment.
- [Submit Creators](https://docs.creatordb.app/api-reference/instagram/submit-creators.md): Submit new Instagram creators to CreatorDB for indexing, billed per newly accepted creator.
- [Get Profile Information](https://docs.creatordb.app/api-reference/instagram/get-profile-information.md): Retrieve an Instagram creator's profile, including follower count, account type, language, and hashtags.
- [Get Contact](https://docs.creatordb.app/api-reference/instagram/get-contact.md): Retrieve an Instagram creator's contact email addresses.
- [Get Performance Information](https://docs.creatordb.app/api-reference/instagram/get-performance-information.md): Retrieve advanced Instagram performance metrics — post activity, follower growth, engagement, and content performance.
- [Get Performance History](https://docs.creatordb.app/api-reference/instagram/get-performance-history.md): Retrieve daily historical performance snapshots for an Instagram creator.
- [Get Audience Demographics](https://docs.creatordb.app/api-reference/instagram/get-audience-demographics.md): Retrieve an Instagram creator's audience demographics — country, gender, and age breakdowns.
- [Search Content](https://docs.creatordb.app/api-reference/instagram/search-content.md): Search Instagram image posts and reels across all creators using content- and creator-level filters.
- [Get Content Details](https://docs.creatordb.app/api-reference/instagram/get-content-details.md): Retrieve an Instagram creator's most recent posts and reels with engagement metrics.
- [Get Sponsorship Information](https://docs.creatordb.app/api-reference/instagram/get-sponsorship-information.md): Retrieve an Instagram creator's current and past brand partnerships with performance metrics.
- [List Niches](https://docs.creatordb.app/api-reference/instagram/list-niches.md): List all Instagram niche categories with their creator counts.

#### TikTok
- [Search Creators](https://docs.creatordb.app/api-reference/tiktok/search-creators.md): Find TikTok creators using advanced filters such as follower count and content performance, with optional per-result enrichment.
- [Submit Creators](https://docs.creatordb.app/api-reference/tiktok/submit-creators.md): Submit new TikTok creators to CreatorDB for indexing, billed per newly accepted creator.
- [Get Profile Information](https://docs.creatordb.app/api-reference/tiktok/get-profile-information.md): Retrieve a TikTok creator's profile, including metadata, statistics, hashtags, and content analysis.
- [Get Contact](https://docs.creatordb.app/api-reference/tiktok/get-contact.md): Retrieve a TikTok creator's contact email addresses.
- [Get Performance Information](https://docs.creatordb.app/api-reference/tiktok/get-performance-information.md): Retrieve advanced TikTok performance metrics — post activity, follower growth, engagement, and content performance.
- [Get Performance History](https://docs.creatordb.app/api-reference/tiktok/get-performance-history.md): Retrieve daily historical performance snapshots for a TikTok creator.
- [Get Audience Demographics](https://docs.creatordb.app/api-reference/tiktok/get-audience-demographics.md): Retrieve a TikTok creator's audience demographics — country, gender, and age breakdowns.
- [Search Content](https://docs.creatordb.app/api-reference/tiktok/search-content.md): Search TikTok videos across all creators using content- and creator-level filters.
- [Get Content Details](https://docs.creatordb.app/api-reference/tiktok/get-content-details.md): Retrieve a TikTok creator's most recent videos with engagement metrics.
- [List Niches](https://docs.creatordb.app/api-reference/tiktok/list-niches.md): List all TikTok niche categories with their creator counts.

#### Sponsor
- [Search Brands](https://docs.creatordb.app/api-reference/sponsor/search-brands.md): Search the sponsor/brand database by name, industry, region, and creator associations.
- [Submit Brand](https://docs.creatordb.app/api-reference/sponsor/submit-brand.md): Submit a brand for review and indexing (up to 100 submissions per key per day).
- [Get Brand Information](https://docs.creatordb.app/api-reference/sponsor/get-brand-information.md): Retrieve a brand's identity and metadata — company details, industries, key people, social links, and competitors.
- [List Brands](https://docs.creatordb.app/api-reference/sponsor/list-brands.md): Retrieve a paginated brand directory with each brand's sponsored-content count and detected platforms.
- [List Sponsored Creators](https://docs.creatordb.app/api-reference/sponsor/list-sponsored-creators.md): List the creators a brand has sponsored on a given platform (YouTube or Instagram).
- [Get Sponsored Creator Performance](https://docs.creatordb.app/api-reference/sponsor/get-sponsored-creator-performance.md): Retrieve performance metrics for a brand's sponsored creators, including sponsored-vs-overall comparisons and estimated cost/CPM (YouTube).
- [Get Sponsored Creator Demographics](https://docs.creatordb.app/api-reference/sponsor/get-sponsored-creator-demographics.md): Retrieve audience demographics for a brand's sponsored YouTube and Instagram creators.
- [Get Brand Summary](https://docs.creatordb.app/api-reference/sponsor/get-brand-summary.md): Retrieve a combined summary of a brand's creator roster and platform performance, including estimated spend, CPM, and CPE (YouTube).

### Filter Value References

- [YouTube Channel Categories](https://docs.creatordb.app/api-v3/youtube-categories.md): The list of YouTube channel categories supported by CreatorDB API and how to use them as filters
- [Instagram Categories](https://docs.creatordb.app/api-v3/instagram-categories.md): The list of supported Instagram `category` filter values
- [Country Codes](https://docs.creatordb.app/api-v2/country-code.md): A list of supported country code values that you can use as filters in CreatorDB's advanced search.
- [Language Codes](https://docs.creatordb.app/api-v3/language-code.md): The list of supported language values for related advanced filter searches.
- [Industry List](https://docs.creatordb.app/api-v3/industry-list.md): The list of supported `industry` filter values for advanced brand search.

### Troubleshooting and FAQs

- [Error Codes](https://docs.creatordb.app/api-v3/error-code.md): Common error codes returned by the CreatorDB API and their meanings

## OpenAPI Specs
- [api-v3](https://docs.creatordb.app/api-v3/api-v3.yaml)
- [openapi](https://docs.creatordb.app/api-reference/openapi.json)