Search for creators using natural language across YouTube, Instagram, and TikTok. The AI determines the platform from your query and converts it into structured filters. Response includes creatorList AND a platform field telling you which platform was chosen. Best for exploratory queries where you don't know exact filter names — fall back to search_youtube/instagram/tiktok when you need precise control over filters. Credit cost is dynamic (token-based, typically 1–10 credits).

Search YouTube creators using structured filters. Costs 1 credit per 10 filters (max 10). Use totalSubscribers (NOT totalFollowers) for count thresholds. YT-specific filterable fields: topics (coarse ~400-theme taxonomy — IG/TT don't have it), niches (granular; also on IG/TT but derived separately). Response: creatorList, totalResults, hasNextPage, nextOffset — pass nextOffset as the next request's offset to paginate.

Search Instagram creators using structured filters. Costs 1 credit per 10 filters (max 10). Use totalFollowers (NOT totalSubscribers) for count thresholds. IG has niches but NOT topics (YouTube-only). Hashtag values need the "#" prefix to match the indexed hashTagsSearch field. Response: creatorList, totalResults, hasNextPage, nextOffset.

Search TikTok creators using structured filters. Costs 1 credit per 10 filters (max 10). Use totalFollowers (NOT totalSubscribers) for count thresholds. TT has niches but NOT topics (YouTube-only). Hashtag values need the "#" prefix. Note: TikTok does not expose a per-brand sponsorship endpoint, so hasSponsors-style filtering is coarser than on YT/IG. Response: creatorList, totalResults, hasNextPage, nextOffset.

Get a YouTube creator's profile: display name, subscriber count, description, isVerified, country (ISO 3166-1 alpha-3), main language, linked socials, channel-level hashtags, YouTube native channel categories, AI-classified topics (coarse) and niches (granular), subscriberGrowth.g7/g30/g90 trend deltas, relatedCreators UC IDs for discovery, and sponsored videoPrice + shortsPrice blocks with low/raw/high CPM and dollar bands (YouTube-only — IG/TT do not return pricing). Use list_youtube_topics / list_youtube_niches to resolve topic/niche IDs to human names. Costs 2 credits.

Get a YouTube creator's contact email addresses (channel "for business" + public). Costs 15 credits.

Get a YouTube creator's engagement metrics. Returns four sibling objects: videosPerformanceRecent + shortsPerformanceRecent (R20: last 20 of each) and videosPerformanceAll + shortsPerformanceAll (up to 800). Each has avg/median/min/max/percentile25/percentile75/iqr for likes/comments/views, plus an engagement block with (L+C+V)/subscribers and consistencyScore (0–100; bands: high 81–100, moderate 51–80, low 0–50; requires ≥6 content pieces). ranking block carries global/country/language percentiles. recentVideosGrowth.g7/g30/g90 shows engagement-rate trend. contentCountByDays.7d/30d/90d shows posting cadence. Costs 2 credits.

Get daily metric snapshots (subscribers, total content count, all-time performance) for a YouTube creator. Returns the histories array of timestamped snapshots over the past N days. Costs 3 credits.

Get a YouTube creator's audience demographics: audienceLocations (top 6 countries with shares), audienceGender (maleRatio + femaleRatio, binary only), audienceAvgAge (integer), audienceAgeBreakdown (fixed 7 buckets: 13-17/18-24/25-34/35-44/45-54/55-64/65+). When data is missing the endpoint returns the placeholder shape (all 0.0) — treat male+female=0 as missing. Costs 10 credits.

Get a YouTube creator's recent content (videos + shorts) with per-item engagement: views, likes, comments, length (seconds), isMemberOnly flag (filter for member-only content), hashtags (with "#"), publishTime (Unix-ms), engagementRate. Content from the last 4 days is excluded from metric calculations. Costs 3 credits.

Get a YouTube creator's sponsored content grouped by brand. Returns sponsorList: [{ brandName, brandId, brandIgIds, sponsoredVideos, sponsoredVideosPerformance }]. brandIgIds are the brand's Instagram handles — useful to pivot from a sponsored creator back to the brand's own IG profile. sponsoredVideos carries per-item engagement (same shape as content-detail). CAVEAT: only scans the most recent ~20–30 posts AND only detects brands already indexed in CreatorDB — an empty sponsorList is NOT proof of no sponsorships. Costs 5 credits.

List the full YouTube TOPIC taxonomy used by CreatorDB — every available topic (~470+ entries) with channelCount per topic. TOPICS are a coarse, evolving classification (e.g. "Academic", "Finance", "Health Education"). YOUTUBE-ONLY: Instagram and TikTok do not have a topic taxonomy. To see which topics a specific creator is classified under, use get_youtube_profile and read the topics field. Takes no parameters. Costs 1 credit.

List the full YouTube NICHE taxonomy used by CreatorDB — every available niche (14000+ entries) with channelCount per niche. NICHES are granular subcategories (e.g. "Vlog/People Blogs", "ASMR/People Blogs"). To see which niches a specific creator is classified under, use get_youtube_profile and read the niches field. Per-platform: YT/IG/TT each have their own niche taxonomy — they are not interchangeable. Takes no parameters. Costs 1 credit.

List available subtitle tracks for a SINGLE YouTube video: language codes, auto-generated vs human-uploaded. Per-video, not per-channel — pass the videoId of one video at a time. Use this before calling get_youtube_subtitles_download to know what languages exist. Costs 1 credit.

Search individual YouTube content (videos, shorts, streams) across CreatorDB's index. Different from search_youtube (which searches CREATORS) — this returns individual posts matching content-level filters. Response includes contentList[] with contentId, contentType (video|shorts|stream), title, description, thumbnail, url, publishTime (Unix-ms), lengthSec, isSponsored, partneredBrands[], views/likes/comments/engagementRate, hashtags, language, category, and a nested creator block. Plus totalResults, hasNextPage, nextOffset for pagination. Content-level filterable fields: postType, title, description (NOTE: description filter is currently deferred — returns 400), hashtag, publishTime (filter value is integer "days ago", not Unix-ms — semantic split with the response field), views, likes, comments, engagement, isSponsored, partneredBrands, lengthSec, language, category, performanceViews, performanceEngagement. Creator-level filters also supported (creatorDisplayName, country, contentTopics, contentNiches, audienceLocation, etc.). The 4-day fresh-content exclusion does NOT apply here. Costs 2 credits per page.

Download the subtitle track for a specific YouTube video. Per-video — pass videoId, not channelId. Costs 3 credits per download.

Get an Instagram creator's profile: display name, follower count, biography, isVerified/isBusinessAccount flags, country (ISO 3166-1 alpha-3), main language, linked socials (YouTube/TikTok), hashtags used, account-level categories, and the creator's AI-classified niches. To browse the full IG niche taxonomy use list_instagram_niches. Costs 2 credits.

Get an Instagram creator's contact email addresses (business/public-listed emails). Costs 15 credits.

Get an Instagram creator's engagement metrics on first-page content. Returns imagesPerformanceRecent + reelsPerformanceRecent with avg/median/min/max likes, comments, and (for reels) views, plus an engagement block using (L+C)/followers and consistencyScore (0–100; bands: high 81–100, moderate 51–80, low 0–50; requires ≥6 posts). ranking block carries global/country/language percentiles. recentReelsGrowth.g7/g30/g90 shows engagement-rate trend. contentCountByDays.7d/30d/90d shows posting cadence. IG has no all-time window (YouTube-only). Costs 2 credits.

Get daily metric snapshots (followers, content count, first-page engagement) for an Instagram creator. Returns the histories array of timestamped snapshots over the past N days. Costs 3 credits.

Get an Instagram creator's audience demographics: audienceLocations (top 6 countries with shares), audienceGender (maleRatio + femaleRatio, binary only), audienceAvgAge (integer), audienceAgeBreakdown (fixed 7 buckets: 13-17/18-24/25-34/35-44/45-54/55-64/65+). When data is missing the endpoint returns the placeholder shape (all 0.0) — treat male+female=0 as missing, not "no gender data." Costs 10 credits.

Get an Instagram creator's recent content (images + reels) with per-item engagement: likes, comments, views (reels only — images have no view count), caption, hashtags (with "#"), mentionedCreators (@-mentions), publishTime (Unix-ms), engagementRate. Content from the last 4 days is excluded from metric calculations. Pinned posts >90 days old are excluded if they would be the oldest item. Costs 2 credits.

Get an Instagram creator's sponsored content grouped by brand. Returns sponsorList: [{ brandName, brandId, brandIgIds, sponsoredVideos, sponsoredVideosPerformance }]. Each sponsoredVideo carries per-item engagement (same shape as content-detail). CAVEAT: only scans the most recent ~20–30 posts AND only detects brands already indexed — an empty sponsorList is NOT proof the creator has no sponsors. Costs 5 credits.

Search individual Instagram content (images, reels, slideshows) across CreatorDB's index. Different from search_instagram (which searches CREATORS) — this returns individual posts. Response includes contentList[] with contentId, contentType (slideshow|reel|video, sometimes null for legacy posts), description, thumbnail, url, publishTime (Unix-ms), isSponsored, partneredBrands[], likes/comments/engagementRate, hashtags, and a nested creator block. NO views and NO lengthSec (IG data model). Content-level filterable: postType, description (searches caption AND reel title together), hashtag, publishTime (integer "days ago" — semantic split with response field), likes, comments, engagement, isSponsored, partneredBrands, performanceLikes, performanceEngagement. Creator-level filters also supported. Costs 2 credits per page.

List the full Instagram NICHE taxonomy used by CreatorDB — every available niche with channelCount per niche (the response is large: ~10K+ entries). NICHES are granular subcategories (e.g. "love/All", "fashion/All"). To see which niches a specific creator is classified under, use get_instagram_profile and read the niches field. Per-platform: IG/YT/TT each have their own niche taxonomy — they are not interchangeable. Instagram does NOT have a "topics" taxonomy (that is YouTube-only). Takes no parameters. Costs 1 credit.

Get a TikTok creator's profile: display name, follower count, biography, isVerified flag, country (ISO 3166-1 alpha-3), main language, linked socials, hashtags, and the creator's AI-classified niches. To browse the full TT niche taxonomy use list_tiktok_niches. Costs 2 credits.

Get a TikTok creator's contact email addresses (public-listed). Costs 15 credits.

Get a TikTok creator's engagement metrics on recent videos. Returns videosPerformanceRecent with avg/median/min/max views, likes, comments, shares, plus an engagement block using (L+C+Shares)/followers and consistencyScore (0–100; bands: high 81–100, moderate 51–80, low 0–50; requires ≥6 videos). ranking block carries global/country/language percentiles. recentVideosGrowth.g7/g30/g90 shows engagement-rate trend. contentCountByDays.7d/30d/90d shows posting cadence. TikTok has no all-time window (YouTube-only). Costs 2 credits.

Get daily metric snapshots (followers, content count, recent engagement) for a TikTok creator. Returns the histories array of timestamped snapshots over the past N days. Costs 3 credits.

Get a TikTok creator's audience demographics: audienceLocations (top 6 countries with shares), audienceGender (maleRatio + femaleRatio, binary only), audienceAvgAge (integer), audienceAgeBreakdown (fixed 7 buckets: 13-17/18-24/25-34/35-44/45-54/55-64/65+). When data is missing the endpoint returns the placeholder shape (all 0.0) — treat male+female=0 as missing. Costs 10 credits.

Get a TikTok creator's recent videos with per-item engagement: views, likes, comments, shares, engagementRate, length (seconds), isAd, hashtags (with "#"), publishTime (Unix-ms). Each item also carries TT-only audio metadata (audioId, audioTitle, audioAuthor, audioAlbum) and isDuetEnabled — the audio block is the cheapest hook into trending-sound analysis. Content from the last 4 days is excluded from metric calculations. Pinned posts >90 days old are excluded if they would be the oldest item. Costs 2 credits.

Search individual TikTok content (videos) across CreatorDB's index. Different from search_tiktok (which searches CREATORS) — this returns individual posts. Response includes contentList[] with contentId, description, thumbnail, url, publishTime (Unix-ms), lengthSec, plays/likes/comments/shares/engagementRate, hashtags, audioTitle, audioAuthor, and a nested creator block. NO contentType field. NO isSponsored / partneredBrands — TikTok brand-attribution is not implemented (native isAd flag exists on get_tiktok_content_detail only). Content-level filterable: description, hashtag, publishTime (integer "days ago"), plays, diggs (request name) / likes (response name), comments, shares, engagement, lengthSec, performanceDiggs, performanceEngagement. Creator-level filters also supported. Engagement formula = (likes+comments+shares)/followers. Costs 2 credits per page.

List the full TikTok NICHE taxonomy used by CreatorDB — every available niche with channelCount per niche (the response is large: ~10K+ entries). NICHES are granular subcategories (e.g. "Capcut/All", "Dance/All"). To see which niches a specific creator is classified under, use get_tiktok_profile and read the niches field. Per-platform: TT/YT/IG each have their own niche taxonomy — they are not interchangeable. TikTok does NOT have a "topics" taxonomy (that is YouTube-only) and does NOT have a per-brand sponsorship endpoint. Takes no parameters. Costs 1 credit.

Search the CreatorDB brand index using structured filters. Returns lean brand records (brandId, name, logo, industries, country). Costs 2 credits per page. Sponsor data covers YouTube and Instagram only — TikTok is not indexed for brands.

Paginated directory of every brand indexed in CreatorDB (10K+ brands). Returns brandId, name, logo, industries, country, sponsoringPlatforms (TitleCase strings: "YouTube", "Instagram"), totalSponsoredContent. Use search_sponsors when you need filtering; this is for browsing the full catalog. Costs 1 credit per page.

Get a single brand's full profile: name, alias[], logo, description, companySize, keyPeople[], industries[], country, location, website, socialMedia[] (with platform-tagged URLs), competitors[], totalSponsoredContent, sponsoringPlatforms. Costs 2 credits.

List creators a brand has sponsored (inverse of get_*_sponsorship). Returns each creator with displayName, country, followers, sponsoredContent[] (URLs), topics, niches, sponsoredCount, lastSponsoredDate, avgRecentSponsoredEngagementRate (cross-brand aggregate: lifetime window on Instagram, R20 window on YouTube). EXPENSIVE: costs 25 credits per page.

Detailed per-content sponsorship performance for a brand. Returns sponsoredCreators[] each with three stats scopes (creatorTotalStats = all content, creatorAllSponsoredStats = all sponsored content lifetime, creatorSpecificSponsoredStats = for this brand only) plus estimatedCost / estimatedCreatorCPM (YouTube-only — null for Instagram) and a content[] array with per-item views7d/30d/90d/Lifetime, likes, comments, engagementRate. EXPENSIVE: costs 25 credits per page.

Aggregated audience demographics across all creators a brand has sponsored. Returns data.youtube and/or data.instagram (each may be null) with audienceLocations (top 5 countries), audienceGender (maleRatio + femaleRatio), audienceAvgAge, audienceAgeBreakdown (fixed 7 buckets: 13-17/18-24/25-34/35-44/45-54/55-64/65+). IG block is reserved but always null today — backend only aggregates YT audience. Omit platform to request both. EXPENSIVE: costs 25 credits.

Cross-platform sponsorship rollup for a brand. Returns data.summary with totalSponsoredCreators, totalSponsoredContent, and per-platform youtube + instagram sub-objects each carrying a creators block (sponsoredCreators, sponsoredContent30d, top-5 creatorLocationBreakdown, top-5 creatorLanguageBreakdown) and a performance block (estimatedTotalSpend 7d/30d/90d, estimatedCPM30d, estimatedCPE30d, views/likes/comments aggregates, growth30d deltas). Instagram spend/CPM/CPE always null today. EXPENSIVE: costs 25 credits.

Submit a brand for indexing. Returns submissionId + status ("accepted" / "processing" / "done" / "rejected") and existingBrandId if the brand was already indexed. Costs 1 credit on acceptance, 0 on duplicate (status=done) or rejection. Rate-limited to 100 submissions/day per API key (separate from the credit pool).

Get your CreatorDB API usage. Returns records: [{ date (YYYYMMDD), requestCount, totalQuotaUsed (can be fractional, e.g. NLS), endpoints (camelCase per-endpoint counts: getYoutubeProfile, searchInstagram, getNLS, etc.), platforms, quotaByPlatform }]. Free to call (0 credits). Defaults to last 7 days; pass start/end as Unix-ms strings to widen the window.