API reference / Devices, signing & primitives / Sign request

Sign request

Native signature headers for a mobile request you are about to send, in 0.25 ms at p50 and 0.93 ms at p99. Pick the client with os, app_flavour and app_version.

POSTapi.tikultra.com/v1/crypto/signPrimitive · 2 credits
Upstream
local · native request signer (<1 ms)
Access
Every plan
Runs on
Primitive
Client
os, app_flavour, app_version selectable
Billing
Failed calls are free

Authorization

x-api-keyheader · stringrequired

Your API key. Create one in API keys.

Body

Send JSON with content-type: application/json.

osstring

android or ios. One of android, ios.

app_flavourstring

Which app to run as. One of tiktok, lite, lite_coin, pro, studio, shop, tv, douyin.

app_versionstring

A release of that app. Defaults to the current default for (os, app_flavour). For example 47.6.3.

methodstringrequired

The HTTP method of your request. For example GET.

urlstringrequired

The full request URL, with its query. For example https://api16-normal-c-useast1a.tiktokv.com/aweme/v1/feed/?aid=1233&count=6.

headersobject

Headers you will send.

bodystring

The body you will send, if any.

device_idstring

Sign as one of your provisioned devices.

Response

A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining.

Errors

Errors return a JSON body with a stable code and cost 0 credits. See Errors and retries.