> ## Documentation Index
> Fetch the complete documentation index at: https://docs.creatordb.app/llms.txt
> Use this file to discover all available pages before exploring further.
# Field and Item Costs
> Check how much each field costs in fractional calls for supported API endpoints.
You must enable **Fractional Calls** on your API key. Otherwise, requests that include a `fields` parameter return a `400` error (`FractionalCallsNotEnabled`). Full-response calls (without `fields`) always work. Contact your account manager to enable fractional calls.
## Overview
Field and item costs can vary for each CreatorDB data endpoint that supports fractional calls. You can make a request combining multiple fields or items in a fractional call and are **never charged more than the full-bundle price**. For example:
```bash Content-detail (3) theme={null}
curl -X POST "https://apiv3.creatordb.app/youtube/search" \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'api-key: YOUR_API_KEY' \
-d '{
"filters": [
{ "filterName": "totalSubscribers", "op": ">", "value": 10000000 }
],
"fields": {
"content-detail": {}
},
"pageSize": 3,
"offset": 0
}'
```
This request enriches each of the 3 search results with the full `content-detail` bundle.
* **Base search cost:** 1 credit (up to 10 filters)
* **Enrichment per result:** `content-detail` full bundle = 3 credits (capped at the endpoint base price)
* **Enrichment total:** 3 credits × 3 results = 9 credits
**Total: 1 + 9 = 10 credits**
For details, see the following topics:
* [Fractional Calls](/api-v3/fractional-calls)
* [API Credit Usage](/api-v3/api-credit-usage) (Full-bundle price)
For the relevant API endpoint field costs, please see the corresponding table in the sections below.
The `{platform}/performance-history` endpoints (e.g. `youtube/performance-history`, `instagram/performance-history`, `tiktok/performance-history`) does not accept `fields` and is priced by time range. For details, see [Performance History Pricing](/api-v3/api-credit-usage#performance-history-pricing).
## YouTube
The following sections are the field costs for the different CreatorDB API endpoints that support YouTube.
### `youtube/search`
Search is billed at the base filter rate (1 credit per 10 filters) plus enrichment. Each key below adds that endpoint's cost **per result returned**. You cannot subset search's own return fields. Enrichment cost scales with `pageSize`.
| Key
| Cost per result | Description |
| --------------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `profile` | 2 | Profile fields to add to each search result. |
| `performance` | 2 | Performance blocks to add to each search result. |
| `audience` | 10 | Audience fields to add to each search result. |
| `contact` | 15 | Contact fields to add to each search result. |
| `content-detail` | 3 | Per-item counts, e.g. `{ "recentVideos": 3 }`. `0`, `null`, or omission returns zero items for that field. Valid field names vary by platform. For details, see [Fractional Calls](/api-v3/fractional-calls). |
| `performance-history` | 3–5 (range-bucket) | Date range bucket, e.g. `{ "pastDayRange": 90 }`. For pricing details, see [Performance history pricing](/api-v3/api-credit-usage#performance-history-pricing). |
| `sponsorship` | 5 | Per-brand counts, e.g. `{ "sponsorList": 5 }`. `0`, `null`, or omission returns zero brands. Available for YouTube and Instagram search only. For details, see [Fractional Calls](/api-v3/fractional-calls). |
### `youtube/profile`
| Field
| Cost | Description |
| ----------------------------------------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `channelId` | 0.1 | Unique channel ID. |
| `uniqueId` | 0.1 | Channel handle. |
| `displayName` | 0.1 | Channel display name. |
| `categoryBreakdown` | 0.1 | Distribution of the creator's content by category. |
| `avatarUrl` | 0.1 | Channel profile picture URL. |
| `bio` | 0.1 | The channel biography. |
| `isVerified` | 0.1 | `true` if the account is verified by YouTube. |
| `hasSponsors` | 0.1 | `true` if there is sponsored content. |
| `hasMemberOnlyContents` | 0.1 | `true` if there is member-only content. |
| `country` | 0.1 | The country represented in ISO 3166-1 alpha-3 format. For the country code list, see [here](/api-v2/country-code). |
| `mainLanguage` | 0.1 | The primary language used in contents, represented in ISO 639-3 format. For language code list, see [here](/api-v3/language-code). |
| `languages` | 0.2 | All languages used in contents, represented in ISO 639-3 format. For language code list, see [here](/api-v3/language-code). |
| `totalContents` | 0.1 | Total number of videos and shorts. |
| `totalSubscribers` | 0.1 | Total number of subscribers. |
| `subscriberGrowth` | 0.2 | Subscriber growth metrics over 7, 30, and 90-day periods (g7, g30, g90). |
| `hashtags` | 0.1 | Hashtags used in content and related statistics. |
| `topics` | 0.1 | Content subcategories generated by CreatorDB's AI model that classifies creators into about 400 dynamic themes based on their content. |
| `niches` | 0.1 | Granular subcategories of content topics identified by CreatorDB's AI model, which analyzes and groups keywords, hashtags, and tags used by creators. |
| `otherLinks` | 0.1 | Linked websites. |
| `lastPublishTime` | 0.1 | Time the last content was uploaded, represented as a Unix timestamp in milliseconds. |
| `relatedCreators` | 0.1 | Creators recommended by YouTube, returned as channel IDs. |
| `lastDbUpdateTime` | 0 | Last update time of the creator profile and statistics in the CreatorDB database, represented as a Unix timestamp in milliseconds. |
| **Full bundle** | **2** | **Triggered by `[]` or omitting the endpoint key. Capped at base price (no-gotcha cap; sum of fields \~2).** |
### `youtube/contact`
| Field
| Cost | Description |
| ----------------------------------------- | ---- | ------------------------------------------------- |
| `emails` | 15 | Associated email addresses. Empty if unavailable. |
The `emails` field charges the full-bundle price.
### `youtube/performance`
| Field
| Cost | Description |
| ----------------------------------------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `contentCountByDays` | 0.2 | Number of videos published over 7, 30, and 90-day intervals. |
| `ranking` | 0.4 | Percentile rankings for various performance metrics, benchmarked at the global, country, or language level. A value of `1.0` indicates top 1%, while `0.5` represents the median. |
| `videosPerformanceRecent` | 1 | Performance metrics of the creator's last 20 YouTube videos. |
| `shortsPerformanceRecent` | 1 | Performance metrics of the creator's last 20 YouTube shorts. |
| `videosPerformanceAll` | 1 | Creator's video performance metrics for the last 800 YouTube videos. |
| `shortsPerformanceAll` | 1 | Performance metrics for the last 800 YouTube shorts. |
| `recentVideosGrowth` | 0.2 | Growth metrics for recent YouTube videos across 7, 30, and 90-day periods. |
| `recentShortsGrowth` | 0.2 | Growth metrics for recent shorts across 7, 30, and 90-day periods. |
| `videoPrice` | 0.5 | Estimated pricing analytics for videos. Calculated as $CPM + per-video rate range$. |
| `shortsPrice` | 0.5 | Estimated pricing analytics for shorts. |
| **Full bundle** | **2** | **Triggered by `[]` or omitting the endpoint key. Capped at base price.** |
### `youtube/audience`
| Field
| Cost | Description |
| ----------------------------------------- | ------ | ------------------------------------------------------------------------- |
| `audienceLocations` | 4 | Country locations of the audience, sorted by descending share. |
| `audienceGender` | 4 | Gender distribution of the audience. |
| `audienceAvgAge` | 2 | Average age of the audience, rounded to an integer. |
| `audienceAgeBreakdown` | 4 | Distribution of the audience by age range. |
| **Full bundle** | **10** | **Triggered by `[]` or omitting the endpoint key. Capped at base price.** |
### `youtube/content-detail`
The content-detail endpoint comprises two array fields. Each array item is billed as a single unit. Sub-fields are not individually selectable or separately priced. For details, see [Get Content Details](/api-reference/youtube/get-content-details).
| Field
| Cost | Description |
| ----------------------------------------- | ------------- | ------------------------------------------------------------------------- |
| `recentVideos` | 0.1 per video | Number of recent long-form videos to return. |
| `recentShorts` | 0.1 per short | Number of recent shorts to return. |
| **Full bundle** | **3** | **Triggered by `[]` or omitting the endpoint key. Capped at base price.** |
### `youtube/sponsorship`
The sponsorship endpoint exposes one array field: `sponsorList`. Each array entry represents a single sponsoring brand and contains all the brand metadata, sponsored videos, and per-brand performance metrics as a unit. Sub-fields are not individually selectable or separately priced. For details, see the [Get Sponsorship Information](/api-reference/youtube/get-sponsorship-information).
| Field
| Cost | Description |
| ----------------------------------------- | ------------- | ------------------------------------------------------------------------- |
| `sponsorList` | 0.5 per brand | Number of sponsoring brands to return. |
| **Full bundle** | **5** | **Triggered by `[]` or omitting the endpoint key. Capped at base price.** |
## Instagram
The following sections are the field costs for the different CreatorDB API endpoints that support Instagram.
### `instagram/search`
Search is billed at the base filter rate (1 credit per 10 filters) plus enrichment. Each key below adds that endpoint's cost **per result returned**. You cannot subset search's own return fields. Enrichment cost scales with `pageSize`.
| Key
| Cost per result | Description |
| --------------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `profile` | 1.5 | Profile fields to add to each search result. |
| `performance` | 2 | Performance blocks to add to each search result. |
| `performance-history` | 3–5 (range-bucket) | Date range bucket, e.g. `{ "pastDayRange": 90 }`. For pricing details, see [Performance history pricing](/api-v3/api-credit-usage#performance-history-pricing). |
| `audience` | 10 | Audience fields to add to each search result. |
| `contact` | 15 | Contact fields to add to each search result. |
| `content-detail` | 3 (max) | Per-item counts, e.g. `{ "recentVideos": 3 }`. `0`, `null`, or omission returns zero items for that field. Valid field names vary by platform. For details, see [Fractional Calls](/api-v3/fractional-calls). |
| `sponsorship` | 5 | Per-brand counts, e.g. `{ "sponsorList": 5 }`. `0`, `null`, or omission returns zero brands. Available for YouTube and Instagram search only. For details, see [Fractional Calls](/api-v3/fractional-calls). |
### `instagram/profile`
| Field
| Cost | Description |
| ----------------------------------------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `uniqueId` | 0.1 | The Instagram handle. |
| `displayName` | 0.1 | The Instagram account name. |
| `category` | 0.1 | The professional account category. |
| `avatarUrl` | 0.1 | The profile picture URL. |
| `bio` | 0.1 | The profile biography. |
| `isBusinessAccount` | 0.1 | `true` if it is a business account. |
| `isPrivateAccount` | 0.1 | `true` if it is a private account. |
| `isVerified` | 0.1 | `true` if it is verified by Instagram. |
| `hasSponsors` | 0.1 | `true` if there is sponsored content. |
| `country` | 0.1 | The country in **ISO 3166-1 alpha-3** format. For the country code list, see [here](/api-v2/country-code). |
| `mainLanguage` | 0.1 | The primary language used in posts, represented in **ISO 639-3** format. For the language code list, see [here](/api-v3/language-code). |
| `secondLanguage` | 0.1 | The secondary language used in posts, represented in **ISO 639-3** format. For language code list, see [here](/api-v3/language-code). |
| `languages` | 0.2 | All languages used in posts, represented in **ISO 639-3** format. For the language code list, see [here](/api-v3/language-code). |
| `totalContents` | 0.1 | Total number of image posts and reels. |
| `totalFollowers` | 0.1 | Total number of followers. |
| `totalFollowing` | 0.1 | Total number of accounts followed. |
| `subscriberGrowth` | 0.2 | Follower growth metrics over 7, 30, and 90-day periods (g7, g30, g90). |
| `hashtags` | 0.1 | Hashtags in Instagram content and usage statistics. Maximum: 100 |
| `niches` | 0.1 | Granular subcategories of content topics identified by CreatorDB's AI model, which analyzes and groups keywords, hashtags, and tags used by creators. |
| `otherLinks` | 0.1 | Linked websites. |
| `lastPublishTime` | 0.1 | Time the last content was uploaded, represented as a Unix timestamp in milliseconds. |
| `relatedCreators` | 0.1 | Creators recommended by Instagram. |
| `lastDbUpdateTime` | 0 | Last update time of the creator profile and statistics in the CreatorDB database, represented as a Unix timestamp in milliseconds. |
| **Full bundle** | **2** | **Triggered by `[]` or omitting the endpoint key. Capped at base price.** |
### `instagram/contact`
| Field
| Cost | Description |
| ----------------------------------------- | ---- | ------------------------------------------------- |
| `emails` | 15 | Associated email addresses. Empty if unavailable. |
The `emails` field charges the full-bundle price.
### `instagram/performance`
| Field
| Cost | Description |
| ----------------------------------------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `contentCountByDays` | 0.2 | Published Instagram posts over 7, 30, and 90-day intervals. |
| `ranking` | 0.4 | Percentile rankings for various performance metrics, benchmarked at the global, country, or language level. A value of `1.0` indicates top 1%, while `0.5` represents the median. |
| `recentImagesGrowth` | 0.2 | Growth metrics for recent Instagram image posts across 7, 30, and 90-day periods (g7, g30, g90). |
| `recentReelsGrowth` | 0.2 | Growth metrics for recent Instagram reels across 7, 30, and 90-day periods (g7, g30, g90). |
| `imagesPerformanceRecent` | 1 | Performance metrics of the creator's recent Instagram image posts. |
| `reelsPerformanceRecent` | 1 | Performance metrics of the creator's recent Instagram reels. |
| **Full bundle** | **2** | **Triggered by `[]` or omitting the endpoint key. Capped at base price.** |
### `instagram/audience`
| Field
| Cost | Description |
| ----------------------------------------- | ------ | ------------------------------------------------------------------------- |
| `audienceLocations` | 4 | Country locations of the audience, sorted by descending share. |
| `audienceGender` | 4 | Gender distribution of the audience. |
| `audienceAvgAge` | 2 | Average age of the audience, rounded to an integer. |
| `audienceAgeBreakdown` | 4 | Distribution of the audience by age range. |
| **Full bundle** | **10** | **Triggered by `[]` or omitting the endpoint key. Capped at base price.** |
### `instagram/content-detail`
The content-detail endpoint comprises two array fields. Each array item is billed as a single unit. Sub-fields are not individually selectable or separately priced. For details, see the [Get Content Details](/api-reference/instagram/get-content-details).
| Field
| Cost | Description |
| ----------------------------------------- | ------------- | ------------------------------------------------------------------------- |
| `recentImages` | 0.1 per image | Number of recent image posts to return. |
| `recentReels` | 0.1 per reel | Number of recent reels to return. |
| **Full bundle** | **3** | **Triggered by `[]` or omitting the endpoint key. Capped at base price.** |
### `instagram/sponsorship`
The sponsorship endpoint exposes one array field: `sponsorList`. Each array entry represents a single sponsoring brand and contains all the brand metadata, sponsored videos, and per-brand performance metrics as a unit. Sub-fields are not individually selectable or separately priced. For details, see the [Get Sponsorship Information](/api-reference/instagram/get-sponsorship-information).
| Field
| Cost | Description |
| ----------------------------------------- | ------------- | ------------------------------------------------------------------------- |
| `sponsorList` | 0.5 per brand | Number of sponsoring brands to return. |
| **Full bundle** | **5** | **Triggered by `[]` or omitting the endpoint key. Capped at base price.** |
## TikTok
The following sections are the field costs for the different CreatorDB API endpoints that support TikTok.
### `tiktok/search`
Search is billed at the base filter rate (1 credit per 10 filters) plus enrichment. Each key below adds that endpoint's cost **per result returned**. You cannot subset search's own return fields. Enrichment cost scales with `pageSize`.
| Key
| Cost per result | Description |
| --------------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `profile` | 1.5 | Profile fields to add to each search result. |
| `performance` | 1.5 | Performance blocks to add to each search result. |
| `performance-history` | 3–5 (range-bucket) | Date range bucket, e.g. `{ "pastDayRange": 90 }`. For pricing details, see [Performance history pricing](/api-v3/api-credit-usage#performance-history-pricing). |
| `audience` | 10 | Audience fields to add to each search result. |
| `contact` | 15 | Contact fields to add to each search result. |
| `content-detail` | 3 (max) | Per-item counts, e.g. `{ "recentVideos": 3 }`. `0`, `null`, or omission returns zero items for that field. Valid field names vary by platform. For details, see [Fractional Calls](/api-v3/fractional-calls). |
### `tiktok/profile`
| Field
| Cost | Description |
| ----------------------------------------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `uniqueId` | 0.1 | The TikTok handle. |
| `displayName` | 0.1 | The TikTok account name. |
| `category` | 0.1 | Professional account category. |
| `avatarUrl` | 0.1 | The profile picture URL. |
| `bio` | 0.1 | The profile biography. |
| `isBusinessAccount` | 0.1 | `true` if it is a business account. |
| `isPrivateAccount` | 0.1 | `true` if it is a private account. |
| `isVerified` | 0.1 | `true` if it is verified by TikTok. |
| `hasSponsors` | 0.1 | `true` if there is sponsored content. |
| `country` | 0.1 | The country in **ISO 3166-1 alpha-3** format. For the country code list, see [here](/api-v2/country-code). |
| `mainLanguage` | 0.1 | The primary language used in posts, represented in **ISO 639-3** format. For the language code list, see [here](/api-v3/language-code). |
| `languages` | 0.2 | All languages used in posts, represented in **ISO 639-3** format. For the language code list, see [here](/api-v3/language-code). |
| `secondLanguage` | 0.1 | The secondary language used in posts, represented in **ISO 639-3** format. For language code list, see [here](/api-v3/language-code). |
| `totalContents` | 0.1 | Total number of videos. |
| `totalFollowing` | 0.1 | Total number of accounts followed. |
| `totalFollowers` | 0.1 | Total number of followers. |
| `subscriberGrowth` | 0.2 | Follower growth metrics over 7, 30, and 90-day periods (g7, g30, g90). |
| `hashtags` | 0.1 | Hashtags used in TikTok posts and usage statistics. |
| `niches` | 0.1 | Granular subcategories of content topics identified by CreatorDB's AI model, which analyzes and groups keywords, hashtags, and tags used by creators. |
| `otherLinks` | 0.1 | Linked websites. |
| `lastPublishTime` | 0.1 | Time the last content was uploaded, represented as a Unix timestamp in milliseconds. |
| `lastDbUpdateTime` | 0 | Last update time of the creator profile and statistics in the CreatorDB database, represented as a Unix timestamp in milliseconds. |
| **Full bundle** | **2** | **Triggered by `[]` or omitting the endpoint key. Capped at base price.** |
### `tiktok/contact`
| Field
| Cost | Description |
| ----------------------------------------- | ---- | ------------------------------------------------- |
| `emails` | 15 | Associated email addresses. Empty if unavailable. |
The `emails` field charges the full-bundle price.
### `tiktok/performance`
| Field
| Cost | Description |
| ----------------------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `contentCountByDays` | 0.2 | Published TikTok content over 7, 30, and 90-day intervals. |
| `ranking` | 0.6 | Percentile rankings for various performance metrics, benchmarked at the global, country, or language level. A value of `1.0` indicates top 1%, while `0.5` represents the median. |
| `recentVideosGrowth` | 0.2 | Growth metrics for recent videos across 7, 30, and 90-day periods (g7, g30, g90). |
| `videosPerformanceRecent` | 1 | Performance metrics of the creator's recent TikTok videos. |
| **Full bundle** | **1.5** | **Triggered by `[]` or omitting the endpoint key. Capped at base price.** |
### `tiktok/audience`
| Field
| Cost | Description |
| ----------------------------------------- | ------ | ------------------------------------------------------------------------- |
| `audienceLocations` | 4 | Country locations of the audience, sorted by descending share. |
| `audienceGender` | 4 | Gender distribution of the audience. |
| `audienceAvgAge` | 2 | Average age of the audience, rounded to an integer. |
| `audienceAgeBreakdown` | 4 | Distribution of the audience by age range. |
| **Full bundle** | **10** | **Triggered by `[]` or omitting the endpoint key. Capped at base price.** |
### `tiktok/content-detail`
The content-detail endpoint comprises one array field. Each array item is billed as a single unit. Sub-fields are not individually selectable or separately priced. For details, see [Get Content Details](/api-reference/tiktok/get-content-details).
| Field
| Cost | Description |
| ----------------------------------------- | ------------- | ------------------------------------------------------------------------- |
| `recentVideos` | 0.1 per video | Number of recent videos to return. |
| **Full bundle** | **3** | **Triggered by `[]` or omitting the endpoint key. Capped at base price.** |
The field `recentVideos` is a single content array that covers all available TikTok content format, it does not distinguish between images, reels, shorts, or videos.