> ## 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.
# Get Content Details
> Retrieve the most recent YouTube videos and shorts of a specified creator, including publish time, video or short description, and engagement metrics.
Optionally pass `fields` in the request body to limit how many items each content-detail array returns. Each item returned is billed individually, capped at the full-bundle price. Fractional calls must be enabled on your API key. Otherwise, a request that includes `fields` returns a `400` error (`FractionalCallsNotEnabled`). Per-item costs are not published yet. For how fractional calls work, see [Fractional Calls](/api-v3/fractional-calls).
## OpenAPI
````yaml /api-v3/api-v3.yaml post /youtube/content-detail
openapi: 3.1.0
info:
version: 1.0.0
title: CreatorDB Headless API V3
description: '# CreatorDB Headless API V3'
contact:
name: CreatorDB
url: https://www.creatordb.app
email: support@creatordb.app
license:
url: http://www.apache.org/licenses/LICENSE-2.0.html
name: Apache 2.0
servers:
- url: https://apiv3.creatordb.app
description: Production Environment (CreatorDB Headless API V3)
security:
- ApiKeyAuth: []
tags:
- name: Brand
description: Brand analysis endpoints including sponsor search and brand reports.
- name: Facebook
description: Facebook creator data endpoints with metrics and search capabilities.
- name: General Operations
description: >-
General-purpose endpoints such as API status, content retrieval, and
cross-platform operations.
- name: Instagram
description: >-
Instagram creator data endpoints with metrics and advanced search
capabilities.
- name: Niches
description: >-
Niche-related endpoints for content category analysis and related
searches.
- name: Threads
description: Threads creator data endpoints with basic metrics and historical data.
- name: TikTok
description: >-
TikTok creator data endpoints with metrics and advanced search
functionality.
- name: Topic
description: Topic-based analysis and reporting endpoints for content categorization.
- name: YouTube
description: >-
YouTube creator data endpoints including basic metrics, historical data,
and detailed analytics.
paths:
/youtube/content-detail:
post:
tags:
- YouTube
summary: Get Content Details
description: >-
Retrieve the most recent YouTube videos and shorts of a specified
creator, including publish time, video or short description, and
engagement metrics.
Optionally pass `fields` in the request
body to limit how many items each content-detail array returns. Each
item returned is billed individually, capped at the full-bundle price.
Fractional calls must be enabled on your API key. Otherwise, a request
that includes `fields` returns a `400` error
(`FractionalCallsNotEnabled`). Per-item costs are not published yet. For
how fractional calls work, see [Fractional
Calls](/api-v3/fractional-calls).
operationId: getYoutubeContentDetail
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- channelId
properties:
channelId:
type: string
description: Unique channel ID.
pattern: ^UC[a-zA-Z0-9_-]{22}$
minLength: 1
maxLength: 50
examples:
- UCBR8-60-B28hp2BmDPdntcQ
fields:
type: object
description: >-
Map each content array to the number of items to return.
Omit or pass an empty object to return all items at the
full-bundle price. Per-item costs are not published yet.
properties:
recentVideos:
type: integer
description: Number of recent videos to return.
examples:
- 5
recentShorts:
type: integer
description: Number of recent shorts to return.
examples:
- 5
responses:
'200':
description: YouTube content details returned successfully.
content:
application/json:
schema:
type: object
properties:
data:
type: object
description: Retrieved YouTube content details of a specified creator.
properties:
recentVideos:
type: array
description: Data of recent YouTube videos.
items:
type: object
description: Recent YouTube video information.
properties:
publishTime:
type: integer
description: >-
Publish time, represented as a Unix timestamp in
milliseconds.
examples:
- 1755273600000
contentId:
type: string
description: >-
The unique identifier. Represented as follows:
`https://www.youtube.com/watch?v={contentId}`
examples:
- FbCF_H4ZD64
title:
type: string
description: The video title.
examples:
- I hosted an ADMIN ABUSE on GROW A GARDEN
description:
type: string
description: >-
The video description, including emojis,
mentions, URLs, and line breaks.
examples:
- >-
Thanks @JandelTheGuy play grow a garden here
support a small developer like Jandel. Today I
hosted an admin abuse to 20 million people
length:
type: integer
description: Video length in seconds.
examples:
- 873
isSponsored:
type: boolean
description: '`true` if sponsored.'
examples:
- true
isMemberOnly:
type: boolean
description: '`true` if member-only.'
examples:
- false
likes:
type: integer
description: Number of likes.
examples:
- 153000
comments:
type: integer
description: Number of comments.
examples:
- 15182
views:
type: integer
description: Number of views.
examples:
- 5009695
engagementRate:
type: number
description: >-
Engagement rate, rounded to 4th decimal place.
*Engagement Rate = (Likes + Comments
+ Views) / Subscribers*
examples:
- 0.0336
hashtags:
type: array
description: Keywords in the video description.
examples:
- - '#VLOG'
items:
type: string
required:
- publishTime
- contentId
- title
- description
- length
- isSponsored
- isMemberOnly
- likes
- comments
- views
- engagementRate
- hashtags
recentShorts:
type: array
description: Data of recent YouTube shorts.
items:
type: object
description: Recent YouTube short information.
properties:
publishTime:
type: integer
description: >-
Publish time, represented as a Unix timestamp in
milliseconds.
examples:
- 1754928000000
contentId:
type: string
description: >-
The unique identifier. Represented as follows:
`https://www.youtube.com/shorts/{contentId}`
examples:
- 6tlVsknqy9M
title:
type: string
description: The shorts title.
examples:
- >-
Customized skin care clinics available in
Japan #cosmeticmedicine
description:
type: string
description: >-
The shorts description, including emojis,
mentions, URLs, and line breaks.
examples:
- >-
Recommended for those looking for skin care in
Tokyo. Shimokitazawa Cosmetic Dermatology
Clinic @oneup_clinic
length:
type: integer
description: Shorts length in seconds.
examples:
- 60
likes:
type: integer
description: Number of likes.
examples:
- 10000
comments:
type: integer
description: Number of comments.
examples:
- 100
views:
type: integer
description: Number of views.
examples:
- 15000
engagementRate:
type: number
description: >-
Engagement rate, rounded to 4th decimal place
*Engagement Rate = (Likes + Comments
+ Views) / Subscribers*
examples:
- 0.0517
hashtags:
type: array
description: Keywords in the shorts description.
examples:
- - '#cosmeticmedicine'
items:
type: string
required:
- publishTime
- contentId
- title
- description
- length
- likes
- comments
- views
- engagementRate
- hashtags
required:
- recentVideos
- recentShorts
creditsUsed:
type: integer
description: Number of API credits consumed by this request.
examples:
- 1
creditsAvailable:
type: integer
description: Number of API credits remaining.
examples:
- -1
traceId:
type: string
description: Unique trace ID for each request.
examples:
- f8e4a3b2c1d0e9f8a7b6c5d4e3f2a1b0
timestamp:
type: integer
description: >-
Time the response was generated, represented as a Unix
timestamp in milliseconds.
examples:
- 1750732453635
errorCode:
type: string
description: >-
Error code returned if the request fails. Empty if the
request is successful.
examples:
- ''
errorDescription:
type: string
description: >-
Description of the error. Empty if the request is
successful.
examples:
- ''
success:
type: boolean
description: '`true` if the request is successful.'
examples:
- true
required:
- data
- traceId
- timestamp
- errorCode
- errorDescription
- success
- creditsUsed
- creditsAvailable
examples:
default:
value:
data:
recentVideos:
- publishTime: 1767816009000
contentId: QJI0an6irrA
title: 30 Celebrities Fight For $1,000,000!
description: ''
length: 2518
isSponsored: false
isMemberOnly: false
likes: 955450
comments: 49482
views: 26424459
engagementRate: 0.03803037178547345
hashtags: []
- publishTime: 1767793392562
contentId: mktYW177p6U
title: Guess the Animal
description: ''
length: 0
isSponsored: false
isMemberOnly: false
likes: 1800000
comments: 9252
views: 99117362
engagementRate: 0.01825363350570206
hashtags: []
- publishTime: 1766840991701
contentId: 7aE4EhHXzlA
title: I Paid Everyone Stuck in Traffic
description: ''
length: 27
isSponsored: false
isMemberOnly: false
likes: 1700000
comments: 28341
views: 54959130
engagementRate: 0.031447750355582414
hashtags: []
- publishTime: 1766393469410
contentId: IJkB-oapuks
title: Giving Away $1,000,000 in Gifts To My Subscribers
description: ''
length: 19
isSponsored: false
isMemberOnly: false
likes: 3100000
comments: 162485
views: 239192519
engagementRate: 0.01363957791673242
hashtags: []
- publishTime: 1766307069104
contentId: ZFoNBxpXen4
title: Survive 30 Days Trapped In The Sky, Win $250,000
description: ''
length: 2246
isSponsored: false
isMemberOnly: false
likes: 2000000
comments: 79625
views: 102587634
engagementRate: 0.02027169278511677
hashtags: []
- publishTime: 1766220668425
contentId: RB71Z-vVvCc
title: Find The Real Celebrity, Win $10,000
description: ''
length: 33
isSponsored: false
isMemberOnly: false
likes: 2500000
comments: 10043
views: 109409690
engagementRate: 0.022941688254486416
hashtags: []
- publishTime: 1765961468685
contentId: fO5FwBcCJBY
title: Would You Date Him for $10,000?
description: ''
length: 33
isSponsored: false
isMemberOnly: false
likes: 2500000
comments: 17257
views: 90966291
engagementRate: 0.02767241548850222
hashtags: []
- publishTime: 1765614282036
contentId: U-x6KxH1kB4
title: How Many People to Pull a Plane?
description: ''
length: 27
isSponsored: false
isMemberOnly: false
likes: 656000
comments: 10727
views: 29312779
engagementRate: 0.02274526751625972
hashtags: []
- publishTime: 1765356668965
contentId: 8bMh8azh3CY
title: 100 Pilots Fight For A Private Jet
description: ''
length: 1726
isSponsored: false
isMemberOnly: false
likes: 1600000
comments: 67912
views: 113619821
engagementRate: 0.014679762609377813
hashtags: []
- publishTime: 1765298530722
contentId: SE9xF1l3ZwE
title: Hit The Target, Keep The Prize
description: ''
length: 0
isSponsored: false
isMemberOnly: false
likes: 855000
comments: 7642
views: 37441474
engagementRate: 0.02303974464253197
hashtags: []
- publishTime: 1765287793167
contentId: tAwzBYE18Us
title: How I Became MrBeef
description: ''
length: 46
isSponsored: false
isMemberOnly: false
likes: 1000000
comments: 14316
views: 26793336
engagementRate: 0.03785702534391387
hashtags: []
- publishTime: 1765114608606
contentId: LyFMbY-c_Lc
title: I Raced Noah Lyles
description: ''
length: 32
isSponsored: false
isMemberOnly: false
likes: 3100000
comments: 9310
views: 231836574
engagementRate: 0.013411645739726986
hashtags: []
- publishTime: 1765114608508
contentId: WROMyJAJmp4
title: Can I Beat An F1 Driver?
description: ''
length: 11
isSponsored: false
isMemberOnly: false
likes: 2100000
comments: 11034
views: 236595618
engagementRate: 0.008922540568777566
hashtags: []
- publishTime: 1764853792555
contentId: rF00lQ_upzg
title: Whatever You Hold Onto, You Keep
description: ''
length: 26
isSponsored: false
isMemberOnly: false
likes: 710000
comments: 9654
views: 52366887
engagementRate: 0.01374253925004173
hashtags: []
- publishTime: 1764579068743
contentId: 3RmOvxilbPM
title: 100 People Vs World’s Biggest Trap!
description: ''
length: 1843
isSponsored: true
isMemberOnly: false
likes: 1800000
comments: 81548
views: 93596233
engagementRate: 0.02010281759950745
hashtags: []
- publishTime: 1764579068623
contentId: uZY9xr-QAk0
title: Flip a Coin, I’ll Pay For Your College
description: ''
length: 34
isSponsored: false
isMemberOnly: false
likes: 3400000
comments: 17333
views: 217610072
engagementRate: 0.015703928446841375
hashtags: []
- publishTime: 1763830801000
contentId: Ah_uuTwGOYU
title: World's Fastest Man Vs Robot!
description: ''
length: 1104
isSponsored: false
isMemberOnly: false
likes: 1751534
comments: 62432
views: 87593702
engagementRate: 0.020708863292477352
hashtags: []
- publishTime: 1762695792744
contentId: yWEUL3crU_E
title: I Baked a Cake In a Race Car
description: ''
length: 38
isSponsored: false
isMemberOnly: false
likes: 742000
comments: 7399
views: 39417432
engagementRate: 0.019011867642722134
hashtags: []
recentShorts:
- publishTime: 1764090000000
contentId: AWBsoArakNY
title: Who Has The Fastest Reaction Time?
description: ''
length: 31
likes: 1390397
comments: 7470
views: 60879007
engagementRate: 0.022961396200171267
hashtags: []
- publishTime: 1763754001000
contentId: HISfrcjiNPM
title: I Surprised 50 Make-A-Wish Kids With Disneyland
description: ''
length: 29
likes: 785027
comments: 11022
views: 30168415
engagementRate: 0.026386835370701443
hashtags: []
creditsUsed: 1
creditsAvailable: -1
traceId: f6a08c6e27e6413b8d224eb809c1c3d0
timestamp: 1767923892280
errorCode: ''
errorDescription: ''
success: true
'400':
description: Validation error.
content:
application/json:
schema:
type: object
title: ValidationErrorResponse
properties:
success:
const: false
error:
type: string
message:
type: string
timestamp:
type: integer
required:
- success
- error
- message
- timestamp
examples:
missing identifier:
summary: No identifier provided
value:
success: false
error: VALIDATION_ERROR
message: 'Missing required identifier: ''channelId'' or ''uniqueId''.'
timestamp: 1770099403116
invalid channelId:
summary: Invalid channelId format
value:
success: false
error: VALIDATION_ERROR
message: >-
Invalid 'channelId' format. YouTube channel IDs must start
with 'UC' followed by 22 characters.
timestamp: 1770099403116
'429':
description: Exceeded quota or rate limit.
content:
application/json:
schema:
type: object
title: QuotaErrorResponse
properties:
success:
const: false
error:
type: string
message:
type: string
remainingPlanCredit:
type: number
required:
- success
- error
- message
- remainingPlanCredit
examples:
rate limit:
summary: Rate limit exceeded
value:
success: false
error: RATE_LIMIT_EXCEEDED
message: Too many requests. Please try again later.
quota exceeded:
summary: Credit quota exceeded
value:
success: false
error: QUOTA_EXCEEDED
message: Not enough credits to complete this request.
security:
- ApiKeyAuth: []
servers:
- url: https://apiv3.creatordb.app
description: Production Environment (CreatorDB Headless API V3)
x-codeSamples:
- lang: bash
label: cURL
source: |
curl -X POST "https://apiv3.creatordb.app/youtube/content-detail" \
-H "Content-Type: application/json" \
-H "api-key: " \
-d '{ "channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA", "fields": { "recentVideos": 5 } }'
components:
securitySchemes:
ApiKeyAuth:
type: apiKey
description: The valid CreatorDB API key for authentication.
name: api-key
in: header
````