# 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.

### 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
- [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): Retrieve your API usage statistics within the specified date range (maximum 365 days). Defaults to 7 days ago when no start or end dates are provided.
- [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. The AI determines the appropriate platform from your query and converts it into structured search filters. Results are delivered via Server-Sent Events (SSE) streaming.
- [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`. Returns a `content-disposition` attachment. Returns `404` if the video or subtitle ID is not found.
- [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 count. Topics are used for categorizing YouTube creators based on their content themes.
- [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. This endpoint provides detailed audience analytics to help understand creator reach, evaluate audience alignment, and support data‑driven influencer selection and campaign targeting.
- [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 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 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. Dates are returned as Unix timestamps in milliseconds.
- [Get YouTube Niches](https://docs.creatordb.app/api-reference/youtube/get-youtube-niches.md): Retrieve all available YouTube niches with their categories and the number of creators. Niches provide more granular categorization of YouTube creators than topics.
- [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 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 Sponsorship Information](https://docs.creatordb.app/api-reference/youtube/get-youtube-sponsorship-information.md): Retrieve recent YouTube videos identified as sponsored content for a specific creator, with metadata and engagement insights for influencer marketing analysis.
- [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.
- [Search for YouTube Content (Videos, Shorts, Streams) Across All Creators](https://docs.creatordb.app/api-reference/youtube/search-for-youtube-content-videos-shorts-streams-across-all-creators.md): Search for YouTube content (videos, shorts, streams) across all creators in the CreatorDB database using content-level and creator-level filters. Enables discovery of specific content by performance metrics, hashtags, sponsorship status, and more. By default, the `contentList` is sorted by `publishTime` descending (newest first). Custom sorting can be applied using the `sortBy` parameter.
- [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. Supports fuzzy search, pagination, and multiple filter combinations with up to 10 filters per request. By default the `creatorList` is sorted by `displayName`. Custom sorting can be applied using the `sortBy` parameter.
- [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. This endpoint provides detailed audience analytics to help understand creator reach, evaluate audience alignment, and support data‑driven influencer selection and campaign targeting.
- [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 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 specific creator, including publish time, post description, and engagement metrics. This endpoint enables users to fetch the latest content details for visual and textual analysis or further content-based operations.
- [Get Instagram Niches](https://docs.creatordb.app/api-reference/instagram/get-instagram-niches.md): Retrieve all available Instagram niche categories and their creator counts. Niches categorize creators by content themes.
- [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 specific period, including upload activity, follower growth, engagement metrics, and post or reel performance. Dates are returned as Unix timestamps in milliseconds.
- [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 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 Sponsorship Information](https://docs.creatordb.app/api-reference/instagram/get-instagram-sponsorship-information.md): Retrieve sponsorship data for a specified Instagram creator, including current and past brand partnerships with performance metrics.
- [Search for Instagram Content (Image Posts, Reels) Across All Creators](https://docs.creatordb.app/api-reference/instagram/search-for-instagram-content-image-posts-reels-across-all-creators.md): Search for Instagram content (image posts, reels) across all creators in the CreatorDB database using content-level and creator-level filters. Enables discovery of specific content by performance metrics, hashtags, sponsorship status, and more. By default, the `contentList` is sorted by `publishTime` descending (newest first). Custom sorting can be applied using the `sortBy` parameter.
- [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. Supports fuzzy search, pagination, and multiple filter combinations with up to 10 filters per request. The `creatorList` is, by default, sorted by `displayName`. Custom sorting can be applied using the `sortBy` parameter.
- [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. This endpoint provides detailed audience analytics to help understand creator reach, evaluate audience alignment, and support data‑driven influencer selection and campaign targeting.
- [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 Content Details](https://docs.creatordb.app/api-reference/tiktok/get-tiktok-content-details.md): Retrieve the most recent TikTok videos information 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. Niches categorize creators by content themes.
- [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 specific period, including upload activity, follower growth, engagement metrics, and video performance. Dates are returned as Unix timestamps in milliseconds.
- [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 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.
- [Search for TikTok Content (Videos) Across All Creators](https://docs.creatordb.app/api-reference/tiktok/search-for-tiktok-content-videos-across-all-creators.md): Search for TikTok content (videos) across all creators in the CreatorDB database using content-level and creator-level filters. Enables discovery of specific content by performance metrics, hashtags, audio, and more. By default, the `contentList` is sorted by `publishTime` descending (newest first). Custom sorting can be applied using the `sortBy` parameter.
- [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 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): Returns audience demographics for a brand's sponsored YouTube and Instagram creators when available. Using optional platform filters returns a single key.
- [Get Brand Summary: Creator Pool and Platform Performance](https://docs.creatordb.app/api-reference/sponsor/get-brand-summary-creator-pool-and-platform-performance.md): Returns a non-paginated summary object for a brand, combining creator roster rollups and platform-level performance totals for both YouTube and Instagram. Includes YouTube-specific metrics: estimated brand spend, CPM, and CPE.
- [Get Detailed Brand Profile Information](https://docs.creatordb.app/api-reference/sponsor/get-detailed-brand-profile-information.md): Returns identity and metadata for a specific brand — including company details, industries, key people, social links, competitors, and basic activity indicators. Does not include sponsor performance data or sponsored creator lists.
- [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): Returns performance metrics for creators sponsored by a brand on YouTube or Instagram. For each creator, the response includes comparison stats (sponsored vs. overall performance), estimated cost and CPM (YouTube only), and performance details for their individual posts or videos.
- [List All Indexed Brands (Paginated Directory)](https://docs.creatordb.app/api-reference/sponsor/list-all-indexed-brands-paginated-directory.md): Returns a paginated brand directory for catalog synchronization, dropdowns, or audits. Does not support filters — use /sponsor/search for filtered queries. Includes each brand's total sponsored content count and the platforms where sponsored content has been detected.
- [List Creators Sponsored by a Brand (One Platform)](https://docs.creatordb.app/api-reference/sponsor/list-creators-sponsored-by-a-brand-one-platform.md): Returns a paginated list of creators sponsored by a brand on a specified platform (YouTube or Instagram).
- [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. Returns a brand list suitable for discovery; use `/sponsor/information` for detailed brand data. Supports fuzzy name search, ISO 3166-1 alpha-3 country codes, and pagination.
- [Submit a Brand for Indexing into the CreatorDB Database](https://docs.creatordb.app/api-reference/sponsor/submit-a-brand-for-indexing-into-the-creatordb-database.md): Submits a brand for review and addition to the CreatorDB database. Submitted brands are not immediately available through other `/v3/sponsor` endpoints — each submission is reviewed before indexing. Each API key can make up to 100 submissions per day (resets at 00:00 UTC). The response `status` field returns one of: * `accepted` — The brand submission was accepted. Costs 1 credit. * `done` — The brand is already indexed. The existing record ID is returned in `existingBrandId`. Costs 0 credits. * `rejected` — The submission was invalid or the brand is blacklisted. Costs 0 credits.

### 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)