> ## 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 Profile Information
> Retrieve profile information of a specified TikTok creator, including metadata, statistics, hashtags, and content analysis.
Optionally pass `fields` in the request body to return only a subset of profile fields. You are billed the sum of the requested fields' costs, capped at the full-bundle price. Fractional calls must be enabled on your API key. Otherwise, requests that include a fields parameter return a `400` error (`FractionalCallsNotEnabled`). Per-field pricing is not published yet. For how fractional calls work, see [Fractional Calls](/api-v3/fractional-calls).
## OpenAPI
````yaml /api-v3/api-v3.yaml post /tiktok/profile
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/profile:
post:
tags:
- TikTok
summary: Get Profile Information
description: >-
Retrieve profile information of a specified TikTok creator, including
metadata, statistics, hashtags, and content analysis.
Optionally pass `fields` in the request body to return only a subset
of profile fields. You are billed the sum of the requested fields'
costs, capped at the full-bundle price. Fractional calls must be enabled
on your API key. Otherwise, requests that include a fields parameter
return a `400` error (`FractionalCallsNotEnabled`). Per-field pricing is
not published yet. For how fractional calls work, see [Fractional
Calls](/api-v3/fractional-calls).
operationId: getTiktokProfile
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: array
description: >-
Subset of profile fields to return for fractional billing.
Omit or pass an empty array to return the full profile at
the full-bundle price. Per-field costs are not published
yet.
items:
type: string
examples:
- - displayName
- country
- totalFollowers
responses:
'200':
description: TikTok creator profile information returned successfully.
content:
application/json:
schema:
type: object
properties:
data:
type: object
description: Profile information of the specified TikTok creator.
properties:
uniqueId:
type: string
description: Account handle.
examples:
- tiktok
displayName:
type: string
description: Account name.
examples:
- TikTok
category:
type: string
description: Professional account category.
examples:
- BAKERY
avatarUrl:
type: string
description: Account profile picture URL.
examples:
- >-
https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/
bio:
type: string
description: The profile biography.
examples:
- 'The #1 destination for short-form mobile videos.'
isBusinessAccount:
type: boolean
description: '`true` if it is a business account.'
examples:
- false
isPrivateAccount:
type: boolean
description: '`true` if it is a private account.'
examples:
- false
isVerified:
type: boolean
description: '`true` if the account is verified.'
examples:
- true
hasSponsors:
type: boolean
description: '`true` if there is sponsored content.'
examples:
- true
country:
type: string
description: >-
The country in **ISO 3166-1 alpha-3** format. For the
country code list, see
[here](https://docs.creatordb.app/api-v2/country-code).
examples:
- GBR
mainLanguage:
type: string
description: >-
The primary language used in posts, represented in
**ISO 639-3** format. For the language code list, see
[here](https://docs.creatordb.app/api-v3/language-code).
examples:
- eng
languages:
type: array
description: >-
All languages used in posts, represented in **ISO
639-3** format. For the language code list, see
[here](https://docs.creatordb.app/api-v3/language-code).
examples:
- - eng
- zht
items:
type: string
secondLanguage:
type: string
description: >-
The secondary language used in posts, represented in
**ISO 639-3** format. For language code list, see
[here](https://docs.creatordb.app/api-v3/language-code).
examples:
- zht
totalContents:
type: integer
description: Total number of videos.
minimum: 0
examples:
- 305
totalFollowing:
type: integer
description: Total number of accounts followed.
minimum: 0
examples:
- 4757
totalFollowers:
type: integer
description: Total number of followers.
minimum: 0
examples:
- 38100
subscriberGrowth:
type: object
description: >-
Follower growth metrics over 7, 30, and 90-day
periods.
properties:
g7:
type: number
description: >-
Follower growth over 7 days, rounded to 4th
decimal place.
examples:
- 0.1234
g30:
type: number
description: >-
Follower growth over 30 days, rounded to 4th
decimal place.
examples:
- 0.2345
g90:
type: number
description: >-
Follower growth over 90 days, rounded to 4th
decimal place.
examples:
- 0.3456
required:
- g7
- g30
- g90
hashtags:
type: array
description: Hashtags used in TikTok posts and usage statistics.
items:
type: object
description: Hashtag information and usage statistics.
properties:
name:
type: string
description: Hashtags used in post captions or descriptions.
examples:
- '#foryoupage'
contentCount:
type: integer
description: Number of contents using the hashtag.
minimum: 0
examples:
- 250
required:
- name
- contentCount
niches:
type: array
description: >-
Granular subcategories of content topics identified by
CreatorDB's AI model, which analyzes and groups
keywords, hashtags, and tags used by creators.
examples:
- - india_All
- newyear_All
- thailand_All
items:
type: string
otherLinks:
type: array
description: Linked websites.
items:
type: object
description: Information of external platform links.
properties:
title:
type: string
description: The link name.
examples:
- string
url:
type: string
description: The profile or website URL.
examples:
- url string
required:
- title
- url
lastPublishTime:
type: integer
description: >-
Time the last content was uploaded, represented as a
Unix timestamp in milliseconds.
examples:
- 1753179002000
lastDbUpdateTime:
type: integer
description: >-
Last update time of the creator profile and statistics
in the CreatorDB database, represented as a Unix
timestamp in milliseconds.
examples:
- 1753179002000
required:
- uniqueId
- displayName
- category
- avatarUrl
- bio
- isBusinessAccount
- isPrivateAccount
- isVerified
- hasSponsors
- country
- mainLanguage
- languages
- secondLanguage
- totalContents
- totalFollowing
- totalFollowers
- subscriberGrowth
- hashtags
- niches
- otherLinks
- lastPublishTime
- lastDbUpdateTime
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:
uniqueId: charlidamelio
displayName: charli d’amelio
category: ''
avatarUrl: >-
https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/7310052907548688430~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=d917d4bb&x-expires=1768021200&x-signature=YzmaK9NcAS6NfN%2BNcV1LLX3jJec%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=maliva
bio: ':)'
isBusinessAccount: false
isPrivateAccount: false
isVerified: true
hasSponsors: false
country: USA
mainLanguage: eng
languages:
- eng
secondLanguage: null
totalContents: 25
totalFollowers: 155900000
totalFollowing: 1289
subscriberGrowth:
g7: 0.0012
g30: 0.0045
g90: 0.0123
hashtags:
- name: '#pradamode'
contentCount: 2
- name: '#redbulldanceyourstyle'
contentCount: 2
- name: '#redbullfam'
contentCount: 2
- name: '#givesyouwiiings'
contentCount: 1
- name: '#katespadenypartner'
contentCount: 1
- name: '#pradass26'
contentCount: 1
- name: '#eadv2025'
contentCount: 1
- name: '#ceraveeadv2025'
contentCount: 1
- name: '#ceravepartner'
contentCount: 1
niches:
- dance_All
- entertainment_All
- lifestyle_All
otherLinks:
- title: ''
url: >-
https://www.tiktok.com/link/v2?aid=1988&lang=en&scene=bio_url&target=win.gs/DanceYourStyleLA
lastPublishTime: 1763599023000
lastDbUpdateTime: 1767830400000
creditsUsed: 1
creditsAvailable: -1
traceId: e2817236a4f325570bfe6ee5fae33f23
timestamp: 1767936363120
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. The TikTok unique ID must be
between 1 and 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/profile" \
-H "Content-Type: application/json" \
-H "api-key: " \
-d '{ "uniqueId": "charlidamelio", "fields": ["displayName", "country"] }'
components:
securitySchemes:
ApiKeyAuth:
type: apiKey
description: The valid CreatorDB API key for authentication.
name: api-key
in: header
````