Skip to main content
​
New featuresPricingBreaking changes
V3.0

​
Added

Content search on YouTube, Instagram, and TikTokPOST /youtube/content-search, POST /instagram/content-search, and POST /tiktok/content-search search individual videos, Shorts, reels, and posts across every creator in the CreatorDB database. Filter on the content itself, such as caption text, hashtags, views, and sponsorship, and on the creator who posted it, such as followers, country, and audience. For details, see Using Content Search.
  • Time window: Set timeRange to search an absolute publish-date range. A search with no timeRange and no publishTime filter covers the last 30 days. Every response returns the searched window in data.timeRange.
  • Search one creator’s content: Filter on channelId (YouTube) or uniqueId (Instagram and TikTok).
  • Search for any of several phrases: in with isFuzzySearch: true matches content that contains any of up to 10 values.

​
Changed

Content search pricingEach content search costs 1 to 97 credits, depending on the length of the time window, whether the request has a description filter, whether it has a 100K+ followers floor, and on YouTube and Instagram the content type. The price is known from the request before you send it. For the price tables, see Content search credit cost.TikTok content search
  • A TikTok content search with no timeRange and no publishTime filter now covers the last 30 days. To search further back, set timeRange.
  • TikTok content search now follows the content search price grid.
  • isFuzzySearch is accepted only on description, hashtag, creatorDisplayName, and creatorBio. On other filters, the request returns 400 VALIDATION_ERROR.
​
New featuresFixes
V3.0

​
Added

YouTube isPodcast/youtube/profile now returns isPodcast: true when CreatorDB’s AI classifier labels the channel as a podcast channel, false when it doesn’t, and null when the channel hasn’t been classified. Requesting it in fields costs 0.1 credits, and the full profile price is unchanged. You can also filter /youtube/search on isPodcast with =. Channels that haven’t been classified match neither true nor false. For per-field costs, see Field and Item Costs.

​
Fixed

Search results follow sortBy within each pageEach page of YouTube, Instagram, TikTok, creator and sponsor search, and of TikTok content search, now comes back in sortBy order. Previously, values that changed since the last daily index update could put a page out of order. Which results land on which page is unchanged.sortBy: languages returns 400On YouTube, Instagram and TikTok search, languages is no longer a sort field. Requests that sort by it now return 400 VALIDATION_ERROR instead of a server error. languages still works as a filter, and mainLanguage is still sortable.YouTube topics and nichesYouTube topics and niches on /youtube/profile and /sponsor/creators, and the YouTube topics and niches search filters, now come from the same actively maintained source as Instagram and TikTok. Some channels’ topics and niches change as a result.
​
PricingNew featuresBreaking changes
V3.0

​
Changed

/youtube/performance full-bundle price is now 3 creditsCalling /youtube/performance without fields now costs 3 credits, up from 2. The four content-performance blocks (videosPerformanceRecent, shortsPerformanceRecent, videosPerformanceAll and shortsPerformanceAll) now cost 0.5 credits each, down from 1. Requests for one or two of these blocks cost less than before. Requests whose field costs add up to more than 2 credits now cost more, up to 3. Instagram and TikTok /performance pricing is unchanged. For per-field costs, see Field and Item Costs.Empty results are no longer charged
Calling an endpoint that returns false is still treated as real content and billed because CreatorDB’s model currently cannot distinguish a real false from a missing one. For example, if you make an API request about a creator and it returns a value of 0 for reelslastPublishTime, it costs nothing. But for the same creator, if the field isPrivateAccount returns false, it costs 0.1 credits.
When specified fields in the following endpoints return no data (e.g., null, undefined, or empty string []), the field now costs 0 credits:Endpoints on YouTube, Instagram, and TikTok
  • /{platform}/profile
  • /{platform}/performance
  • /{platform}/performance-history
  • /{platform}/audience
  • /{platform}/contact
  • /{platform}/content-detail
  • /{platform}/sponsorship
YouTube-specific endpoint
  • /youtube/subtitles/meta
Sponsor endpoints
  • /sponsor/submit
  • /sponsor/information
  • /sponsor/list
  • /sponsor/creators
  • /sponsor/performance
  • /sponsor/audience
  • /sponsor/summary
For example, a /{platform}/contact call that finds no email previously cost 15 credits and now costs nothing. Search endpoints that return no matches are still charged credits because the search still runs.Endpoints that are still charged for empty responsesGeneral operation endpoints
  • /usage
  • /nls
Endpoints on YouTube, Instagram, and TikTok
  • /{platform}/search
  • /{platform}/content-search
  • /{platform}/creator-search
  • /{platform}/niches
  • /{platform}/submitCreators
YouTube-specific endpoints
  • /youtube/topics
  • /youtube/subtitles/download
false is billedfalse counts as data and is billed, because CreatorDB can’t yet tell a real false from a missing value. For example, if isPrivateAccount returns false, you’re charged 0.1 credits for it. If reelsLastPublishTime returns 0, it’s free.Instagram account flags can be nullisVerified, isBusinessAccount and isPrivateAccount on /instagram/profile are now nullable. null means CreatorDB has not determined the flag for that creator. It does not mean false. If your integration types these fields as booleans, update it to accept null.Instagram lastPublishTime now includes reelslastPublishTime on /instagram/profile now returns the timestamp of the creator’s most recent image post or reel, whichever is later. It previously reflected image posts only. For creators whose latest post is a reel, the value is now later than before.totalViews filter and sort on /youtube/search now use lifetime channel viewsThe totalViews filter and sort now use the channel’s lifetime view count, the figure YouTube shows on the channel’s About panel. Previously, they used a partial count that was unavailable for most channels, so those channels never matched a totalViews filter. As a result, many more channels now match, and results sorted by totalViews may appear in a different order. If you set totalViews thresholds based on the old values, review them.The new totalViews field on /youtube/profile returns this same lifetime count.

​
Added

New /{platform}/performance blocksEach new block can be requested individually in a fractional call. For per-field costs, see Field and Item Costs.
  • 30-day and 90-day windows (all platforms): Minimum, maximum and average views for content published between 4 and 30 (or 90) days ago. Content from the most recent 4 days is excluded because its metrics are still changing.
    • YouTube: videosPerformance30d, videosPerformance90d, shortsPerformance30d, shortsPerformance90d
    • Instagram: reelsPerformance30d, reelsPerformance90d
    • TikTok: videosPerformance30d, videosPerformance90d
  • contentsPerformanceRecent (YouTube and Instagram): Combined metrics across all of a creator’s recent content (videos and shorts on YouTube, image posts and reels on Instagram).
  • rankingByTopic (YouTube): Percentile rankings within each AI-generated topic the creator is classified into. It complements ranking, which ranks creators globally and by country and language.
  • imagesCountByDays and reelsCountByDays (Instagram): Content counts split by type over 30-day and 90-day windows.
New fields on /{platform}/profile
  • hasEmail (all platforms): A boolean that indicates whether /{platform}/contact returns at least one email for the creator. Use it to skip /{platform}/contact calls for creators with no email on file. Requesting hasEmail in fields costs 0.1 credits.
  • isAgencyRepresented (all platforms): A boolean that indicates whether the creator is represented by a talent agency. false also covers creators CreatorDB has no agency record for.
  • joinedDate (YouTube and TikTok): When the account was created on the platform, represented as a Unix timestamp in milliseconds.
  • totalViews (YouTube): Lifetime channel views, the figure YouTube shows on the channel’s About panel.
  • imageLastPublishTime and reelsLastPublishTime (Instagram): When the creator last published an image post and a reel, represented as Unix timestamps in milliseconds.
  • relatedCreators (TikTok): Accounts TikTok lists as related to the creator, returned as handles. CreatorDB returns them unchanged, in the order TikTok provides them. YouTube and Instagram profiles already return this field.
​
API keyNew features
V3.0

​
Changed

Authentication process has been updated.You can now create an API 3.0 key through the CreatorDB app API dashboard. The API key is required for all API requests and is used to authenticate your requests. For detailed instructions on how to create and use an API key, see Authentication.
Last modified on November 6, 2026