Skip to main content
GET
cURL

Authorizations

api-key
string
header
required

The valid CreatorDB API key for authentication.

Query Parameters

uniqueId
string
required

TikTok account ID. Accepts tiktok or @tiktok (@ is stripped automatically).

Required string length: 1 - 25
Pattern: ^@?[a-zA-Z0-9._-]{1,24}$
Example:

"tiktok"

pastDayRange
string
required

Returns one data point per day over the requested range. For example, 30 returns the past 30 days of daily snapshots. Valid range: 1-365.

Pattern: ^[1-9]\d*$
Example:

"30"

Response

TikTok performance historical data returned successfully.

data
object
required

The historical performance metrics of the specified TikTok account.

creditsUsed
number
required

Number of API credits consumed by this request.

Example:

1

creditsAvailable
number
required

Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable.

Example:

-1

planCreditsAvailable
number
required

Remaining plan credits after this request, in credits.

Example:

900

purchasedCreditsAvailable
number
required

Remaining purchased-bucket credits after this request, in display units.

Example:

75

traceId
string
required

Unique trace ID for each request.

Example:

"f8e4a3b2c1d0e9f8a7b6c5d4e3f2a1b0"

timestamp
integer
required

Time the response was generated, represented as a Unix timestamp in milliseconds.

Example:

1750732453635

errorCode
string
required

Error code returned if the request fails. Empty if the request is successful.

Example:

""

errorDescription
string
required

Description of the error. Empty if the request is successful.

Example:

""

success
boolean
required

true if the request is successful.

Example:

true

keyCreditsAvailable
number

Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit.

Example:

4975

Last modified on September 10, 2026