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

Upstream: redirect + /aweme/v1/aweme/detail/
Access: Every plan
Runs on: Primitive
Billing: Failed calls are free
Older path: /v1/tools/deeplink

Authorization

x-api-keyheader · stringrequired

Your API key. Create one in API keys.

Query parameters

inputstringrequired

A link or @username. For example https://vm.tiktok.com/ZMh7Kx2Qp/.

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.

cURLPythonNode.js

curl -G https://api.tikultra.com/v1/resolve \
  -H "x-api-key: $TIKULTRA_KEY" \
  --data-urlencode "input=https://vm.tiktok.com/ZMh7Kx2Qp/"

Try ituses 2 credits

Run this endpoint with your own key in the dashboard playground. Every response shows its cost.

Open in playground

200 · sample

{
  "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"
}