Skip to main content
POST
Request a TikTok Spark code from a creator

Authorizations

Authorization
string
header
required

OAuth 2.1 authorization code + PKCE (S256). Tokens are tenant-bound (company_id) and scoped. Discover endpoints via /.well-known/oauth-authorization-server.

Headers

Idempotency-Key
string

Client-chosen key; replaying the same key + body returns the original response, a different body returns 409.

Body

application/json
creatorId
string
required

The creator to ask.

tiktokItemId
string

The numeric TikTok item ID of the video. Give this, sourcePostId or sourcePostUrl.

sourcePostId
string

The ID of the video, as SideShift tracks it.

sourcePostUrl
string

The TikTok URL of the video.

sourcePlatform
string
postTitle
string
provider
string

Optional. Only tiktok uses Spark codes; other platforms are refused.

Response

Success. Returns the request and reused.

The response is of type object.