Skip to content
Managed gateway · LeanPool

Batch videos

Up to 50 videos in one call, billed per video.

POSTapi.tikultra.com/v1/video/batchStandard · 5 credits
Upstream/aweme/v1/multi/aweme/detail/Every plan

Parameters

NameTypeDescription
aweme_idsrequiredstring[]Up to 50 numeric video IDs.
e.g. 7705852133855161377,7705852133855161378

Pricing

PlanPer callPer 1,000 calls
Starter5 credits per item$0.58
Growth5 credits per item$0.40
Scale5 credits per item$0.29

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 -X POST https://api.tikultra.com/v1/video/batch \
  -H "x-api-key: $TIKULTRA_KEY" \
  -H "content-type: application/json" \
  -d '{"aweme_ids":["7705852133855161377","7705852133855161378"]}'
{
  "count": 2,
  "items": [
    {
      "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"
      }
    },
    {
      "aweme_id": "7705852133855161378",
      "desc": "Switch sound comparison: tactile vs linear",
      "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"
      }
    }
  ]
}
Try it in the playgroundFull reference in the docs

More in Videos & comments

GET/v1/videoGet video5 crGET/v1/video/commentsComments5 crGET/v1/video/comments/repliesComment replies5 crGET/v1/video/comments/by-idsComments by ID5 crGET/v1/video/danmakuDanmaku5 crGET/v1/video/transcriptTranscript2 crGET/v1/video/no-watermarkNo-watermark media2 crGET/v1/video/slideshowSlideshow media2 crGET/v1/video/duetsDuets and stitches5 crGET/v1/video/anchorsVideo anchors5 crGET/v1/video/upvotesRepost annotations5 crGET/v1/video/share-infoShare info5 crGET/v1/video/giftsVideo gifts5 crGET/v1/video/forensicsVideo forensics10 crGET/v1/video/fyp-velocityFYP velocity10 crGET/v1/video/comment-leadsComment leads10 cr

Ready to build?

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

Get an API keySee pricing