# 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, and audience demographics. Covers all `/sponsor/*` endpoints. YouTube + Instagram only (no TikTok).
- [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 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.

### Getting Started

- [Introduction](https://docs.creatordb.app/api-v3/introduction.md): Introduction to the 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 from the CreatorDB database 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
- [API Credit Usage](https://docs.creatordb.app/api-v3/api-credit-usage.md): Details about the number of API credits used per call and in the search response

### API Endpoints

- [Get API Usage Statistics](https://docs.creatordb.app/api-reference/user-account/get-api-usage-statistics.md): Retrieves your API usage statistics within the specified date range (maximum 365 days)
- [Search Creators Using Natural Language](https://docs.creatordb.app/api-reference/natural-language-search/search-creators-using-natural-language.md): Search for creators across YouTube, Instagram, and TikTok using natural language descriptions
- [Search YouTube Based on Custom Filter Criteria](https://docs.creatordb.app/api-reference/youtube/search-youtube-based-on-custom-filter-criteria.md): Search for YouTube creators using advanced filters such as `displayName`, subscriber count, video performance, and more 
- [Get YouTube Profile Information](https://docs.creatordb.app/api-reference/youtube/get-youtube-profile-information.md): Retrieve the profile information of a specified YouTube creator, including metadata such as subscriber count, account type, language, hashtags, and more
- [Get YouTube Contact Information](https://docs.creatordb.app/api-reference/youtube/get-youtube-contact-information.md): Retrieve the contact information of the specified YouTube creator
- [Get YouTube Performance Information](https://docs.creatordb.app/api-reference/youtube/get-youtube-performance-information.md): Retrieve advanced performance information of a specified YouTube creator, including upload activity, subscriber growth, engagement metrics, and video performance
- [Get YouTube Creator Performance History Information](https://docs.creatordb.app/api-reference/youtube/get-youtube-creator-performance-history-information.md): Retrieve daily performance snapshots for a specified YouTube creator, including upload activity, subscriber growth, engagement metrics, and video performance
- [Get YouTube Audience Demographics](https://docs.creatordb.app/api-reference/youtube/get-youtube-audience-demographics.md): Retrieve audience demographic insights for a specified YouTube creator, including country distribution, gender breakdown, and age composition
- [Get YouTube Content Details](https://docs.creatordb.app/api-reference/youtube/get-youtube-content-details.md): Retrieve the most recent YouTube videos and shorts of a specified creator, including publish time, video or short description, and engagement metrics
- [Get YouTube Sponsorship Information](https://docs.creatordb.app/api-reference/youtube/get-youtube-sponsorship-information.md): Retrieve recent YouTube videos identified as sponsored content for a specified creator, with metadata and engagement insights for influencer marketing analysis
- [Get All YouTube Topics](https://docs.creatordb.app/api-reference/youtube/get-all-youtube-topics.md): Retrieve all available YouTube topics with their categories and creator country
- [Get YouTube Niches](https://docs.creatordb.app/api-reference/youtube/get-youtube-niches.md): Retrieve all available YouTube niches with their categories and their creator counts. Niches provide more granular categorization of YouTube creators than topics
- [Get YouTube Subtitle Metadata](https://docs.creatordb.app/api-reference/youtube/get-youtube-subtitle-metadata.md): Retrieve available subtitle metadata for a video including `vssId`, `lang`, `langCode`. Returns a 404 error if the video does not exist
- [Download YouTube Subtitles as a JSON File](https://docs.creatordb.app/api-reference/youtube/download-youtube-subtitles-as-a-json-file.md): Streams the specified YouTube video's subtitle data as a JSON file download with the filename format `{videoId}-{vssId}.json`
- [Search Instagram Based on Custom Filter Criteria](https://docs.creatordb.app/api-reference/instagram/search-instagram-based-on-custom-filter-criteria.md): Search for Instagram creators using advanced filters such as `displayName`, follower count, content performance, and more
- [Get Instagram Profile Information](https://docs.creatordb.app/api-reference/instagram/get-instagram-profile-information.md): Retrieve basic profile information of a specified Instagram creator, including metadata such as follower count, account type, language, hashtags, and more
- [Get Instagram Contact Information](https://docs.creatordb.app/api-reference/instagram/get-instagram-contact-information.md): Retrieve the contact information of the specified Instagram creator
- [Get Instagram Performance Information](https://docs.creatordb.app/api-reference/instagram/get-instagram-performance-information.md): Retrieve advanced performance information of a specified Instagram creator, including post activity, follower growth, engagement metrics, and content performance
- [Get Instagram Performance History Information](https://docs.creatordb.app/api-reference/instagram/get-instagram-performance-history-information.md): Retrieve daily performance snapshots for a specified Instagram creator within a specified period, including upload activity, follower growth, engagement metrics, and post or reel performance
- [Get Instagram Audience Demographics](https://docs.creatordb.app/api-reference/instagram/get-instagram-audience-demographics.md): Retrieve audience demographic insights for a specified Instagram creator, including country distribution, gender breakdown, and age composition
- [Get Instagram Content Details](https://docs.creatordb.app/api-reference/instagram/get-instagram-content-details.md): Retrieve the most recent Instagram image posts and reels of a specified creator, including publish time, post description, and engagement metrics
- [Get Instagram Sponsorship Information](https://docs.creatordb.app/api-reference/instagram/get-instagram-sponsorship-information.md): Retrieve recent Instagram posts and reels identified as sponsored content for a specified creator, with metadata and engagement insights for influencer marketing analysis
- [Get Instagram Niches](https://docs.creatordb.app/api-reference/instagram/get-instagram-niches.md): Retrieve all available Instagram niche categories and their creator counts
- [Search TikTok Based on Custom Filter Criteria](https://docs.creatordb.app/api-reference/tiktok/search-tiktok-based-on-custom-filter-criteria.md): Search for TikTok creators using advanced filters such as `displayName`, follower count, content performance, and more. The `creatorList` is, by default, sorted by `displayName`. Custom sorting can be applied using the `sortBy` parameter
- [Get TikTok Profile Information](https://docs.creatordb.app/api-reference/tiktok/get-tiktok-profile-information.md): Retrieve profile information of a specified TikTok creator, including metadata, statistics, hashtags, and content analysis
- [Get TikTok Contact Information](https://docs.creatordb.app/api-reference/tiktok/get-tiktok-contact-information.md): Retrieve the contact information of the specified TikTok creator
- [Get TikTok Performance Information](https://docs.creatordb.app/api-reference/tiktok/get-tiktok-performance-information.md): Retrieve advanced performance information of a specified TikTok creator, including post activity, follower growth, engagement metrics, and content performance
- [Get TikTok Performance History Information](https://docs.creatordb.app/api-reference/tiktok/get-tiktok-performance-history-information.md): Retrieve daily performance snapshots for a specified TikTok creator within a specified period, including upload activity, follower growth, engagement metrics, and video performance
- [Get TikTok Audience Demographics](https://docs.creatordb.app/api-reference/tiktok/get-tiktok-audience-demographics.md): Retrieve audience demographic insights for a specified TikTok creator, including country distribution, gender breakdown, and age composition
- [Get TikTok Content Details](https://docs.creatordb.app/api-reference/tiktok/get-tiktok-content-details.md): Retrieve the most recent TikTok videos of a specified creator, including publish time, video description, and engagement metrics
- [Get TikTok Niches](https://docs.creatordb.app/api-reference/tiktok/get-tiktok-niches.md): Retrieve all available TikTok niche categories and their creator counts
- [Search for Brands Based on Influencer Marketing Activity](https://docs.creatordb.app/api-reference/sponsor/search-for-brands-based-on-influencer-marketing-activity.md): Search the CreatorDB sponsor database using filters including brand name, industry, region, and creator associations
- [Get Detailed Brand Profile Information](https://docs.creatordb.app/api-reference/sponsor/get-detailed-brand-profile-information.md): Retrieve identity and metadata for a specified brand, including company details, industries, key people, social links, competitors, and basic activity indicators
- [List All Indexed Brands (Paginated Directory)](https://docs.creatordb.app/api-reference/sponsor/list-all-indexed-brands-paginated-directory.md): Retrieve a paginated brand directory for catalog synchronization, dropdowns, or audits
- [List Creators Sponsored by a Brand (One Platform)](https://docs.creatordb.app/api-reference/sponsor/list-creators-sponsored-by-a-brand-one-platform.md): Retrieve a paginated list of creators sponsored by a brand on a specified platform (YouTube or Instagram)
- [Get Performance Metrics for Creators Sponsored by a Brand (One Platform)](https://docs.creatordb.app/api-reference/sponsor/get-performance-metrics-for-creators-sponsored-by-a-brand-one-platform.md): Retrieve performance metrics for creators sponsored by a brand on YouTube or Instagram
- [Get Audience Demographics for Creators Sponsored by a Brand (Per Platform)](https://docs.creatordb.app/api-reference/sponsor/get-audience-demographics-for-creators-sponsored-by-a-brand-per-platform.md): Retrieve audience demographics for a brand's sponsored creator pool, split per platform (YouTube and Instagram), enabling brands to compare reach and audience composition between platforms
- [Get Brand Summary: Creator Pool and Platform Performance](https://docs.creatordb.app/api-reference/sponsor/get-brand-summary:-creator-pool-and-platform-performance.md): Retrieve a non-paginated summary object for a brand, combining creator roster rollups and platform-level performance totals for both YouTube and Instagram

### 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
- [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-v2/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)