> ## 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 TikTok videos information of a specified creator, including publish time, video 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 /tiktok/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:
/tiktok/content-detail:
post:
tags:
- TikTok
summary: Get Content Details
description: >-
Retrieve the most recent TikTok videos information of a specified
creator, including publish time, video 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: getTiktokContentDetail
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- uniqueId
properties:
uniqueId:
type: string
description: >-
TikTok account ID. Accepts `tiktok` or `@tiktok` (@ is
stripped automatically).
pattern: ^@?[a-zA-Z0-9._-]+$
minLength: 1
maxLength: 101
examples:
- tiktok
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
responses:
'200':
description: TikTok content details returned successfully.
content:
application/json:
schema:
type: object
properties:
data:
type: object
description: The TikTok content information.
properties:
recentVideos:
type: array
description: Data of recent TikTok videos.
items:
type: object
description: A recent TikTok video.
properties:
publishTime:
type: integer
description: >-
Publish time, represented as a Unix timestamp in
milliseconds.
examples:
- 1703942994000
contentId:
type: string
description: >-
The unique identifier. Represented as follows:
`https://www.tiktok.com/@{uniqueId}/video/{contentId}`
examples:
- '7318379374288424225'
description:
type: string
description: >-
The video caption, including emojis, hashtags,
and line breaks.
examples:
- >-
hope everyone is having a nice day! ✨🤍 #xmas
#christmas #xmas2023 #tryon #foryoupage #fyp
#foryou
coverImageUrl:
type: string
description: URL of the video cover image or thumbnail.
examples:
- >-
https://p19-common-sign-useastred.tiktokcdn-eu.com/...
isAd:
type: boolean
description: '`true` if it is an ad.'
examples:
- false
length:
type: integer
description: Video length in seconds.
minimum: 0
examples:
- 11
likes:
type: integer
description: Number of likes.
minimum: 0
examples:
- 239
comments:
type: integer
description: Number of comments.
minimum: 0
examples:
- 7
views:
type: integer
description: Number of views.
minimum: 0
examples:
- 1947
shares:
type: integer
description: Number of shares.
minimum: 0
examples:
- 1
engagementRate:
type: number
description: >-
Engagement rate of the video, rounded to 4th
decimal place.
- *Engagement Rate =
(Likes + Comments + Shares)/ Followers*
examples:
- 0.1269
hashtags:
type: array
description: >-
Keywords used in the video caption or
description.
examples:
- - '#xmas'
- '#tryon'
items:
type: string
audioId:
type: string
description: >-
Unique identifier of the audio track in the
content.
examples:
- '7318379374288424225'
audioTitle:
type: string
description: Title of the audio track.
examples:
- original sound - User
audioAuthor:
type: string
description: Artist of the audio track.
examples:
- User
audioAlbum:
type: string
description: Album name of the audio track.
examples:
- ''
isDuetEnabled:
type: boolean
description: '`true` if duet is enabled.'
examples:
- true
required:
- publishTime
- contentId
- description
- coverImageUrl
- isAd
- length
- likes
- comments
- views
- shares
- engagementRate
- hashtags
- audioId
- audioTitle
- audioAuthor
- audioAlbum
- isDuetEnabled
required:
- recentVideos
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: 1767651698000
contentId: '7592006153727380766'
description: What I Imagine pt. 🍟👚
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o4nOXHCqlhQOW48cFeLIAkGfRcAGC3fQQHe5UN~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=HJyXLY1LcfVh0yjzkxdO1%2FnzN7A%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 74
likes: 111100
comments: 777
views: 594300
shares: 1607
engagementRate: 0.191
hashtags: []
- publishTime: 1767646234000
contentId: '7591982673988439327'
description: That went by QUICK🥲
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o0cXAuGDvIS1LJxRCqeCjsRyBgfsJEIfAIITyI~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=A7o%2FcOJ6GEcUs0F04sV9mPpzHFo%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 10
likes: 570600
comments: 7984
views: 5800000
shares: 35600
engagementRate: 0.1059
hashtags: []
- publishTime: 1767205808000
contentId: '7590091061150731550'
description: 🫠
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oQeR3VEZqtTcUVV7EThwa9AIDfAYFEEdvBIpWI~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=rhYCgLHWXkj4yeptSRSdno%2BpCts%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 43
likes: 165000
comments: 804
views: 1100000
shares: 7812
engagementRate: 0.1578
hashtags: []
- publishTime: 1767040557000
contentId: '7589381285752163615'
description: It’s a comedy at this point
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o0iXCBqcIAq0HbECxi5i1MHx8IpIA4iR0SAChf~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=I%2FDa97SoU5L9fydfm0UyEZXFQaU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 54
likes: 58000
comments: 705
views: 472700
shares: 2803
engagementRate: 0.1301
hashtags: []
- publishTime: 1766877837000
contentId: '7588682450176347422'
description: Merry Christmas and Happy New Year ❤️
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ocfS2ljaIeDokgoE51FKfQbRIS8pQACiNMEq3A~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=kWjFd5TS2JheGxbIiZxOOMfk048%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 177
likes: 52800
comments: 731
views: 336700
shares: 168
engagementRate: 0.1595
hashtags: []
- publishTime: 1766703559000
contentId: '7587933925494820127'
description: 'No husbands were harmed ⚠️ '
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oEHmM8eDIQfqgyBlvHSAWCT3gfj4AHlkkIs2G4~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=cqoHoRz8wwK9KxKQWr%2BucZtF6qc%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 22
likes: 132500
comments: 902
views: 860300
shares: 3660
engagementRate: 0.1593
hashtags: []
- publishTime: 1766180572000
contentId: '7585687691409313055'
description: This example is NOT even an exaggeration fr
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ogtFI2L4Y7q77wLFIDGAIpiljeSAxChIP4Iee8~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=pszOQ8kCTwy4sPZ2sKr5taZpyAo%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 15
likes: 36800
comments: 160
views: 322700
shares: 199
engagementRate: 0.1152
hashtags: []
- publishTime: 1766011340000
contentId: '7584960907181165855'
description: This is a Joke btw
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/osaDB6U5M0Bwic0IOwDZtR64E4MIAviAhVNQ8~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=0JInMyUl0ByTPpanvo546iepMaI%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 20
likes: 186900
comments: 1948
views: 1400000
shares: 13400
engagementRate: 0.1445
hashtags: []
- publishTime: 1765989744000
contentId: '7584868136852196638'
description: Guy Mad Dogs Me While He 💩 Daily
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oEyIVtG6LTddhuFfJj7qACsIWReIQqDeASbJmI~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=7CHlArs3S1atAsh069Bn2%2FSMpxY%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 41
likes: 276400
comments: 817
views: 1500000
shares: 11000
engagementRate: 0.1921
hashtags: []
- publishTime: 1765920763000
contentId: '7584571831714057502'
description: I know you’ve done this…
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oEQGSgJ6ID35ICePB3oIs1MAI6qfDLxQXAeLjn~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=XrFrKqOdrYYwdluFEmhS9sLLyD4%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 31
likes: 105300
comments: 302
views: 635000
shares: 3267
engagementRate: 0.1714
hashtags: []
- publishTime: 1765659475000
contentId: '7583449579643800863'
description: 'He loves you @kellyclarkson '
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oMj01He0psE6vkJ9BuFEAMDTEPARTa0QQhfLVd~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=T13BdpxX6ivrp85XQ8Q6mDWk6uA%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 10
likes: 30800
comments: 235
views: 221900
shares: 188
engagementRate: 0.1407
hashtags: []
- publishTime: 1765387838000
contentId: '7582282861462506782'
description: Wish I could jump through the phone lol
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oIkIFiP6a8JAg9JIm3WVE0ER8BS0T5RvrtAiB~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=bunPeialx86P2TEgWKVdiGgVkdc%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 40
likes: 533200
comments: 1202
views: 2700000
shares: 72100
engagementRate: 0.2246
hashtags: []
- publishTime: 1764969961000
contentId: '7580488150188018974'
description: ''
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o8pQfmWegGtIqEZC9mrM8IAjgVAXWKpAeIxSgS~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=u%2FuEiYRexgfTUWBtEFHVQE91jyE%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 24
likes: 147400
comments: 986
views: 955400
shares: 1976
engagementRate: 0.1574
hashtags: []
- publishTime: 1764641096000
contentId: '7579075705288346911'
description: Literally just one day it happens😳
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ow4uIsym0VvEGSOi5bUHQ3ASBBIaRiXJvBmAI~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=Q%2BVYDkQaUHtsZ1p2EW3ClKHCf00%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 7
likes: 174300
comments: 413
views: 1000000
shares: 8329
engagementRate: 0.183
hashtags: []
- publishTime: 1764195938000
contentId: '7577163763112021279'
description: 'Say no more 🥧 '
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/og0ON71E75RxHQWQbBFpAfJDA8VLbEEmf3JEPh~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=6GlyzjviOBNHQFQor6wXy0Ckrt4%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 10
likes: 309300
comments: 1521
views: 1800000
shares: 5246
engagementRate: 0.1756
hashtags: []
- publishTime: 1764180860000
contentId: '7577099016840760606'
description: 'Clocked 🕰️ '
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o4aMFxDlIEeU9B6E0QpEnD3BJI1UV3YfAAXFAR~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=LL9TfWyuOW617gtIBhu9CoxwCxA%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 26
likes: 156000
comments: 518
views: 730300
shares: 6198
engagementRate: 0.2228
hashtags: []
- publishTime: 1764175776000
contentId: '7577077211962936607'
description: I’m always listening for it 😳👂🏻
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ok0ygDJeQAVEllJEvEXEpy1YXQxRAOFEpOBq6f~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=Zjepjp3eiHcpmNrRZyLY1sZVwt8%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 9
likes: 32500
comments: 182
views: 221700
shares: 497
engagementRate: 0.1497
hashtags: []
- publishTime: 1764028298000
contentId: '7576443790114704670'
description: 🍳
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/owiGR0nACjciCxiIGFIDdyAqd7AfxHwk1gkI4B~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=umzZi%2FUgKqxWr3tHB9nJcGeza2s%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 24
likes: 516200
comments: 2643
views: 2700000
shares: 5912
engagementRate: 0.1944
hashtags: []
- publishTime: 1764025951000
contentId: '7576433685994507550'
description: Still that little puppy to me🥺
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o8VDGbPtERfMQMFApMkACzOfWXnRBJEJJQEUsw~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=65%2Bj5uQyfMy%2BnUH0dnCEoWg9uhg%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 9
likes: 36000
comments: 354
views: 219000
shares: 114
engagementRate: 0.1665
hashtags: []
- publishTime: 1763657979000
contentId: '7574853285790715166'
description: Reactive Gaurd Dog/Most Loving Dog
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o8L7PKaSPA9FIHhJIGYoAjSCq0feQ7GbIe4AQG~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=pDDzPqWSLfUbvNMPZWB%2BlZzvmbA%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 10
likes: 100200
comments: 427
views: 590400
shares: 1596
engagementRate: 0.1731
hashtags: []
- publishTime: 1763168675000
contentId: '7572751715397602590'
description: Been watching AOT lately
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ooB3bi1CRI0iiiRC4qYPYFnaDUxEAIA3X0IfAi~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=2AEBNhdExbzTKUMj9sGNiMl82fo%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 6
likes: 48300
comments: 436
views: 348600
shares: 1241
engagementRate: 0.1434
hashtags: []
- publishTime: 1763167494000
contentId: '7572746623525113119'
description: ''
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ooQiBK0IXvVBVA6zAhqQfvihiCAIABiyXTVVtE~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=iTWqp3a8bjPUIYAog1Nn%2BzOuXA4%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 31
likes: 155600
comments: 1496
views: 1400000
shares: 4347
engagementRate: 0.1153
hashtags: []
- publishTime: 1762807222000
contentId: '7571199249002663198'
description: 'What I imagine pt. 🥷🏻 🏡 '
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oojCjWIheTv8RRJyuSfJAJqJeyBIAXsTMJNhQA~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=bsJaBheTLw4Z%2F%2FNFupX5nTCFMqs%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 69
likes: 173200
comments: 1345
views: 847500
shares: 3209
engagementRate: 0.2097
hashtags: []
- publishTime: 1762799643000
contentId: '7571166724091809055'
description: 'I want my money back 🐻 '
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o80IISwCABi6sA85hMtAfiB7ZiqP3IYSIRiBZF~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=x9HBmwZ4U5fZlVBFj1Yw912LMzs%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 5
likes: 138800
comments: 608
views: 742300
shares: 6379
engagementRate: 0.1964
hashtags: []
- publishTime: 1762376217000
contentId: '7569348133755358494'
description: ''
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/owfQ6ghA7pgwIAEvug1FfEMDBuz2CIRLl0VADE~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=HVWJ1%2B2qiUITmxIiBzR8lx6lW0E%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 25
likes: 55700
comments: 354
views: 325800
shares: 600
engagementRate: 0.1739
hashtags: []
- publishTime: 1762374642000
contentId: '7569341342095101214'
description: Is this universal?
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oQoIKZOfgokIq1FCPXWGeIAjaZALTe2AJYCSgT~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=46skl1J79dmVzN112ullV7IBvRU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 26
likes: 96400
comments: 351
views: 780300
shares: 19800
engagementRate: 0.1494
hashtags: []
- publishTime: 1762284168000
contentId: '7568952759513255199'
description: 'Fr '
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/owSKlrAFeAIpPKcZFGjSBoCyUIIqLIXekK8IEe~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=ISs7IOF4BlTM0%2FLwHgU%2BeJhy3Fw%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 11
likes: 96300
comments: 592
views: 692100
shares: 7951
engagementRate: 0.1515
hashtags: []
- publishTime: 1762204949000
contentId: '7568612550296751391'
description: Let me cook👹 or let me apologize🙏🏻
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o4IA2iiRBcgfQ2hVR0RHALqJdCECIgJABIH4iA~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=lMrLqAWGT8lpazmQ49qCA1cVmho%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 9
likes: 36800
comments: 363
views: 241100
shares: 795
engagementRate: 0.1574
hashtags: []
- publishTime: 1761958206000
contentId: '7567552814591921439'
description: 'Who knows???? 🔥 '
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ocQlFjCSxCFWFWIZYO4MUAJIqeI8APy2OQefQr~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=5AP6zsFBTd6A1iLn3a%2B04PMJXN4%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 10
likes: 292300
comments: 1048
views: 2500000
shares: 1468
engagementRate: 0.1179
hashtags: []
- publishTime: 1761846857000
contentId: '7567074579148000543'
description: Designated sacrifice 🫡
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oABAeCI0J7GcjfAMy5SwLAHIerqDgSQIT2ILAT~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=pan6fzKzSEDAwx5uhK%2BAcPv9TvQ%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 9
likes: 190400
comments: 523
views: 1300000
shares: 11100
engagementRate: 0.1554
hashtags: []
- publishTime: 1761343142000
contentId: '7564911153571220767'
description: 'Barks brought to you by Kevin '
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o8AIKqZ7gzRQfC2VnfDfBQlwq99jEWFA6KMI6d~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=i8zmftPYB%2BC3jKNFJuzE29%2BgNRs%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 48
likes: 69100
comments: 494
views: 422300
shares: 1271
engagementRate: 0.1678
hashtags: []
- publishTime: 1761010029000
contentId: '7563480419786689823'
description: All bets are off when we’re on the water🥲
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oQxttArz3UFf7QQjX2W8QFAJDwG9eeQfGdM6Rj~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=dfNixRS6jFheyUYOWP94gMmj99I%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 18
likes: 414300
comments: 1916
views: 3200000
shares: 15000
engagementRate: 0.1348
hashtags: []
- publishTime: 1760569128000
contentId: '7561586769943072030'
description: Never a dull moment
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oIUP5Pqi4ArVaBtkyDBLATgiERxgwIEjABviJ~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=UCzH5j9sEnPuNgrmNbk3%2BTneq1A%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 43
likes: 2000000
comments: 3370
views: 11200000
shares: 145300
engagementRate: 0.1918
hashtags: []
- publishTime: 1760393436000
contentId: '7560832177194159391'
description: 'It’s true '
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ogALaF9Vd7wbD8XFRfgBXfEjAVEOEPXQnol0QE~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=gi4KHg1kimclr%2FeHGhYFTAEzTMQ%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 8
likes: 130700
comments: 656
views: 1300000
shares: 1007
engagementRate: 0.1018
hashtags: []
- publishTime: 1760132268000
contentId: '7559710452603784479'
description: ''
coverImageUrl: >-
https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ocVR0MG2gICI4OaCeIAAgfFLDvltkMCJVyMjqe~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=UpCJy11IGaKfrPnYBMAKL5E02fc%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
isAd: false
length: 30
likes: 207100
comments: 726
views: 1400000
shares: 5160
engagementRate: 0.1521
hashtags: []
creditsUsed: 1
creditsAvailable: -1
traceId: 6b3d3226368e03a0f213f5697bf7312a
timestamp: 1767939569931
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 uniqueId:
summary: Missing uniqueId
value:
success: false
error: VALIDATION_ERROR
message: 'Missing required field: ''uniqueId''.'
timestamp: 1770099403116
invalid uniqueId:
summary: Invalid uniqueId format
value:
success: false
error: VALIDATION_ERROR
message: >-
Invalid 'uniqueId' format. TikTok unique ID must be
between 1 to 101 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/tiktok/content-detail" \
-H "Content-Type: application/json" \
-H "api-key: " \
-d '{ "uniqueId": "kallmekris", "fields": { "recentVideos": 5 } }'
components:
securitySchemes:
ApiKeyAuth:
type: apiKey
description: The valid CreatorDB API key for authentication.
name: api-key
in: header
````