API reference / Videos & comments / Video gifts
Video gifts
Gifts sent on a video.
- Upstream
/tiktok/v1/gift/list/- Access
- Every plan
- Runs on
- LeanPool · android · tiktok · 47.6.3
- Client
os,app_flavour,app_versionoverrides- Billing
- Failed calls are free
- Older path
/v1/scrape/video/gifts
Authorization
x-api-keyheader · stringrequired
Your API key. Create one in API keys.
Query parameters
aweme_idstringrequired
The numeric video ID. For example 7705852133855161377.
Client and egress overrides
Optional. Leave them out to run as android · tiktok · 47.6.3 from the default pool. See Clients and versions.
osstring
android or ios. For example android.
app_flavourstring
Run as tiktok, lite, lite_coin, pro, studio, shop, tv, douyin. For example tiktok.
app_versionstring
A release of that app. Defaults to the current default for (os, app_flavour). For example 47.6.3.
regionstring
Two-letter country code for egress. For example US.
citystring
A supported city in that region. For example miami.
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.