Guides / Get started / Quickstart

Quickstart

Create a key, fetch one TikTok video as JSON and see what the call cost. It takes about a minute.

Create a key

Open API keys in the dashboard and choose Create API key. The full key is shown once, so keep it somewhere safe. The free plan includes 2,500 credits, about 500 standard calls.

Terminal

export TIKULTRA_KEY="tu_live_…"

Make your first request

Fetch one video. Send the key in the x-api-key header and pass the video’s aweme_id, or its share link as url.

cURLPythonNode.jsfirst_request

1curl -G https://api.tikultra.com/v1/video \
2  -H "x-api-key: $TIKULTRA_KEY" \
3  --data-urlencode "aweme_id=7705852133855161377"

Read the response

You get the video as JSON. Field names stay the same across endpoints, so a profile’s unique_id matches the author of every video.

Response

{
  "aweme_id": "7705852133855161377",
  "desc": "Launch film, 1080p60 master #keyboards #desksetup",
  "create_time": 1762622512,
  "region": "US",
  "author": {
    "uid": "6970000000000000001",
    "unique_id": "acme",
    "sec_uid": "MS4wLjABAAAAq8V3xLm2pR9wQ8mN4vK1zH7tB2yX",
    "nickname": "Acme Studio",
    "follower_count": 128431,
    "verified": false
  },
  "stats": {
    "play_count": 1482906,
    "digg_count": 96442,
    "comment_count": 1318,
    "share_count": 4877,
    "collect_count": 2210,
    "repost_count": 614
  },
  "music": {
    "id": "7569924403851462401",
    "title": "original sound - acme",
    "author": "Acme Studio",
    "duration_sec": 31
  },
  "video": {
    "codec": "bytevc1",
    "width": 1080,
    "height": 1920,
    "fps": 60,
    "duration_ms": 31840,
    "bitrate_bps": 3842100,
    "play_url": "https://v16-webapp-prime.tiktok.com/video/tos/useast2a/tos-useast2a-pve-0068/oQ8kLmN2xR9pV/?a=1233",
    "cover_url": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068/o8kLmN2xR9pV~tplv-tiktokx-origin.image"
  }
}

Check what it cost

Header	Example	Meaning
`x-credits-cost`	5	Credits this call used
`x-credits-tier`	standard	Primitive, standard, heavy or premium
`x-credits-remaining`	2495	Your balance after the call

Failed calls are free. If TikTok times out or errors, you get a 5xx with x-credits-cost: 0 and can retry right away.