Skip to content
Protocol primitive

Resolve

Resolve a video, profile, LIVE or Shop link (tiktok.com, vm.tiktok.com, vt.tiktok.com) or an @username into typed IDs and the creation time decoded from the Snowflake ID.

GETapi.tikultra.com/v1/resolvePrimitive · 2 credits
Upstreamredirect + /aweme/v1/aweme/detail/Every plan

Parameters

NameTypeDescription
inputrequiredstringA link or @username.
e.g. https://vm.tiktok.com/ZMh7Kx2Qp/

Pricing

PlanPer callPer 1,000 calls
Starter2 credits$0.23
Growth2 credits$0.16
Scale2 credits$0.12

Responses

A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining. Errors return a JSON body with a stable code and cost 0 credits. Error codes

curl -G https://api.tikultra.com/v1/resolve \
  -H "x-api-key: $TIKULTRA_KEY" \
  --data-urlencode "input=https://vm.tiktok.com/ZMh7Kx2Qp/"
{
  "kind": "video",
  "canonical_url": "https://www.tiktok.com/@acme/video/7705852133855161377",
  "aweme_id": "7705852133855161377",
  "uid": "6970000000000000001",
  "sec_uid": "MS4wLjABAAAAq8V3xLm2pR9wQ8mN4vK1zH7tB2yX",
  "unique_id": "acme",
  "room_id": null,
  "product_id": null,
  "music_id": "7569924403851462401",
  "snowflake_timestamp_utc": "2026-11-08T17:21:52Z"
}
Try it in the playgroundFull reference in the docs

More in Devices, signing & primitives

POST/v1/resolveResolve (POST)2 crGET/v1/tools/id-converterID converter2 crPOST/v1/tools/protobuf-decodeProtobuf decode2 crPOST/v1/jobs/submitSubmit batch jobper taskGET/v1/jobs/{id}Get jobFreeGET/v1/devicesList devicesFreePOST/v1/devices/provisionProvision device10 crGET/v1/devices/templatesHardware templatesFreeGET/v1/apps/versionsApp versionsFreeGET/v1/devices/{id}Get deviceFreePOST/v1/devices/{id}/bootstrapBootstrap device10 crPOST/v1/devices/{id}/reportDevice security report10 crPOST/v1/crypto/signSign request2 crPOST/v1/crypto/x-cylonsX-Cylons token2 crPOST/v1/crypto/x-argus/decryptX-Argus decrypt2 crPOST/v1/crypto/x-ladon/decryptX-Ladon decrypt2 crPOST/v1/crypto/x-gorgon/decryptX-Gorgon decrypt2 crPOST/v1/crypto/ttencrypt/encryptTTEncrypt encode2 crPOST/v1/crypto/ttencrypt/decryptTTEncrypt decode2 crPOST/v1/crypto/zstd/compresszstd compress2 crPOST/v1/crypto/zstd/decompresszstd decompress2 crPOST/v1/crypto/passport-hashPassport identifier hash2 cr

Ready to build?

Start with 2,500 free credits and test every public endpoint, then pick a plan.

Get an API keySee pricing