{ "openapi": "3.0.3", "info": { "title": "ShortVid API — Real-Time Short-Form Video, Creator & Ad Data API", "version": "1.0.0", "description": "High-speed, no-watermark TikTok Data & Creative Center Ads API.\n\n**Authentication** — pass your API key in the `x-api-key` request header (`Authorization: Bearer tk_...` is also supported). Never pass your API key in the URL query string.\n\n**Unified Credit System** — `$1 = 10,000 Credits` (`1 Credit = $0.0001`). Minimum charge per billable call is `10 Credits` (`$0.001`).\n- **Video feeds & search** (`/v1/video/search`, `/v1/user/posts`, `/v1/challenge/posts`, `/v1/music/posts`, `/v1/feed/list`): **2 Credits / video** (`$0.20 / 1K videos`, min 10 Credits).\n- **Comments & replies** (`/v1/comment/list`, `/v1/comment/reply`): **1 Credit / comment** (`$0.10 / 1K comments`, min 10 Credits).\n- **Followers, following & user search** (`/v1/user/followers`, `/v1/user/following`, `/v1/user/search`): **1 Credit / user** (`$0.10 / 1K users`, min 10 Credits).\n- **Single lookups & 1080p video parser** (`/v1/video/detail`, `/v1/user/info`, `/v1/challenge/info`, `/v1/music/info`, `/v1/ads/top/ads/detail`): **10 Credits / request** (`$1.00 / 1K requests`).\n- **Commercial Ads Library** (`/v1/ads/top/ads`): **10 Credits / ad** (`$1.00 / 1K ads`, min 10 Credits).\n\nEvery charged response includes `x-credits-cost`, `x-credits-remaining`, `x-balance-remaining`, and `x-request-id`. Failed upstream calls (`code != 0`), rate-limited calls (`429`), and gateway errors (`5xx`) are **never charged**.\n\n**Response Envelope** — all data endpoints return JSON with `{\"code\": 0, \"provider\": \"https://shortvidapi.com\", \"status\": \"ok\", \"msg\": \"success\", \"data\": ...}`. Always check `code === 0`.\n", "contact": { "email": "support@shortvidapi.com", "url": "https://shortvidapi.com" } }, "servers": [ { "url": "https://api.shortvidapi.com" } ], "security": [ { "ApiKey": [] } ], "tags": [ { "name": "Videos", "description": "Single video 1080p no-watermark parser & keyword video search." }, { "name": "Users", "description": "Creator profile info, public video posts, and creator search." }, { "name": "Followers", "description": "Creator followers and following lists (up to 200 per call)." }, { "name": "Comments", "description": "Top-level video comments and nested second-level replies." }, { "name": "Hashtags", "description": "Hashtag challenge metrics and tagged video feeds." }, { "name": "Music", "description": "Sound/music track details and videos using a sound." }, { "name": "Trending", "description": "Regional trending video feeds by country code." }, { "name": "Commercial Ads", "description": "TikTok Creative Center top ads library and 1080p ad creative details." } ], "paths": { "/v1/video/detail": { "get": { "operationId": "v1_video_detail", "tags": [ "Videos" ], "summary": "Get video or photo carousel detail & 1080p no-watermark URL", "description": "Fetch full metadata, engagement metrics, creator profile, music track, image carousel slides, and direct 1080p HD no-watermark download links (`data.play`, `data.hdplay`) for any public TikTok video.", "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string" }, "description": "TikTok video URL, short link (`vm.tiktok.com`), or numeric video ID.", "example": "https://www.tiktok.com/@tiktok/video/7106594312292453675" }, { "name": "hd", "in": "query", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ], "default": 1 }, "description": "Set to `1` to include the 1080p HD no-watermark stream URL in `data.hdplay`.", "example": 1 } ], "x-price-per-request": "$1.00 / 1K requests", "x-credits-per-request": "10 Credits / request", "responses": { "200": { "description": "Success (`code === 0`). Charged according to the endpoint credit rate.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "example": 0 }, "provider": { "type": "string", "example": "https://shortvidapi.com" }, "status": { "type": "string", "example": "ok" }, "msg": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "aweme_id": { "type": "string", "example": "v12044gd0000cafr3i3c77u2codsenc0" }, "id": { "type": "string", "example": "7106594312292453675" }, "region": { "type": "string", "example": "US" }, "title": { "type": "string", "example": "how many frogs did you find? 🐸 check out tiktok’s #Minecraft community today! @Gorillo" }, "content_desc": { "type": "array", "items": { "type": "string" } }, "cover": { "type": "string", "example": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/beee36ba02ef449397b2d128bc32dd9d_1654632931~tplv-tiktokx-cropcenter-q:300:400:q70.jpeg?dr=8596&re" }, "ai_dynamic_cover": { "type": "string", "example": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/07edb7fb43d0469da286ffa8e6a10cf3_1654632930~tplv-tiktokx-origin.image?dr=8606&refresh_token=4cb0d" }, "origin_cover": { "type": "string", "example": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/bc4fdc1d910a483489b02822d6b9c2b9_1654632930~tplv-tiktokx-shrink-aq:360:360:q75.webp?dr=11731&refr" }, "duration": { "type": "integer", "example": 24 }, "play": { "type": "string", "example": "https://v19.tiktokcdn-us.com/b8d2c59d91ad53c28951f11295dd39d3/6ae7ab49/video/tos/useast5/tos-useast5-ve-0068c003-tx/290d9614206e4076b11579a437577a48/?a=1233&bti" }, "wmplay": { "type": "string", "example": "https://v19.tiktokcdn-us.com/52a6f89570c9447f68132c66c2465b8e/6ae7ab49/video/tos/useast5/tos-useast5-pve-0068-tx/ba0aec3465404e68a34b59f36151646a/?a=1233&bti=OT" }, "hdplay": { "type": "string", "example": "https://v16.tokcdn.com/d3cd537d7e90ed1b65f70115793d31e9/629e9500/7106594312292453675_original.mp4" }, "size": { "type": "integer", "example": 3288875 }, "wm_size": { "type": "integer", "example": 3308379 }, "hd_size": { "type": "integer", "example": 30294767 }, "music": { "type": "string", "example": "https://v16-ies-music.tiktokcdn-us.com/905cab1b42fc5525150eab7cfe73b1c4/6af09181/video/tos/useast5/tos-useast5-v-27dcd7-tx/400ba31d967e4a48b0378f52036accc7/?a=5" }, "music_info": { "type": "object", "properties": { "id": { "type": "string", "example": "7106594280055130923" }, "title": { "type": "string", "example": "original sound - tiktok" }, "play": { "type": "string", "example": "https://v16-ies-music.tiktokcdn-us.com/905cab1b42fc5525150eab7cfe73b1c4/6af09181/video/tos/useast5/tos-useast5-v-27dcd7-tx/400ba31d967e4a48b0378f52036accc7/?a=5" }, "cover": { "type": "string", "example": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter-q:1080:1080:q70.jpeg?dr=8837&refresh_t" }, "author": { "type": "string", "example": "TikTok" }, "original": { "type": "boolean", "example": true }, "duration": { "type": "integer", "example": 24 }, "album": { "type": "string", "example": "" }, "create_time": { "type": "integer", "example": 1654632935 } } }, "play_count": { "type": "integer", "example": 592612 }, "digg_count": { "type": "integer", "example": 98933 }, "comment_count": { "type": "integer", "example": 1269 }, "share_count": { "type": "integer", "example": 361 }, "download_count": { "type": "integer", "example": 130 }, "collect_count": { "type": "integer", "example": 59275 }, "create_time": { "type": "integer", "example": 1654632929 }, "anchors": { "type": "string", "nullable": true }, "anchors_extras": { "type": "string", "example": "" }, "is_ad": { "type": "boolean", "example": false }, "commerce_info": { "type": "object", "properties": { "adv_promotable": { "type": "boolean", "example": false }, "auction_ad_invited": { "type": "boolean", "example": false }, "branded_content_type": { "type": "integer", "example": 0 }, "is_diversion_ad": { "type": "integer", "example": 0 }, "organic_log_extra": { "type": "string", "example": "{\"req_id\":\"2026110115121604C3A0C50D7B6EC231A5\"}" }, "with_comment_filter_words": { "type": "boolean", "example": false } } }, "commercial_video_info": { "type": "string", "example": "" }, "item_comment_settings": { "type": "integer", "example": 0 }, "mentioned_users": { "type": "string", "example": "6821528796420703237" }, "author": { "type": "object", "properties": { "id": { "type": "string", "example": "107955" }, "unique_id": { "type": "string", "example": "tiktok" }, "nickname": { "type": "string", "example": "TikTok" }, "avatar": { "type": "string", "example": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?dr=8834&refresh_tok" } } }, "is_nff_or_nr": { "type": "boolean", "example": false } } } } }, "example": { "code": 0, "provider": "https://shortvidapi.com", "status": "ok", "msg": "success", "data": { "aweme_id": "v12044gd0000cafr3i3c77u2codsenc0", "id": "7106594312292453675", "region": "US", "title": "how many frogs did you find? 🐸 check out tiktok’s #Minecraft community today! @Gorillo", "content_desc": [], "cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/beee36ba02ef449397b2d128bc32dd9d_1654632931~tplv-tiktokx-cropcenter-q:300:400:q70.jpeg?dr=8596&refresh_token=194dd834&x-expires=1793631600&x-signature=tYoecY...", "ai_dynamic_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/07edb7fb43d0469da286ffa8e6a10cf3_1654632930~tplv-tiktokx-origin.image?dr=8606&refresh_token=4cb0d3cf&x-expires=1793631600&x-signature=yl1Dv6EwScCKMI22i4QLo2Q...", "origin_cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/bc4fdc1d910a483489b02822d6b9c2b9_1654632930~tplv-tiktokx-shrink-aq:360:360:q75.webp?dr=11731&refresh_token=71686917&x-expires=1793631600&x-signature=J8HS0fPy...", "duration": 24, "play": "https://v19.tiktokcdn-us.com/b8d2c59d91ad53c28951f11295dd39d3/6ae7ab49/video/tos/useast5/tos-useast5-ve-0068c003-tx/290d9614206e4076b11579a437577a48/?a=1233&bti=OTg7QGo5QHM6OjZALTAzYCMvcCMxNDNg&&bt=1046&ft=kLx3-yt4ZZo0PD...", "wmplay": "https://v19.tiktokcdn-us.com/52a6f89570c9447f68132c66c2465b8e/6ae7ab49/video/tos/useast5/tos-useast5-pve-0068-tx/ba0aec3465404e68a34b59f36151646a/?a=1233&bti=OTg7QGo5QHM6OjZALTAzYCMvcCMxNDNg&&bt=1052&ft=kLx3-yt4ZZo0PD8sT...", "hdplay": "https://v16.tokcdn.com/d3cd537d7e90ed1b65f70115793d31e9/629e9500/7106594312292453675_original.mp4", "size": 3288875, "wm_size": 3308379, "hd_size": 30294767, "music": "https://v16-ies-music.tiktokcdn-us.com/905cab1b42fc5525150eab7cfe73b1c4/6af09181/video/tos/useast5/tos-useast5-v-27dcd7-tx/400ba31d967e4a48b0378f52036accc7/?a=583965&bti=OTg7QGo5QHM6OjZALTAzYCMvcCMxNDNg&&bt=125&ft=kJxKSy...", "music_info": { "id": "7106594280055130923", "title": "original sound - tiktok", "play": "https://v16-ies-music.tiktokcdn-us.com/905cab1b42fc5525150eab7cfe73b1c4/6af09181/video/tos/useast5/tos-useast5-v-27dcd7-tx/400ba31d967e4a48b0378f52036accc7/?a=583965&bti=OTg7QGo5QHM6OjZALTAzYCMvcCMxNDNg&&bt=125&ft=kJxKSy...", "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter-q:1080:1080:q70.jpeg?dr=8837&refresh_token=28baf0a5&x-expires=1793631600&x-signature=Nshe2H%2Fw9c5...", "author": "TikTok", "original": true, "duration": 24, "album": "", "create_time": 1654632935 }, "play_count": 592612, "digg_count": 98933, "comment_count": 1269, "share_count": 361, "download_count": 130, "collect_count": 59275, "create_time": 1654632929, "anchors": null, "anchors_extras": "", "is_ad": false, "commerce_info": { "adv_promotable": false, "auction_ad_invited": false, "branded_content_type": 0, "is_diversion_ad": 0, "organic_log_extra": "{\"req_id\":\"2026110115121604C3A0C50D7B6EC231A5\"}", "with_comment_filter_words": false }, "commercial_video_info": "", "item_comment_settings": 0, "mentioned_users": "6821528796420703237", "author": { "id": "107955", "unique_id": "tiktok", "nickname": "TikTok", "avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?dr=8834&refresh_token=e0b527e0&x-expires=1793631600&x-signature=VHKavV3PAEmdRSq..." }, "is_nff_or_nr": false } } } } }, "400": { "description": "Invalid parameters, or API key placed in the URL query string (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid `x-api-key` header (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Insufficient credit balance (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Account disabled (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Unknown endpoint or disabled unstable endpoint (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "405": { "description": "Method not allowed — all `/v1/*` data endpoints use `GET` (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded (not charged). Respect the `Retry-After` header.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Temporary upstream or gateway error (not charged). Retry with exponential backoff.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/video/search": { "get": { "operationId": "v1_video_search", "tags": [ "Videos" ], "summary": "Search videos by keyword", "description": "Search public TikTok videos by keyword with filters for region, sort order, and publish time window. Every video item includes direct no-watermark playback links and full engagement statistics. Paginated via `cursor` and `hasMore`.", "parameters": [ { "name": "keywords", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Search keywords, e.g. `ai tools` or `skincare routine`.", "example": "ai tools" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 30, "default": 20 }, "description": "Number of videos to return per page (max 30).", "example": 20 }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "default": 0 }, "description": "Pagination offset cursor (`0` for first page, then pass `data.cursor` from the previous response).", "example": 0 }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "default": "US" }, "description": "Two-letter ISO country code (`US`, `GB`, `JP`, `DE`, `BR`, etc.).", "example": "US" }, { "name": "sort_type", "in": "query", "required": false, "schema": { "type": "integer", "enum": [ 0, 1, 3 ], "default": 0 }, "description": "Sort order: `0` = Relevance, `1` = Most Liked, `3` = Newest.", "example": 0 }, { "name": "publish_time", "in": "query", "required": false, "schema": { "type": "integer", "enum": [ 0, 1, 7, 30, 90, 180 ], "default": 0 }, "description": "Publish window filter: `0` = All time, `1` = Yesterday, `7` = Past 7 days, `30` = Past 30 days, `90` = Past 3 months, `180` = Past 6 months.", "example": 0 } ], "x-price-per-request": "$0.20 / 1K videos", "x-credits-per-request": "2 Credits / video (min 10 Credits)", "responses": { "200": { "description": "Success (`code === 0`). Charged according to the endpoint credit rate.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "example": 0 }, "provider": { "type": "string", "example": "https://shortvidapi.com" }, "status": { "type": "string", "example": "ok" }, "msg": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "videos": { "type": "array", "items": { "type": "object", "properties": { "aweme_id": { "type": "string", "example": "v15044gf0000dbenid7og65iln63dbq0" }, "video_id": { "type": "string", "example": "7700444273329671455" }, "region": { "type": "string", "example": "US" }, "title": { "type": "string", "example": "The best AI tool for every job: Writing emails → ChatGPT Turning notes into a plan → Claude Making a study guide → NotebookLM Researching competitors → Perplexi" }, "content_desc": { "type": "array", "items": { "type": "object" } }, "cover": { "type": "string", "example": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/och60XA3fAImJkufBDRq5qBo8EEVFEJtWXwQGl~tplv-tiktokx-cropcenter:500:800.jpeg?biz_tag=musically_video" }, "ai_dynamic_cover": { "type": "string", "example": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/owv1ptJIOzjDCgegeCLVA5NGAQqk2IzVevuIaK~tplv-tiktokx-origin.image?dr=1364&refresh_token=8b933c8b&x-e" }, "origin_cover": { "type": "string", "example": "https://p19-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/ogtgVMvzIGeuDqa6NQLeAJgIjAKdCupeIxCV6v~tplv-tiktokx-shrink-aq:360:360:q75.webp?dr=17995&refresh_tok" }, "duration": { "type": "integer", "example": 25 }, "play": { "type": "string", "example": "https://v19.tiktokcdn.com/444fe5e94f2cdae5cad74e5f5e53561d/6ae8a86c/video/tos/alisg/tos-alisg-ve-37c799-sg/okHzAevzGIeVLbDIp6IevIgWuCqRtQaAKpj4JA/?a=1233&bti=NT" }, "wmplay": { "type": "string", "example": "https://v19.tiktokcdn.com/444fe5e94f2cdae5cad74e5f5e53561d/6ae8a86c/video/tos/alisg/tos-alisg-ve-37c799-sg/okHzAevzGIeVLbDIp6IevIgWuCqRtQaAKpj4JA/?a=1233&bti=NT" }, "size": { "type": "integer", "example": 1948960 }, "wm_size": { "type": "integer", "example": 0 }, "music": { "type": "string", "example": "https://v16-ies-music.tiktokcdn.com/214d094b27a74eebcda233b216b3d17f/6af091a8/video/tos/alisg/tos-alisg-ve-2370c799-sg/oMnYAEjMJl8QqC0ffb43uXBPRbjDUBFVVLFEAP/?a" }, "music_info": { "type": "object", "properties": { "id": { "type": "object" }, "title": { "type": "object" }, "play": { "type": "object" }, "cover": { "type": "object" }, "author": { "type": "object" }, "original": { "type": "object" }, "duration": { "type": "object" }, "album": { "type": "object" }, "create_time": { "type": "object" } } }, "play_count": { "type": "integer", "example": 1137030 }, "digg_count": { "type": "integer", "example": 62323 }, "comment_count": { "type": "integer", "example": 318 }, "share_count": { "type": "integer", "example": 18159 }, "download_count": { "type": "integer", "example": 116 }, "collect_count": { "type": "integer", "example": 63751 }, "create_time": { "type": "integer", "example": 1792899412 }, "anchors": { "type": "string", "nullable": true }, "anchors_extras": { "type": "string", "example": "" }, "is_ad": { "type": "boolean", "example": false }, "commerce_info": { "type": "object", "properties": { "adv_promotable": { "type": "object" }, "auction_ad_invited": { "type": "object" }, "branded_content_type": { "type": "object" }, "is_diversion_ad": { "type": "object" }, "organic_log_extra": { "type": "object" }, "with_comment_filter_words": { "type": "object" } } }, "commercial_video_info": { "type": "string", "example": "" }, "item_comment_settings": { "type": "integer", "example": 0 }, "mentioned_users": { "type": "string", "example": "" }, "author": { "type": "object", "properties": { "id": { "type": "object" }, "unique_id": { "type": "object" }, "nickname": { "type": "object" }, "avatar": { "type": "object" } } }, "is_nff_or_nr": { "type": "boolean", "example": false }, "is_top": { "type": "integer", "example": 0 } } } }, "cursor": { "type": "integer", "example": 5 }, "hasMore": { "type": "boolean", "example": true } } } } }, "example": { "code": 0, "provider": "https://shortvidapi.com", "status": "ok", "msg": "success", "data": { "videos": [ { "aweme_id": "v15044gf0000dbenid7og65iln63dbq0", "video_id": "7700444273329671455", "region": "US", "title": "The best AI tool for every job: Writing emails → ChatGPT Turning notes into a plan → Claude Making a study guide → NotebookLM Researching competitors → Perplexity Creating UGC ads → Higgsfield Building apps → Claude Code...", "content_desc": [ "The best AI tool for every job:", "" ], "cover": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/och60XA3fAImJkufBDRq5qBo8EEVFEJtWXwQGl~tplv-tiktokx-cropcenter:500:800.jpeg?biz_tag=musically_video.video_cover&dr=14577&idc=my2&ps=13740610&refresh_token=a035...", "ai_dynamic_cover": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/owv1ptJIOzjDCgegeCLVA5NGAQqk2IzVevuIaK~tplv-tiktokx-origin.image?dr=1364&refresh_token=8b933c8b&x-expires=1793631600&x-signature=9rTw66cbmieGPDUWYbUDbVZUIm8%3D...", "origin_cover": "https://p19-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/ogtgVMvzIGeuDqa6NQLeAJgIjAKdCupeIxCV6v~tplv-tiktokx-shrink-aq:360:360:q75.webp?dr=17995&refresh_token=8482ff86&x-expires=1793631600&x-signature=NXAKWaM2F3y0lR1...", "duration": 25, "play": "https://v19.tiktokcdn.com/444fe5e94f2cdae5cad74e5f5e53561d/6ae8a86c/video/tos/alisg/tos-alisg-ve-37c799-sg/okHzAevzGIeVLbDIp6IevIgWuCqRtQaAKpj4JA/?a=1233&bti=NTY6QGo0QHM6OjZANDQuYCMucCMxNDNg&&bt=590&ft=JS-FIDyjNl~VQQUnU~...", "wmplay": "https://v19.tiktokcdn.com/444fe5e94f2cdae5cad74e5f5e53561d/6ae8a86c/video/tos/alisg/tos-alisg-ve-37c799-sg/okHzAevzGIeVLbDIp6IevIgWuCqRtQaAKpj4JA/?a=1233&bti=NTY6QGo0QHM6OjZANDQuYCMucCMxNDNg&&bt=590&ft=JS-FIDyjNl~VQQUnU~...", "size": 1948960, "wm_size": 0, "music": "https://v16-ies-music.tiktokcdn.com/214d094b27a74eebcda233b216b3d17f/6af091a8/video/tos/alisg/tos-alisg-ve-2370c799-sg/oMnYAEjMJl8QqC0ffb43uXBPRbjDUBFVVLFEAP/?a=583965&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&&bt=125&ft=gk-H...", "music_info": { "id": "7700444318988847902", "title": "original sound - maverickgpt", "play": "https://v16-ies-music.tiktokcdn.com/214d094b27a74eebcda233b216b3d17f/6af091a8/video/tos/alisg/tos-alisg-ve-2370c799-sg/oMnYAEjMJl8QqC0ffb43uXBPRbjDUBFVVLFEAP/?a=583965&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&&bt=125&ft=gk-H...", "cover": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/0c950557c61fb5495b379d40a84d859b~tplv-tiktokx-cropcenter-q:1080:1080:q70.jpeg?dr=10796&refresh_token=15dab5ec&x-expires=1793631600&x-signature=mIqR2NWERKttz%2FPcN...", "author": "Maverick Maltin | AI & ChatGPT", "original": true, "duration": 25, "album": "", "create_time": 1792899414 }, "play_count": 1137030, "digg_count": 62323, "comment_count": 318, "share_count": 18159, "download_count": 116, "collect_count": 63751, "create_time": 1792899412, "anchors": null, "anchors_extras": "", "is_ad": false, "commerce_info": { "adv_promotable": false, "auction_ad_invited": false, "branded_content_type": 0, "is_diversion_ad": 0, "organic_log_extra": "{\"req_id\":\"20261101231218F3ED520687EEF99D1732\"}", "with_comment_filter_words": false }, "commercial_video_info": "", "item_comment_settings": 0, "mentioned_users": "", "author": { "id": "6788812283432059910", "unique_id": "maverickgpt", "nickname": "Maverick Maltin | AI & ChatGPT", "avatar": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/0c950557c61fb5495b379d40a84d859b~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?dr=10793&refresh_token=0f0244a6&x-expires=1793631600&x-signature=oiZg4%2BxgBNV1KRsWzm5..." }, "is_nff_or_nr": false, "is_top": 0 }, { "aweme_id": "v15044gf0000d8f76gnog65v6007n3sg", "video_id": "7646676174059392286", "region": "US", "title": "Best Ai tools in 2026 ", "content_desc": [], "cover": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/o8eFpH6IOUALQAIHcD3LYIrGCpayPQjeaeqAEI~tplv-tiktokx-cropcenter:500:800.jpeg?biz_tag=musically_video.video_cover&dr=14577&idc=my2&ps=13740610&refresh_token=0369...", "ai_dynamic_cover": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/ogQTeU3IHCO3vAjAeDQAQLIIacGyHPBEYeyF6q~tplv-tiktokx-origin.image?dr=1364&refresh_token=41070638&x-expires=1793631600&x-signature=4kn4xQB5WSWW549uSoRqY1z88oQ%3D...", "origin_cover": "https://p19-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/oID8aUAYIHeOALZg3BqQJAI5sFmPCyGeIQ0ejH~tplv-tiktokx-shrink-aq:360:360:q75.webp?dr=17995&refresh_token=67e5fdc0&x-expires=1793631600&x-signature=wmQCRBZwLu0yAK4...", "duration": 27, "play": "https://v19.tiktokcdn.com/c9910bff45751b91d14301fee0cfadea/6ae8a86e/video/tos/alisg/tos-alisg-ve-37c799-sg/osEgOIFF8eUAyfx5ANIBCLPIjI1GYAaqDQe43H/?a=1233&bti=NTY6QGo0QHM6OjZANDQuYCMucCMxNDNg&&bt=755&ft=JS-FIDyjNl~VQQUnU~...", "wmplay": "https://v19.tiktokcdn.com/c9910bff45751b91d14301fee0cfadea/6ae8a86e/video/tos/alisg/tos-alisg-ve-37c799-sg/osEgOIFF8eUAyfx5ANIBCLPIjI1GYAaqDQe43H/?a=1233&bti=NTY6QGo0QHM6OjZANDQuYCMucCMxNDNg&&bt=755&ft=JS-FIDyjNl~VQQUnU~...", "size": 2661547, "wm_size": 0, "music": "https://v16-ies-music.tiktokcdn.com/43e0b3431fe1dc4d53db2d437a7a022d/6af091aa/video/tos/maliva/tos-maliva-ve-27dcd7c799-us/okuIYcUeG6TCEfzoFOE4nIMDmARqPP4CK7fK6r/?a=583965&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&&bt=125&ft=...", "music_info": { "id": "7646676246730541855", "title": "original sound - maverickgpt", "play": "https://v16-ies-music.tiktokcdn.com/43e0b3431fe1dc4d53db2d437a7a022d/6af091aa/video/tos/maliva/tos-maliva-ve-27dcd7c799-us/okuIYcUeG6TCEfzoFOE4nIMDmARqPP4CK7fK6r/?a=583965&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&&bt=125&ft=...", "cover": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/0c950557c61fb5495b379d40a84d859b~tplv-tiktokx-cropcenter-q:1080:1080:q70.jpeg?dr=10796&refresh_token=15dab5ec&x-expires=1793631600&x-signature=mIqR2NWERKttz%2FPcN...", "author": "Maverick Maltin | AI & ChatGPT", "original": true, "duration": 27, "album": "", "create_time": 1780380576 }, "play_count": 3656171, "digg_count": 204771, "comment_count": 9543, "share_count": 45213, "download_count": 1149, "collect_count": 196584, "create_time": 1780380574, "anchors": null, "anchors_extras": "", "is_ad": false, "commerce_info": { "adv_promotable": false, "auction_ad_invited": false, "branded_content_type": 0, "is_diversion_ad": 0, "organic_log_extra": "{\"req_id\":\"20261101231218F3ED520687EEF99D1732\"}", "with_comment_filter_words": false }, "commercial_video_info": "", "item_comment_settings": 0, "mentioned_users": "", "author": { "id": "6788812283432059910", "unique_id": "maverickgpt", "nickname": "Maverick Maltin | AI & ChatGPT", "avatar": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/0c950557c61fb5495b379d40a84d859b~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?dr=10793&refresh_token=0f0244a6&x-expires=1793631600&x-signature=oiZg4%2BxgBNV1KRsWzm5..." }, "is_nff_or_nr": false, "is_top": 0 } ], "cursor": 5, "hasMore": true } } } } }, "400": { "description": "Invalid parameters, or API key placed in the URL query string (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid `x-api-key` header (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Insufficient credit balance (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Account disabled (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Unknown endpoint or disabled unstable endpoint (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "405": { "description": "Method not allowed — all `/v1/*` data endpoints use `GET` (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded (not charged). Respect the `Retry-After` header.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Temporary upstream or gateway error (not charged). Retry with exponential backoff.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/user/info": { "get": { "operationId": "v1_user_info", "tags": [ "Users" ], "summary": "Get creator profile & account statistics", "description": "Fetch a TikTok creator's public profile (`data.user`: `id`, `uniqueId`, `nickname`, `secUid`, `verified`, `signature`, `language`, `isBusinessAccount`, `category`, `commerceUserInfo`, `isOrganization`, `ttSeller`, `bioLink`, privacy settings, avatars) and real-time counters (`data.stats`: `followerCount`, `followingCount`, `friendCount`, `heartCount`, `videoCount`, `diggCount`). Returns 0-credit charge when an account handle does not exist.", "parameters": [ { "name": "unique_id", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Creator handle without `@`, e.g. `tiktok` or `khaby.lame`.", "example": "tiktok" } ], "x-price-per-request": "$1.00 / 1K requests", "x-credits-per-request": "10 Credits / request", "responses": { "200": { "description": "Success (`code === 0`). Charged according to the endpoint credit rate.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "example": 0 }, "provider": { "type": "string", "example": "https://shortvidapi.com" }, "status": { "type": "string", "example": "ok" }, "msg": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "user": { "type": "object", "properties": { "id": { "type": "string", "example": "107955" }, "uniqueId": { "type": "string", "example": "tiktok" }, "nickname": { "type": "string", "example": "TikTok" }, "avatarThumb": { "type": "string", "example": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:100:100.webp?dr=9640&refresh_token=74f" }, "avatarMedium": { "type": "string", "example": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:720:720.webp?dr=9640&refresh_token=a1a" }, "avatarLarger": { "type": "string", "example": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:1080:1080.webp?dr=9640&refresh_token=2" }, "signature": { "type": "string", "example": "Your next discovery is waiting on TikTok." }, "verified": { "type": "boolean", "example": true }, "secUid": { "type": "string", "example": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM" }, "secret": { "type": "boolean", "example": false }, "ftc": { "type": "boolean", "example": false }, "relation": { "type": "integer", "example": 0 }, "openFavorite": { "type": "boolean", "example": false }, "commentSetting": { "type": "string", "nullable": true }, "duetSetting": { "type": "string", "nullable": true }, "stitchSetting": { "type": "string", "nullable": true }, "privateAccount": { "type": "boolean", "example": false }, "isADVirtual": { "type": "boolean", "example": false }, "isUnderAge18": { "type": "boolean", "example": false }, "ins_id": { "type": "string", "example": "" }, "twitter_id": { "type": "string", "example": "" }, "youtube_channel_title": { "type": "string", "example": "" }, "youtube_channel_id": { "type": "string", "example": "" }, "UserStoryStatus": { "type": "integer", "example": 0 }, "createTime": { "type": "integer", "example": 1425144149 }, "bioLink": { "type": "object", "properties": { "link": { "type": "string", "example": "tiktok.com/discovermore" } } } } }, "stats": { "type": "object", "properties": { "followingCount": { "type": "integer", "example": 1 }, "followerCount": { "type": "integer", "example": 96500706 }, "heartCount": { "type": "integer", "example": 466240727 }, "videoCount": { "type": "integer", "example": 1601 }, "diggCount": { "type": "integer", "example": 0 }, "heart": { "type": "integer", "example": 466240727 } } } } } } }, "example": { "code": 0, "provider": "https://shortvidapi.com", "status": "ok", "msg": "success", "data": { "user": { "id": "107955", "uniqueId": "tiktok", "nickname": "TikTok", "avatarThumb": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:100:100.webp?dr=9640&refresh_token=74fca1d1&x-expires=1793718000&x-signature=i2JqJQVzj8k1O89u6DcSt...", "avatarMedium": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:720:720.webp?dr=9640&refresh_token=a1a93936&x-expires=1793718000&x-signature=GO9ZTrYAfT8K%2BzyhMvJ...", "avatarLarger": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:1080:1080.webp?dr=9640&refresh_token=22a185e0&x-expires=1793718000&x-signature=IMLqfjzMioQBBIpFeWS...", "signature": "Your next discovery is waiting on TikTok.", "verified": true, "secUid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM", "secret": false, "ftc": false, "relation": 0, "openFavorite": false, "commentSetting": null, "duetSetting": null, "stitchSetting": null, "privateAccount": false, "isADVirtual": false, "isUnderAge18": false, "ins_id": "", "twitter_id": "", "youtube_channel_title": "", "youtube_channel_id": "", "UserStoryStatus": 0, "createTime": 1425144149, "bioLink": { "link": "tiktok.com/discovermore" } }, "stats": { "followingCount": 1, "followerCount": 96500706, "heartCount": 466240727, "videoCount": 1601, "diggCount": 0, "heart": 466240727 } } } } } }, "400": { "description": "Invalid parameters, or API key placed in the URL query string (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid `x-api-key` header (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Insufficient credit balance (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Account disabled (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Unknown endpoint or disabled unstable endpoint (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "405": { "description": "Method not allowed — all `/v1/*` data endpoints use `GET` (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded (not charged). Respect the `Retry-After` header.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Temporary upstream or gateway error (not charged). Retry with exponential backoff.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/user/posts": { "get": { "operationId": "v1_user_posts", "tags": [ "Users" ], "summary": "Get creator's public video posts", "description": "Paginated list of public videos and photo carousels posted by a creator (`data.videos`), newest first, including canonical `video_url` / `share_url`, `content_type` (`video` or `image`), direct unwatermarked MP4 streams (`play`, `no_watermark_url`, `has_watermark`, `video_format`, `bitrate_kbps`), `hashtags`, `mentioned_user_ids`, parsed POI location (`location_name`, `poi`), disclosure flags (`is_pinned`, `is_ad`, `is_paid_partnership`, `is_ecommerce`), music metadata, and full engagement statistics (`play_count`, `digg_count`, `comment_count`, `share_count`, `collect_count`, `download_count`). Pass `unique_id`, `user_id`, or `sec_uid`.", "parameters": [ { "name": "unique_id", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Creator handle without `@`, e.g. `tiktok`.", "example": "tiktok" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 35, "default": 20 }, "description": "Number of videos per page (max 35).", "example": 20 }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "default": "0" }, "description": "Pagination cursor (`0` for the first page, then pass `data.cursor`).", "example": "0" } ], "x-price-per-request": "$0.20 / 1K videos", "x-credits-per-request": "2 Credits / video (min 10 Credits)", "responses": { "200": { "description": "Success (`code === 0`). Charged according to the endpoint credit rate.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "example": 0 }, "provider": { "type": "string", "example": "https://shortvidapi.com" }, "status": { "type": "string", "example": "ok" }, "msg": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "videos": { "type": "array", "items": { "type": "object", "properties": { "aweme_id": { "type": "string", "example": "v15044gf0000dbj5qpfog65strb9nsc0" }, "video_id": { "type": "string", "example": "7702947070604332319" }, "region": { "type": "string", "example": "US" }, "title": { "type": "string", "example": "already planning next halloween? 👀🎃 take notes from @Mason Smith. find more DIY inspo on TikTok." }, "content_desc": { "type": "array", "items": { "type": "string" } }, "cover": { "type": "string", "example": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/o0MgwFCRVDqH5jE2uAADA0yEIfcX7fEE9PQAlA~tplv-tiktokx-cropcenter:300:400.jpeg?dr=10399&refresh_tok" }, "ai_dynamic_cover": { "type": "string", "example": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/o0MgwFCRVDqH5jE2uAADA0yEIfcX7fEE9PQAlA~tplv-tiktokx-origin.image?dr=10395&refresh_token=a2b2e40e" }, "origin_cover": { "type": "string", "example": "https://p19-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/oom34f8ERQ3AZVsf53QCa0DqazwFEEllBAA1X5~tplv-tiktokx-360p.webp?dr=10375&refresh_token=930ca11e&x-" }, "duration": { "type": "integer", "example": 43 }, "play": { "type": "string", "example": "https://v16m.tiktokcdn-eu.com/2fcf9572312c0c44acc748dfaeba1aec/6ae8a880/video/tos/alisg/tos-alisg-ve-37c799-sg/oglE3HF54QDrl5gA1whAfaE3qMIIRe0EVN3luB/?a=1233&bt" }, "wmplay": { "type": "string", "example": "https://v16m.tiktokcdn-eu.com/25390ecc1288064f4181a68f4f1f4d5c/6ae8a880/video/tos/alisg/tos-alisg-ve-37c799-sg/ogGM8KiEIiA1yVcftXiqm3zbYb6a5CA7BAyIQ8/?a=1233&bt" }, "size": { "type": "integer", "example": 7086434 }, "wm_size": { "type": "integer", "example": 6501323 }, "music": { "type": "string", "example": "https://sf16-music.tiktokcdn-eu.com/obj/ies-music-tx2/7703208257951353631.mp3" }, "music_info": { "type": "object", "properties": { "id": { "type": "object" }, "title": { "type": "object" }, "play": { "type": "object" }, "cover": { "type": "object" }, "author": { "type": "object" }, "original": { "type": "object" }, "duration": { "type": "object" }, "album": { "type": "object" }, "create_time": { "type": "object" } } }, "play_count": { "type": "integer", "example": 108971 }, "digg_count": { "type": "integer", "example": 1808 }, "comment_count": { "type": "integer", "example": 489 }, "share_count": { "type": "integer", "example": 154 }, "download_count": { "type": "integer", "example": 3 }, "collect_count": { "type": "integer", "example": 163 }, "create_time": { "type": "integer", "example": 1793482137 }, "anchors": { "type": "string", "nullable": true }, "anchors_extras": { "type": "string", "example": "" }, "is_ad": { "type": "boolean", "example": false }, "commerce_info": { "type": "object", "properties": { "adv_promotable": { "type": "object" }, "auction_ad_invited": { "type": "object" }, "branded_content_type": { "type": "object" }, "is_diversion_ad": { "type": "object" }, "organic_log_extra": { "type": "object" }, "with_comment_filter_words": { "type": "object" } } }, "commercial_video_info": { "type": "string", "example": "" }, "item_comment_settings": { "type": "integer", "example": 0 }, "mentioned_users": { "type": "string", "example": "6532035046562332674" }, "author": { "type": "object", "properties": { "id": { "type": "object" }, "unique_id": { "type": "object" }, "nickname": { "type": "object" }, "avatar": { "type": "object" } } }, "is_nff_or_nr": { "type": "boolean", "example": false }, "is_top": { "type": "integer", "example": 0 } } } }, "cursor": { "type": "string", "example": "1791584711583" }, "hasMore": { "type": "boolean", "example": true } } } } }, "example": { "code": 0, "provider": "https://shortvidapi.com", "status": "ok", "msg": "success", "data": { "videos": [ { "aweme_id": "v15044gf0000dbj5qpfog65strb9nsc0", "video_id": "7702947070604332319", "region": "US", "title": "already planning next halloween? 👀🎃 take notes from @Mason Smith. find more DIY inspo on TikTok.", "content_desc": [], "cover": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/o0MgwFCRVDqH5jE2uAADA0yEIfcX7fEE9PQAlA~tplv-tiktokx-cropcenter:300:400.jpeg?dr=10399&refresh_token=8a000905&x-expires=1793631600&x-signature=%2B14gOseSjg82%...", "ai_dynamic_cover": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/o0MgwFCRVDqH5jE2uAADA0yEIfcX7fEE9PQAlA~tplv-tiktokx-origin.image?dr=10395&refresh_token=a2b2e40e&x-expires=1793631600&x-signature=Ha14D7SOKvvXidOmAJKSbU0XqX...", "origin_cover": "https://p19-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/oom34f8ERQ3AZVsf53QCa0DqazwFEEllBAA1X5~tplv-tiktokx-360p.webp?dr=10375&refresh_token=930ca11e&x-expires=1793631600&x-signature=tJg50cTT9toOSuuG1e%2B3DsgebcI...", "duration": 43, "play": "https://v16m.tiktokcdn-eu.com/2fcf9572312c0c44acc748dfaeba1aec/6ae8a880/video/tos/alisg/tos-alisg-ve-37c799-sg/oglE3HF54QDrl5gA1whAfaE3qMIIRe0EVN3luB/?a=1233&bti=M0BzOTg7QGo6OjZALnAjLTAzYCMxNDNg&&bt=1277&ft=aXW-TQc6UEefu...", "wmplay": "https://v16m.tiktokcdn-eu.com/25390ecc1288064f4181a68f4f1f4d5c/6ae8a880/video/tos/alisg/tos-alisg-ve-37c799-sg/ogGM8KiEIiA1yVcftXiqm3zbYb6a5CA7BAyIQ8/?a=1233&bti=M0BzOTg7QGo6OjZALnAjLTAzYCMxNDNg&&bt=1172&ft=aXW-TQc6UEefu...", "size": 7086434, "wm_size": 6501323, "music": "https://sf16-music.tiktokcdn-eu.com/obj/ies-music-tx2/7703208257951353631.mp3", "music_info": { "id": "7702947082445114142", "title": "original sound - tiktok", "play": "https://sf16-music.tiktokcdn-eu.com/obj/ies-music-tx2/7703208257951353631.mp3", "cover": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=10399&refresh_token=6b6577e4&x-expires=1793631600&x-signature=YlliRM8d9eEKmusLK%2Fdv...", "author": "TikTok", "original": true, "duration": 43, "album": "", "create_time": 1793482139 }, "play_count": 108971, "digg_count": 1808, "comment_count": 489, "share_count": 154, "download_count": 3, "collect_count": 163, "create_time": 1793482137, "anchors": null, "anchors_extras": "", "is_ad": false, "commerce_info": { "adv_promotable": false, "auction_ad_invited": false, "branded_content_type": 0, "is_diversion_ad": 0, "organic_log_extra": "{\"req_id\":\"20261101231220C500F1DBD61147C8A143\"}", "with_comment_filter_words": false }, "commercial_video_info": "", "item_comment_settings": 0, "mentioned_users": "6532035046562332674", "author": { "id": "107955", "unique_id": "tiktok", "nickname": "TikTok", "avatar": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:300:300.jpeg?dr=10397&refresh_token=3dcaab0a&x-expires=1793631600&x-signature=wXV%2FXqJt4HyHzp%2Fyq6L6..." }, "is_nff_or_nr": false, "is_top": 0 }, { "aweme_id": "v15044gf0000dbf4vl7og65thduibd60", "video_id": "7700680369246358815", "region": "US", "title": "TikTok asked. @Aston Martin Aramco F1 Team answered. 🏎️🏁 @allena holzworth goes behind the scenes in the garage at Austin for Search Files. 🔎", "content_desc": [ "TikTok asked. @Aston Martin Aramco F1 Team answered. 🏎️🏁", "" ], "cover": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/ooAASpEQIEAqKN3fpUFVeCGcWAA42EAIDClRAk~tplv-tiktokx-cropcenter:300:400.jpeg?dr=10399&refresh_token=002536a1&x-expires=1793631600&x-signature=xh4IfCOr0uV14gu...", "ai_dynamic_cover": "https://p19-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/ooAASpEQIEAqKN3fpUFVeCGcWAA42EAIDClRAk~tplv-tiktokx-origin.image?dr=10395&refresh_token=95d86332&x-expires=1793631600&x-signature=7ujRC8Uig9vFIKJIPg%2F4FcMe...", "origin_cover": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/osVuQ8aIADEfLAhiYovCfFB7fIq9UQvFjJvptD~tplv-tiktokx-360p.webp?dr=10375&refresh_token=5aafbff5&x-expires=1793631600&x-signature=hl2CIieoUnyu2esFUX%2FcQmkbpsc...", "duration": 74, "play": "https://v16m.tiktokcdn-eu.com/6b2fb045eb13748d12465ebd6961031b/6ae8a89f/video/tos/alisg/tos-alisg-ve-37c799-sg/owCbAUavXFmTFIJgQVED7DfYIhoVAfpvIqeULj/?a=1233&bti=M0BzOTg7QGo6OjZALnAjLTAzYCMxNDNg&&bt=1068&ft=aXW-TQc6UEefu...", "wmplay": "https://v16m.tiktokcdn-eu.com/d661022d8bedaa22b21ce2a21f349f29/6ae8a89f/video/tos/alisg/tos-alisg-ve-37c799-sg/o44kevTAgBKgetAtYSYpoWiCeAH9CUNgTvhiee/?a=1233&bti=M0BzOTg7QGo6OjZALnAjLTAzYCMxNDNg&&bt=984&ft=aXW-TQc6UEefub...", "size": 10236652, "wm_size": 9432622, "music": "https://sf19-music.tiktokcdn-eu.com/obj/ies-music-ttp-dup-us/tx27700680424468515614.mp3", "music_info": { "id": "7700680397922814751", "title": "original sound - tiktok", "play": "https://sf19-music.tiktokcdn-eu.com/obj/ies-music-ttp-dup-us/tx27700680424468515614.mp3", "cover": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=10399&refresh_token=6b6577e4&x-expires=1793631600&x-signature=YlliRM8d9eEKmusLK%2Fdv...", "author": "TikTok", "original": true, "duration": 74, "album": "", "create_time": 1792954383 }, "play_count": 741457, "digg_count": 7598, "comment_count": 3371, "share_count": 828, "download_count": 30, "collect_count": 740, "create_time": 1792954380, "anchors": null, "anchors_extras": "", "is_ad": false, "commerce_info": { "adv_promotable": false, "auction_ad_invited": false, "branded_content_type": 0, "is_diversion_ad": 0, "organic_log_extra": "{\"req_id\":\"20261101231220C500F1DBD61147C8A143\"}", "with_comment_filter_words": false }, "commercial_video_info": "", "item_comment_settings": 0, "mentioned_users": "6825494616634442757,6781477132889654277", "author": { "id": "107955", "unique_id": "tiktok", "nickname": "TikTok", "avatar": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:300:300.jpeg?dr=10397&refresh_token=3dcaab0a&x-expires=1793631600&x-signature=wXV%2FXqJt4HyHzp%2Fyq6L6..." }, "is_nff_or_nr": true, "is_top": 0 } ], "cursor": "1791584711583", "hasMore": true } } } } }, "400": { "description": "Invalid parameters, or API key placed in the URL query string (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid `x-api-key` header (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Insufficient credit balance (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Account disabled (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Unknown endpoint or disabled unstable endpoint (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "405": { "description": "Method not allowed — all `/v1/*` data endpoints use `GET` (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded (not charged). Respect the `Retry-After` header.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Temporary upstream or gateway error (not charged). Retry with exponential backoff.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/user/search": { "get": { "operationId": "v1_user_search", "tags": [ "Users" ], "summary": "Search creator accounts", "description": "Discover TikTok creators by keyword with optional filters for follower tier and verification status. Paginated via `cursor` and `has_more`.", "parameters": [ { "name": "keywords", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Search keywords or username query.", "example": "ai" }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "default": 0 }, "description": "Pagination cursor (`0` for first page, then pass `data.cursor`).", "example": 0 }, { "name": "follower_count", "in": "query", "required": false, "schema": { "type": "integer", "enum": [ 0, 1, 2, 3, 4 ], "default": 0 }, "description": "Follower count tier: `0` = Any, `1` = 0–1K, `2` = 1K–10K, `3` = 10K–100K, `4` = 100K+.", "example": 0 }, { "name": "profile_type", "in": "query", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ], "default": 0 }, "description": "Verification filter: `0` = Any, `1` = Verified accounts only.", "example": 0 }, { "name": "search_emphasis", "in": "query", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ], "default": 0 }, "description": "Search scope: `0` = General, `1` = Username match only.", "example": 0 } ], "x-price-per-request": "$0.10 / 1K users", "x-credits-per-request": "1 Credit / user (min 10 Credits)", "responses": { "200": { "description": "Success (`code === 0`). Charged according to the endpoint credit rate.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "example": 0 }, "provider": { "type": "string", "example": "https://shortvidapi.com" }, "status": { "type": "string", "example": "ok" }, "msg": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "user_list": { "type": "array", "items": { "type": "object", "properties": { "user": { "type": "object", "properties": { "id": { "type": "object" }, "region": { "type": "object" }, "uniqueId": { "type": "object" }, "nickname": { "type": "object" }, "avatarThumb": { "type": "object" }, "avatarMedium": { "type": "object" }, "avatarLarger": { "type": "object" }, "signature": { "type": "object" }, "verified": { "type": "object" }, "secUid": { "type": "object" }, "secret": { "type": "object" }, "ftc": { "type": "object" }, "relation": { "type": "object" }, "openFavorite": { "type": "object" }, "commentSetting": { "type": "object" }, "duetSetting": { "type": "object" }, "stitchSetting": { "type": "object" }, "privateAccount": { "type": "object" }, "isADVirtual": { "type": "object" }, "isUnderAge18": { "type": "object" }, "ins_id": { "type": "object" }, "twitter_id": { "type": "object" }, "youtube_channel_title": { "type": "object" }, "youtube_channel_id": { "type": "object" } } }, "stats": { "type": "object", "properties": { "followingCount": { "type": "object" }, "followerCount": { "type": "object" }, "heartCount": { "type": "object" }, "videoCount": { "type": "object" }, "diggCount": { "type": "object" }, "heart": { "type": "object" } } } } } }, "cursor": { "type": "integer", "example": 10 }, "hasMore": { "type": "boolean", "example": true } } } } }, "example": { "code": 0, "provider": "https://shortvidapi.com", "status": "ok", "msg": "success", "data": { "user_list": [ { "user": { "id": "7256182609359995947", "region": "CA", "uniqueId": "chatgpt", "nickname": "ChatGPT", "avatarThumb": "https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/6b496d6f58e4c8f0bd673b794f72074b~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my&ps=13740610&refresh_token=be866962&shcp=c1333...", "avatarMedium": "https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/6b496d6f58e4c8f0bd673b794f72074b~tplv-tiktokx-cropcenter:720:720.webp?dr=14579&refresh_token=59bd7ce1&x-expires=1793631600&x-signature=SxAMOUk5WsFU5Y24xQsQsacYxBM...", "avatarLarger": "https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/6b496d6f58e4c8f0bd673b794f72074b~tplv-tiktokx-cropcenter:1080:1080.webp?dr=14579&refresh_token=8a375031&x-expires=1793631600&x-signature=Iprj7xQFDR0oayzEnnB5qX2Od...", "signature": "What can I help you with?", "verified": true, "secUid": "MS4wLjABAAAAT4vq3vsh9X-Vb_WtV6tz4QWTbKjliTKCiK5DqnJNtQEA2RUveHb7UdnL7xgPK2HB", "secret": false, "ftc": false, "relation": 0, "openFavorite": null, "commentSetting": 0, "duetSetting": 0, "stitchSetting": 0, "privateAccount": false, "isADVirtual": false, "isUnderAge18": false, "ins_id": "", "twitter_id": "", "youtube_channel_title": "", "youtube_channel_id": "" }, "stats": { "followingCount": 1, "followerCount": 4126664, "heartCount": 20562859, "videoCount": 877, "diggCount": 3713, "heart": 20562859 } }, { "user": { "id": "7544448951454860310", "region": "SS", "uniqueId": "ai602509", "nickname": "AI", "avatarThumb": "https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ee6d1b1c5d90b01fe46fd551b3d94fb7~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my&ps=13740610&refresh_token=bd30b55d&shcp=c1333...", "avatarMedium": "https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ee6d1b1c5d90b01fe46fd551b3d94fb7~tplv-tiktokx-cropcenter:720:720.webp?dr=14579&refresh_token=08be7ce2&x-expires=1793631600&x-signature=wT8CYSBimiXvvDhe2l4HJDo5H0M...", "avatarLarger": "https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ee6d1b1c5d90b01fe46fd551b3d94fb7~tplv-tiktokx-cropcenter:1080:1080.webp?dr=14579&refresh_token=d9744b28&x-expires=1793631600&x-signature=NVxDYdyrJ61Gj3eijzXE%2FpH...", "signature": "🎬 كل شيء هنا للضحك والترفيه – خذ الأمور بروح مرحة", "verified": false, "secUid": "MS4wLjABAAAApoqiVd0O_Fh8Zpz4LnMS9BNoWWOBKJZQaHA6FJamjtmOBxR1jNmz-vFZV5FJJy6H", "secret": false, "ftc": false, "relation": 0, "openFavorite": null, "commentSetting": 0, "duetSetting": 0, "stitchSetting": 0, "privateAccount": false, "isADVirtual": false, "isUnderAge18": false, "ins_id": "", "twitter_id": "", "youtube_channel_title": "", "youtube_channel_id": "" }, "stats": { "followingCount": 1967, "followerCount": 186838, "heartCount": 851938, "videoCount": 357, "diggCount": 4489, "heart": 851938 } } ], "cursor": 10, "hasMore": true } } } } }, "400": { "description": "Invalid parameters, or API key placed in the URL query string (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid `x-api-key` header (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Insufficient credit balance (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Account disabled (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Unknown endpoint or disabled unstable endpoint (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "405": { "description": "Method not allowed — all `/v1/*` data endpoints use `GET` (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded (not charged). Respect the `Retry-After` header.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Temporary upstream or gateway error (not charged). Retry with exponential backoff.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/user/followers": { "get": { "operationId": "v1_user_followers", "tags": [ "Followers" ], "summary": "Get user followers list", "description": "Paginated list of accounts following a creator (`data.followers`), up to 200 per request. First retrieve `user_id` and `sec_uid` from `/v1/user/info`, then pass `data.min_time` as `time` for subsequent pages.", "parameters": [ { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Numeric TikTok user ID (`data.user.id` from `/v1/user/info`).", "example": "107955" }, { "name": "sec_uid", "in": "query", "required": false, "schema": { "type": "string" }, "description": "SecUID (`data.user.secUid` from `/v1/user/info`). Recommended for reliability.", "example": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "description": "Number of followers per request (max 200).", "example": 50 }, { "name": "time", "in": "query", "required": false, "schema": { "type": "integer", "default": 0 }, "description": "Pagination timestamp cursor (`0` for first page, then pass `data.min_time`).", "example": 0 } ], "x-price-per-request": "$0.10 / 1K followers", "x-credits-per-request": "1 Credit / user (min 10 Credits)", "responses": { "200": { "description": "Success (`code === 0`). Charged according to the endpoint credit rate.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "example": 0 }, "provider": { "type": "string", "example": "https://shortvidapi.com" }, "status": { "type": "string", "example": "ok" }, "msg": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "followers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "example": "6782809870465172485" }, "region": { "type": "string", "example": "PS" }, "sec_uid": { "type": "string", "example": "MS4wLjABAAAAq_oKv4404vX0z9ChJtoRP9W4HPc9WtPDjAeKgzHpSQymtyteFk1CLl8MORO6g7wT" }, "unique_id": { "type": "string", "example": "motazalsalol01" }, "nickname": { "type": "string", "example": "﮼معتزالسلول  📮" }, "signature": { "type": "string", "example": "معرض السلول فون 📱\n📍عنوانا النصيرات الدوار العام مقابل بوظة حمادة \nللتواصل 📞 / 0599380830\nللتواصل 📞 / 0598703440 \nاهلاً وسهلاً بجميع 🌹" }, "avatar": { "type": "string", "example": "https://p19-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/15e68b96ec96386c64e240803db1bc19~tplv-tiktokx-cropcenter:300:300.jpeg?dr=9638&refresh_token=0bfeb7e0" }, "verified": { "type": "boolean", "example": false }, "secret": { "type": "boolean", "example": false }, "aweme_count": { "type": "integer", "example": 92 }, "following_count": { "type": "integer", "example": 73 }, "follower_count": { "type": "integer", "example": 3967 }, "favoriting_count": { "type": "integer", "example": 9583 }, "total_favorited": { "type": "integer", "example": 7806 }, "ins_id": { "type": "string", "example": "" }, "youtube_channel_title": { "type": "string", "example": "" }, "youtube_channel_id": { "type": "string", "example": "" }, "twitter_name": { "type": "string", "example": "" }, "twitter_id": { "type": "string", "example": "" }, "language": { "type": "string", "example": "ar" }, "create_time": { "type": "integer", "example": 1579321314 } } } }, "total": { "type": "integer", "example": 96502582 }, "time": { "type": "integer", "example": 1793545936 }, "hasMore": { "type": "boolean", "example": true } } } } }, "example": { "code": 0, "provider": "https://shortvidapi.com", "status": "ok", "msg": "success", "data": { "followers": [ { "id": "6782809870465172485", "region": "PS", "sec_uid": "MS4wLjABAAAAq_oKv4404vX0z9ChJtoRP9W4HPc9WtPDjAeKgzHpSQymtyteFk1CLl8MORO6g7wT", "unique_id": "motazalsalol01", "nickname": "﮼معتزالسلول  📮", "signature": "معرض السلول فون 📱\n📍عنوانا النصيرات الدوار العام مقابل بوظة حمادة \nللتواصل 📞 / 0599380830\nللتواصل 📞 / 0598703440 \nاهلاً وسهلاً بجميع 🌹", "avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/15e68b96ec96386c64e240803db1bc19~tplv-tiktokx-cropcenter:300:300.jpeg?dr=9638&refresh_token=0bfeb7e0&x-expires=1793631600&x-signature=h5vsQptkJC%2FoXG%2BQDDmY79...", "verified": false, "secret": false, "aweme_count": 92, "following_count": 73, "follower_count": 3967, "favoriting_count": 9583, "total_favorited": 7806, "ins_id": "", "youtube_channel_title": "", "youtube_channel_id": "", "twitter_name": "", "twitter_id": "", "language": "ar", "create_time": 1579321314 }, { "id": "7372857277890036741", "region": "IQ", "sec_uid": "MS4wLjABAAAAjiPgegdgggF2Io2XyBLDcX9OshIK2qmlxYpVcHQ26dcmEPcGp69GkznFts5WPJNM", "unique_id": "ugnvnb", "nickname": "😅:✘1:٭♯ آلَشُکْر ↯✘ ˹🇧🇷1", "signature": "ro__®io", "avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/ca75058eaeb62bcea6cc8f17dd831628~tplv-tiktokx-cropcenter:300:300.jpeg?dr=9638&refresh_token=11621a79&x-expires=1793631600&x-signature=FHDRGYx90HXoqv%2BmGOzr9DBR...", "verified": false, "secret": false, "aweme_count": 126, "following_count": 4319, "follower_count": 1818, "favoriting_count": 27706, "total_favorited": 11170, "ins_id": "", "youtube_channel_title": "", "youtube_channel_id": "", "twitter_name": "", "twitter_id": "", "language": "ar", "create_time": 1716627383 } ], "total": 96502582, "time": 1793545936, "hasMore": true } } } } }, "400": { "description": "Invalid parameters, or API key placed in the URL query string (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid `x-api-key` header (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Insufficient credit balance (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Account disabled (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Unknown endpoint or disabled unstable endpoint (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "405": { "description": "Method not allowed — all `/v1/*` data endpoints use `GET` (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded (not charged). Respect the `Retry-After` header.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Temporary upstream or gateway error (not charged). Retry with exponential backoff.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/user/following": { "get": { "operationId": "v1_user_following", "tags": [ "Followers" ], "summary": "Get user following list", "description": "Paginated list of accounts that a creator follows (`data.followings`), up to 200 per request. Pass `data.min_time` as `time` for subsequent pages.", "parameters": [ { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Numeric TikTok user ID (`data.user.id` from `/v1/user/info`).", "example": "107955" }, { "name": "sec_uid", "in": "query", "required": false, "schema": { "type": "string" }, "description": "SecUID (`data.user.secUid` from `/v1/user/info`).", "example": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "description": "Number of accounts per request (max 200).", "example": 50 }, { "name": "time", "in": "query", "required": false, "schema": { "type": "integer", "default": 0 }, "description": "Pagination timestamp cursor (`0` for first page, then pass `data.min_time`).", "example": 0 } ], "x-price-per-request": "$0.10 / 1K followings", "x-credits-per-request": "1 Credit / user (min 10 Credits)", "responses": { "200": { "description": "Success (`code === 0`). Charged according to the endpoint credit rate.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "example": 0 }, "provider": { "type": "string", "example": "https://shortvidapi.com" }, "status": { "type": "string", "example": "ok" }, "msg": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "followings": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "example": "6551237489917432832" }, "region": { "type": "string", "example": "US" }, "sec_uid": { "type": "string", "example": "MS4wLjABAAAAXqqA-cLDC0hfQPIrS5APYNsg04zkl-socWCkqkI3UIOaEe6_Qnokg0GcWpLnMNQP" }, "unique_id": { "type": "string", "example": "tiktokcreators" }, "nickname": { "type": "string", "example": "tiktok creators" }, "signature": { "type": "string", "example": "The official account for TikTok Creators who inspire creativity and bring joy ✨\n\n⬇️ Creator Programs 💰⬇️" }, "avatar": { "type": "string", "example": "https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/8a3909f393315b8cf96ea44747b6dfbb~tplv-tiktokx-cropcenter-q:300:300:q70.webp?dr=10793&refresh_token=faf" }, "verified": { "type": "boolean", "example": true }, "secret": { "type": "boolean", "example": false }, "aweme_count": { "type": "integer", "example": 1150 }, "following_count": { "type": "integer", "example": 570 }, "follower_count": { "type": "integer", "example": 8998494 }, "favoriting_count": { "type": "integer", "example": 1920 }, "total_favorited": { "type": "integer", "example": 33848225 }, "ins_id": { "type": "string", "example": "" }, "youtube_channel_title": { "type": "string", "example": "" }, "youtube_channel_id": { "type": "string", "example": "" }, "twitter_name": { "type": "string", "example": "" }, "twitter_id": { "type": "string", "example": "" }, "language": { "type": "string", "example": "en" }, "create_time": { "type": "integer", "example": 1525328841 } } } }, "total": { "type": "integer", "example": 2 }, "time": { "type": "integer", "example": 1447292191 }, "hasMore": { "type": "boolean", "example": false } } } } }, "example": { "code": 0, "provider": "https://shortvidapi.com", "status": "ok", "msg": "success", "data": { "followings": [ { "id": "6551237489917432832", "region": "US", "sec_uid": "MS4wLjABAAAAXqqA-cLDC0hfQPIrS5APYNsg04zkl-socWCkqkI3UIOaEe6_Qnokg0GcWpLnMNQP", "unique_id": "tiktokcreators", "nickname": "tiktok creators", "signature": "The official account for TikTok Creators who inspire creativity and bring joy ✨\n\n⬇️ Creator Programs 💰⬇️", "avatar": "https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/8a3909f393315b8cf96ea44747b6dfbb~tplv-tiktokx-cropcenter-q:300:300:q70.webp?dr=10793&refresh_token=fafdec24&x-expires=1793631600&x-signature=YY3LWKY3BCHg7kgu3FZV0...", "verified": true, "secret": false, "aweme_count": 1150, "following_count": 570, "follower_count": 8998494, "favoriting_count": 1920, "total_favorited": 33848225, "ins_id": "", "youtube_channel_title": "", "youtube_channel_id": "", "twitter_name": "", "twitter_id": "", "language": "en", "create_time": 1525328841 } ], "total": 2, "time": 1447292191, "hasMore": false } } } } }, "400": { "description": "Invalid parameters, or API key placed in the URL query string (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid `x-api-key` header (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Insufficient credit balance (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Account disabled (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Unknown endpoint or disabled unstable endpoint (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "405": { "description": "Method not allowed — all `/v1/*` data endpoints use `GET` (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded (not charged). Respect the `Retry-After` header.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Temporary upstream or gateway error (not charged). Retry with exponential backoff.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/comment/list": { "get": { "operationId": "v1_comment_list", "tags": [ "Comments" ], "summary": "Get top-level video comments", "description": "Paginated top-level comments on a TikTok video (`data.comments`), up to 50 per page, including commenter profile, like count, and reply count.", "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string" }, "description": "TikTok video URL or numeric video ID.", "example": "https://www.tiktok.com/@tiktok/video/7106594312292453675" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 20 }, "description": "Number of comments per page (max 50).", "example": 20 }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "default": 0 }, "description": "Pagination cursor (`0` for first page, then pass `data.cursor`).", "example": 0 } ], "x-price-per-request": "$0.10 / 1K comments", "x-credits-per-request": "1 Credit / comment (min 10 Credits)", "responses": { "200": { "description": "Success (`code === 0`). Charged according to the endpoint credit rate.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "example": 0 }, "provider": { "type": "string", "example": "https://shortvidapi.com" }, "status": { "type": "string", "example": "ok" }, "msg": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "comments": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "example": "7128453658077397765" }, "video_id": { "type": "string", "example": "7106594312292453675" }, "text": { "type": "string", "example": "Tiktok and Minecraft??" }, "images": { "type": "array", "items": { "type": "string" } }, "create_time": { "type": "integer", "example": 1659722471 }, "digg_count": { "type": "integer", "example": 12 }, "reply_total": { "type": "integer", "example": 0 }, "user": { "type": "object", "properties": { "id": { "type": "object" }, "region": { "type": "object" }, "sec_uid": { "type": "object" }, "unique_id": { "type": "object" }, "nickname": { "type": "object" }, "signature": { "type": "object" }, "avatar": { "type": "object" }, "verified": { "type": "object" }, "secret": { "type": "object" }, "aweme_count": { "type": "object" }, "following_count": { "type": "object" }, "follower_count": { "type": "object" }, "favoriting_count": { "type": "object" }, "total_favorited": { "type": "object" }, "ins_id": { "type": "object" }, "youtube_channel_title": { "type": "object" }, "youtube_channel_id": { "type": "object" }, "twitter_name": { "type": "object" }, "twitter_id": { "type": "object" }, "language": { "type": "object" }, "create_time": { "type": "object" } } }, "status": { "type": "integer", "example": 1 } } } }, "total": { "type": "integer", "example": 1269 }, "cursor": { "type": "integer", "example": 5 }, "hasMore": { "type": "boolean", "example": true } } } } }, "example": { "code": 0, "provider": "https://shortvidapi.com", "status": "ok", "msg": "success", "data": { "comments": [ { "id": "7128453658077397765", "video_id": "7106594312292453675", "text": "Tiktok and Minecraft??", "images": [], "create_time": 1659722471, "digg_count": 12, "reply_total": 0, "user": { "id": "6653810561643937797", "region": "CA", "sec_uid": "MS4wLjABAAAAskbqyCl5Kyd95nCiTp4EjUdziGoRqyo_zR7A3MMOvwpq2nDhX86lZ5-IbgGaTCxD", "unique_id": "awwmanbro", "nickname": "a", "signature": "I HATE PRONOUNCE", "avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/37c63c610a9c03e111bb4431f517e766~tplv-tiktokx-cropcenter-q:100:100:q70.jpeg?dr=8835&refresh_token=003e90a8&x-expires=1793631600&x-signature=p46pAELHQYMNet1AdgH...", "verified": false, "secret": false, "aweme_count": 0, "following_count": 0, "follower_count": 0, "favoriting_count": 0, "total_favorited": 0, "ins_id": "", "youtube_channel_title": "", "youtube_channel_id": "", "twitter_name": "", "twitter_id": "", "language": "en", "create_time": 0 }, "status": 1 }, { "id": "7106964370948637446", "video_id": "7106594312292453675", "text": "cool :)", "images": [], "create_time": 1654719091, "digg_count": 13, "reply_total": 0, "user": { "id": "6806667010508997637", "region": "DE", "sec_uid": "MS4wLjABAAAA2wrhCw4hs_2MiC-xsl-_gIIYEPzGtLmyd8SKvX3zX7XYu1HUqyY81Ue0vsSsHehn", "unique_id": "ekohajvaz", "nickname": "Eko H", "signature": "🇧🇦", "avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/3c456338e29e007a56768d4cd45ea115~tplv-tiktokx-cropcenter-q:100:100:q70.jpeg?dr=8835&refresh_token=a1091062&x-expires=1793631600&x-signature=%2FzTP4%2F1RYS5EpRr...", "verified": false, "secret": false, "aweme_count": 0, "following_count": 0, "follower_count": 0, "favoriting_count": 0, "total_favorited": 0, "ins_id": "", "youtube_channel_title": "", "youtube_channel_id": "", "twitter_name": "", "twitter_id": "", "language": "de", "create_time": 0 }, "status": 1 } ], "total": 1269, "cursor": 5, "hasMore": true } } } } }, "400": { "description": "Invalid parameters, or API key placed in the URL query string (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid `x-api-key` header (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Insufficient credit balance (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Account disabled (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Unknown endpoint or disabled unstable endpoint (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "405": { "description": "Method not allowed — all `/v1/*` data endpoints use `GET` (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded (not charged). Respect the `Retry-After` header.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Temporary upstream or gateway error (not charged). Retry with exponential backoff.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/comment/reply": { "get": { "operationId": "v1_comment_reply", "tags": [ "Comments" ], "summary": "Get second-level comment replies", "description": "Paginated nested replies (`data.comments`) under a top-level comment (`comment_id`). Accepts either `url` or `video_id` to identify the video.", "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string" }, "description": "TikTok video URL or numeric video ID (`video_id` is also accepted).", "example": "7106594312292453675" }, { "name": "comment_id", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Top-level comment ID (`id` from `/v1/comment/list`).", "example": "7106598090963878662" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 20 }, "description": "Number of replies per page (max 50).", "example": 20 }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "default": 0 }, "description": "Pagination cursor (`0` for first page, then pass `data.cursor`).", "example": 0 } ], "x-price-per-request": "$0.10 / 1K comments", "x-credits-per-request": "1 Credit / comment (min 10 Credits)", "responses": { "200": { "description": "Success (`code === 0`). Charged according to the endpoint credit rate.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "example": 0 }, "provider": { "type": "string", "example": "https://shortvidapi.com" }, "status": { "type": "string", "example": "ok" }, "msg": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "comments": { "type": "array", "items": { "type": "string" } }, "total": { "type": "integer", "example": 0 }, "cursor": { "type": "integer", "example": 0 }, "hasMore": { "type": "boolean", "example": false } } } } }, "example": { "code": 0, "provider": "https://shortvidapi.com", "status": "ok", "msg": "success", "data": { "comments": [], "total": 0, "cursor": 0, "hasMore": false } } } } }, "400": { "description": "Invalid parameters, or API key placed in the URL query string (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid `x-api-key` header (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Insufficient credit balance (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Account disabled (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Unknown endpoint or disabled unstable endpoint (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "405": { "description": "Method not allowed — all `/v1/*` data endpoints use `GET` (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded (not charged). Respect the `Retry-After` header.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Temporary upstream or gateway error (not charged). Retry with exponential backoff.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/challenge/info": { "get": { "operationId": "v1_challenge_info", "tags": [ "Hashtags" ], "summary": "Get hashtag (challenge) detail & total views", "description": "Look up a hashtag by name to retrieve its numeric `cid` (`data.id`), description, video count (`data.userCount`), and total view count (`data.viewCount`).", "parameters": [ { "name": "challenge_name", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Hashtag name without `#`, e.g. `fyp` or `tiktokmademebuyit`.", "example": "fyp" } ], "x-price-per-request": "$1.00 / 1K requests", "x-credits-per-request": "10 Credits / request", "responses": { "200": { "description": "Success (`code === 0`). Charged according to the endpoint credit rate.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "example": 0 }, "provider": { "type": "string", "example": "https://shortvidapi.com" }, "status": { "type": "string", "example": "ok" }, "msg": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "id": { "type": "string", "example": "229207" }, "cha_name": { "type": "string", "example": "fyp" }, "desc": { "type": "string", "example": "" }, "user_count": { "type": "integer", "example": 881330816 }, "view_count": { "type": "integer", "example": 131052214999855 }, "is_pgcshow": { "type": "boolean", "example": false }, "is_commerce": { "type": "boolean", "example": false }, "is_challenge": { "type": "boolean", "example": false }, "is_strong_music": { "type": "boolean", "example": false }, "type": { "type": "integer", "example": 2 }, "cover": { "type": "string", "example": "" } } } } }, "example": { "code": 0, "provider": "https://shortvidapi.com", "status": "ok", "msg": "success", "data": { "id": "229207", "cha_name": "fyp", "desc": "", "user_count": 881330816, "view_count": 131052214999855, "is_pgcshow": false, "is_commerce": false, "is_challenge": false, "is_strong_music": false, "type": 2, "cover": "" } } } } }, "400": { "description": "Invalid parameters, or API key placed in the URL query string (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid `x-api-key` header (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Insufficient credit balance (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Account disabled (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Unknown endpoint or disabled unstable endpoint (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "405": { "description": "Method not allowed — all `/v1/*` data endpoints use `GET` (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded (not charged). Respect the `Retry-After` header.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Temporary upstream or gateway error (not charged). Retry with exponential backoff.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/challenge/posts": { "get": { "operationId": "v1_challenge_posts", "tags": [ "Hashtags" ], "summary": "Get videos under a hashtag", "description": "Paginated list of videos tagged with a hashtag (`data.videos`), including no-watermark video URLs and engagement stats. Pass `cid` (or `challenge_id`) obtained from `/v1/challenge/info`.", "parameters": [ { "name": "cid", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Numeric hashtag ID (`data.id` from `/v1/challenge/info`; `challenge_id` is also accepted).", "example": "42164" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 30, "default": 20 }, "description": "Number of videos per page (max 30).", "example": 20 }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "default": 0 }, "description": "Pagination cursor (`0` for first page, then pass `data.cursor`).", "example": 0 } ], "x-price-per-request": "$0.20 / 1K videos", "x-credits-per-request": "2 Credits / video (min 10 Credits)", "responses": { "200": { "description": "Success (`code === 0`). Charged according to the endpoint credit rate.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "example": 0 }, "provider": { "type": "string", "example": "https://shortvidapi.com" }, "status": { "type": "string", "example": "ok" }, "msg": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "videos": { "type": "array", "items": { "type": "object", "properties": { "aweme_id": { "type": "string", "example": "v0f044gc0000cn0ijh7og65r84nc68u0" }, "video_id": { "type": "string", "example": "7332187682480590112" }, "region": { "type": "string", "example": "HU" }, "title": { "type": "string", "example": "#fy #foryou #strawberry #chocolate #chocolatecoveredstrawberries " }, "content_desc": { "type": "array", "items": { "type": "string" } }, "cover": { "type": "string", "example": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-euttp/oYZxKA3S6EQEI7Ivc0diTw7EBP8Db2iBBA1Ap~tplv-tiktokx-origin.image?dr=8593&refresh_token=bff7fce" }, "ai_dynamic_cover": { "type": "string", "example": "https://p19-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-euttp/5ca833364b7646c4ac5d2d40ed956269_1707157985~tplv-tiktokx-origin.image?dr=8606&refresh_token=8" }, "origin_cover": { "type": "string", "example": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-euttp/dfab60c9c47d4d949d31ccc7ae9f8501_1707157985~tplv-tiktokx-shrink-aq:360:360:q75.webp?dr=11731&" }, "duration": { "type": "integer", "example": 15 }, "play": { "type": "string", "example": "https://v16m.tiktokcdn-us.com/73462a8573cd5bbf5aa16f7b27f6ffb9/6ae7ab79/video/tos/useast2a/tos-useast2a-ve-68c810-euttp/oYESeGQv2EXWgJllA4g8IUQCfnE2qBDPRD2RwF/?" }, "wmplay": { "type": "string", "example": "https://v16m.tiktokcdn-us.com/73462a8573cd5bbf5aa16f7b27f6ffb9/6ae7ab79/video/tos/useast2a/tos-useast2a-ve-68c810-euttp/oYESeGQv2EXWgJllA4g8IUQCfnE2qBDPRD2RwF/?" }, "size": { "type": "integer", "example": 4913777 }, "wm_size": { "type": "integer", "example": 0 }, "music": { "type": "string", "example": "https://sf16.tiktokcdn-us.com/obj/tos-alisg-ve-2774/oogSQgQME98D1WeddQXBazeYqrXytzFAeTCmFA" }, "music_info": { "type": "object", "properties": { "id": { "type": "object" }, "title": { "type": "object" }, "play": { "type": "object" }, "cover": { "type": "object" }, "author": { "type": "object" }, "original": { "type": "object" }, "duration": { "type": "object" }, "album": { "type": "object" }, "create_time": { "type": "object" } } }, "play_count": { "type": "integer", "example": 482039997 }, "digg_count": { "type": "integer", "example": 52656761 }, "comment_count": { "type": "integer", "example": 706880 }, "share_count": { "type": "integer", "example": 955321 }, "download_count": { "type": "integer", "example": 22185 }, "collect_count": { "type": "integer", "example": 5019806 }, "create_time": { "type": "integer", "example": 1707157982 }, "anchors": { "type": "array", "items": { "type": "object" } }, "anchors_extras": { "type": "string", "example": "" }, "is_ad": { "type": "boolean", "example": false }, "commerce_info": { "type": "object", "properties": { "adv_promotable": { "type": "object" }, "auction_ad_invited": { "type": "object" }, "branded_content_type": { "type": "object" }, "is_diversion_ad": { "type": "object" }, "organic_log_extra": { "type": "object" }, "with_comment_filter_words": { "type": "object" } } }, "commercial_video_info": { "type": "string", "example": "" }, "item_comment_settings": { "type": "integer", "example": 0 }, "mentioned_users": { "type": "string", "example": "" }, "author": { "type": "object", "properties": { "id": { "type": "object" }, "unique_id": { "type": "object" }, "nickname": { "type": "object" }, "avatar": { "type": "object" } } }, "is_nff_or_nr": { "type": "boolean", "example": false }, "is_top": { "type": "integer", "example": 0 } } } }, "cursor": { "type": "integer", "example": 5 }, "hasMore": { "type": "boolean", "example": true } } } } }, "example": { "code": 0, "provider": "https://shortvidapi.com", "status": "ok", "msg": "success", "data": { "videos": [ { "aweme_id": "v0f044gc0000cn0ijh7og65r84nc68u0", "video_id": "7332187682480590112", "region": "HU", "title": "#fy #foryou #strawberry #chocolate #chocolatecoveredstrawberries ", "content_desc": [], "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-euttp/oYZxKA3S6EQEI7Ivc0diTw7EBP8Db2iBBA1Ap~tplv-tiktokx-origin.image?dr=8593&refresh_token=bff7fcea&x-expires=1793631600&x-signature=CLUQRkt%2BRPDruXa2hG5pfBQ...", "ai_dynamic_cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-euttp/5ca833364b7646c4ac5d2d40ed956269_1707157985~tplv-tiktokx-origin.image?dr=8606&refresh_token=83182dad&x-expires=1793631600&x-signature=C2jc%2FJ38P%2BWQckd...", "origin_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-euttp/dfab60c9c47d4d949d31ccc7ae9f8501_1707157985~tplv-tiktokx-shrink-aq:360:360:q75.webp?dr=11731&refresh_token=259059fb&x-expires=1793631600&x-signature=5D8L...", "duration": 15, "play": "https://v16m.tiktokcdn-us.com/73462a8573cd5bbf5aa16f7b27f6ffb9/6ae7ab79/video/tos/useast2a/tos-useast2a-ve-68c810-euttp/oYESeGQv2EXWgJllA4g8IUQCfnE2qBDPRD2RwF/?a=1233&bti=Ojs2NGYpQHM6OjZALjU2OmQvcCMxNDNg&&bt=2555&ft=H3YM...", "wmplay": "https://v16m.tiktokcdn-us.com/73462a8573cd5bbf5aa16f7b27f6ffb9/6ae7ab79/video/tos/useast2a/tos-useast2a-ve-68c810-euttp/oYESeGQv2EXWgJllA4g8IUQCfnE2qBDPRD2RwF/?a=1233&bti=Ojs2NGYpQHM6OjZALjU2OmQvcCMxNDNg&&bt=2555&ft=H3YM...", "size": 4913777, "wm_size": 0, "music": "https://sf16.tiktokcdn-us.com/obj/tos-alisg-ve-2774/oogSQgQME98D1WeddQXBazeYqrXytzFAeTCmFA", "music_info": { "id": "7055205517962004482", "title": "What You Won't Do for Love", "play": "https://sf16.tiktokcdn-us.com/obj/tos-alisg-ve-2774/oogSQgQME98D1WeddQXBazeYqrXytzFAeTCmFA", "cover": "https://p16-common.tiktokcdn-us.com/tos-alisg-v-2774/o4EQSVVsDG6Avg8Ce8LAASQIzFufAsXeaACQAX~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9584&t=4d5b0474&ps=933b5bde&shp=08d74b56&shcp=d05b14bd&idc=useast8", "author": "Bobby Caldwell", "original": false, "duration": 60, "album": "What You Won't Do for Love", "create_time": 1642668073 }, "play_count": 482039997, "digg_count": 52656761, "comment_count": 706880, "share_count": 955321, "download_count": 22185, "collect_count": 5019806, "create_time": 1707157982, "anchors": [ { "actions": [ { "action_type": 1, "icon": { "height": 720, "uri": "tiktok-obj/28px_primary_create_onDark3x.png", "url_list": [ "https://p16-common.tiktokcdn-us.com/tiktok-obj/28px_primary_create_onDark3x.png~tplv-tiktokx-origin.image?biz_tag=anchor.effect&dr=9580&idc=useast8&ps=933b5bde&shcp=34ff8df6&shp=d05b14bd&t=4d5b0474", "https://p19-common.tiktokcdn-us.com/tiktok-obj/28px_primary_create_onDark3x.png~tplv-tiktokx-origin.image?biz_tag=anchor.effect&dr=9580&idc=useast8&ps=933b5bde&shcp=34ff8df6&shp=d05b14bd&t=4d5b0474" ], "url_prefix": null, "width": 720 }, "schema": "shoot" } ], "anchor_strong": null, "component_key": "anchor_effect", "description": "Effects", "extra": "{\"effect_source\":1,\"is_commerce\":0,\"resource_id\":7272808536017474049}", "icon": { "height": 720, "uri": "tiktok-obj/20px_anchor_effect3x.png", "url_list": [ "https://p16-common.tiktokcdn-us.com/tiktok-obj/20px_anchor_effect3x.png~tplv-tiktokx-origin.image?biz_tag=anchor.effect&dr=9580&idc=useast8&ps=933b5bde&shcp=34ff8df6&shp=d05b14bd&t=4d5b0474", "https://p19-common.tiktokcdn-us.com/tiktok-obj/20px_anchor_effect3x.png~tplv-tiktokx-origin.image?biz_tag=anchor.effect&dr=9580&idc=useast8&ps=933b5bde&shcp=34ff8df6&shp=d05b14bd&t=4d5b0474" ], "url_prefix": null, "width": 720 }, "id": "75062512", "keyword": "mustache + goatee", "log_extra": "{\"anchor_id\":\"75063345\",\"anchor_name\":\"mustache + goatee\",\"anchor_type\":\"prop\",\"has_friends_info\":\"0\"}", "thumbnail": { "height": 64, "uri": "ff74e6fbf86b6789d3b5356a37127f94", "url_list": [ "https://lf16-effectcdn-us.tiktokcdn-us.com/obj/tiktok-loki-effect-oracle-tx/ff74e6fbf86b6789d3b5356a37127f94", "https://lf19-effectcdn-us.tiktokcdn-us.com/obj/tiktok-loki-effect-oracle-tx/ff74e6fbf86b6789d3b5356a37127f94" ], "url_prefix": null, "width": 64 }, "type": 28 } ], "anchors_extras": "", "is_ad": false, "commerce_info": { "adv_promotable": false, "auction_ad_invited": false, "branded_content_type": 0, "is_diversion_ad": 0, "organic_log_extra": "{\"req_id\":\"20261101151313DDF5CD799BDF5B92AC61\"}", "with_comment_filter_words": false }, "commercial_video_info": "", "item_comment_settings": 0, "mentioned_users": "", "author": { "id": "6562214517467398150", "unique_id": "pr4yforgabs", "nickname": "gabs", "avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/395b773aac8948b144c158622774ee85~tplv-tiktokx-cropcenter:300:300.jpeg?dr=9638&refresh_token=dc3c293d&x-expires=1793631600&x-signature=ToemEje2vG7a8X5dBQG6%2BOY..." }, "is_nff_or_nr": false, "is_top": 0 }, { "aweme_id": "v10025g50000cq7ptovog65s4l9457l0", "video_id": "7298305522623679752", "region": "GE", "title": "🤍🤍 #foryou #fyp #teacher #school #suprise #foryou. @Daviti Lapia @NIAKO @3️⃣ @🎀 @BABIKO✨ @datuniap @goginashvilivano @:)) @მარიამ გაბოძე @salii｡◕‿◕｡❤️ ", "content_desc": [], "cover": "https://p19-common-sign.tiktokcdn-us.com/tos-alisg-p-0037/o0tBa7mQPqPDiBSngjQu5fEPFCAVeCj4TUFSEI~tplv-tiktokx-origin.image?dr=8593&refresh_token=c9b130b3&x-expires=1793631600&x-signature=ofQQVEsfjHK6UHToxGyH4vQm%2FPs%3D&...", "ai_dynamic_cover": "https://p19-common-sign.tiktokcdn-us.com/tos-alisg-p-0037/8c59a8421b2c4aa49eef87d390e36cde_1720688361~tplv-tiktokx-origin.image?dr=8606&refresh_token=bc727a16&x-expires=1793631600&x-signature=zJrn6q85oGolZzvdLzf2onxLNxs%...", "origin_cover": "https://p19-common-sign.tiktokcdn-us.com/tos-alisg-p-0037/9ba198bbe4444e9489459f22105062d5_1720688361~tplv-tiktokx-shrink-aq:360:360:q75.webp?dr=11731&refresh_token=b014cb1b&x-expires=1793631600&x-signature=JRix9X4GVvKk2...", "duration": 29, "play": "https://v16m.tiktokcdn-us.com/42f557175587e47ee03d89a031424143/6ae7ab87/video/tos/alisg/tos-alisg-pve-0037/o4wGCi8JzArwnnx8ABAMCqRRiQ9IoEfKuBVJPq/?a=1233&bti=Ojs2NGYpQHM6OjZALjU2OmQvcCMxNDNg&&bt=1869&ft=H3YMyvShQBKUxsurI...", "wmplay": "https://v16m.tiktokcdn-us.com/4a4834b35a39861b2dde6c40441b1153/6ae7ab87/video/tos/alisg/tos-alisg-ve-37c815-sg/o8CfrFMeHRz833YI8KmpgGHQARhXAENUDiAAe9/?a=1233&bti=Ojs2NGYpQHM6OjZALjU2OmQvcCMxNDNg&&bt=1929&ft=H3YMyvShQBKUx...", "size": 6996047, "wm_size": 7219949, "music": "https://sf19.tiktokcdn-us.com/obj/tiktok-obj/7670457892893412097.mp3", "music_info": { "id": "7298800894435412742", "title": "original sound - metropolesoficial", "play": "https://sf19.tiktokcdn-us.com/obj/tiktok-obj/7670457892893412097.mp3", "cover": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/9cd5e3d299591426ac369cf36bfc8ebb~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=af1ad665&x-expires=1793631600&x-signature=3%2Bqr1IzN0%2BrcAGt59cr...", "author": "Metrópoles Oficial", "original": true, "duration": 29, "album": "", "create_time": 1699384516 }, "play_count": 404239046, "digg_count": 51156433, "comment_count": 210031, "share_count": 783091, "download_count": 326321, "collect_count": 3999134, "create_time": 1699269177, "anchors": null, "anchors_extras": "", "is_ad": false, "commerce_info": { "adv_promotable": false, "auction_ad_invited": false, "branded_content_type": 0, "is_diversion_ad": 0, "organic_log_extra": "{\"req_id\":\"20261101151313DDF5CD799BDF5B92AC61\"}", "with_comment_filter_words": false }, "commercial_video_info": "", "item_comment_settings": 0, "mentioned_users": "7072025214167729154,6899451809129317378,7048569851320812546,7035535354140558342,6812569331823494150,6676773655315858438,7129818582913614853,6911560059478639622,6757232692981384198,6978495405349274629", "author": { "id": "6976560351085904898", "unique_id": "metrevelisalii", "nickname": "Salome", "avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/f30095f4181b5f29f0ac7fede2296168~tplv-tiktokx-cropcenter:300:300.jpeg?dr=9638&refresh_token=49268ce7&x-expires=1793631600&x-signature=djtaovzk08NYoSi5UvSWWsUZTj..." }, "is_nff_or_nr": false, "is_top": 0 } ], "cursor": 5, "hasMore": true } } } } }, "400": { "description": "Invalid parameters, or API key placed in the URL query string (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid `x-api-key` header (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Insufficient credit balance (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Account disabled (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Unknown endpoint or disabled unstable endpoint (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "405": { "description": "Method not allowed — all `/v1/*` data endpoints use `GET` (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded (not charged). Respect the `Retry-After` header.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Temporary upstream or gateway error (not charged). Retry with exponential backoff.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/music/info": { "get": { "operationId": "v1_music_info", "tags": [ "Music" ], "summary": "Get sound / music track detail", "description": "Retrieve metadata for a TikTok sound or original audio track (`data.id`, `data.title`, `data.author`, `data.play` MP3 URL, `data.video_count`).", "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string" }, "description": "TikTok music URL or numeric music ID.", "example": "7106594322274962182" } ], "x-price-per-request": "$1.00 / 1K requests", "x-credits-per-request": "10 Credits / request", "responses": { "200": { "description": "Success (`code === 0`). Charged according to the endpoint credit rate.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "example": 0 }, "provider": { "type": "string", "example": "https://shortvidapi.com" }, "status": { "type": "string", "example": "ok" }, "msg": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "id": { "type": "string", "example": "7231338505431288622" }, "title": { "type": "string", "example": "original sound - tiktok" }, "play": { "type": "string", "example": "https://sf16.tiktokcdn-us.com/obj/ies-music-tx/7231338526456204078.mp3" }, "cover": { "type": "string", "example": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:720:720.webp?dr=9640&refresh_token=ca6" }, "author": { "type": "string", "example": "TikTok" }, "original": { "type": "boolean", "example": true }, "duration": { "type": "integer", "example": 60 }, "album": { "type": "string", "example": "" }, "video_count": { "type": "integer", "example": 62 } } } } }, "example": { "code": 0, "provider": "https://shortvidapi.com", "status": "ok", "msg": "success", "data": { "id": "7231338505431288622", "title": "original sound - tiktok", "play": "https://sf16.tiktokcdn-us.com/obj/ies-music-tx/7231338526456204078.mp3", "cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:720:720.webp?dr=9640&refresh_token=ca68001c&x-expires=1793631600&x-signature=2Rr2EsKYe6FbH3Vbm1uxH...", "author": "TikTok", "original": true, "duration": 60, "album": "", "video_count": 62 } } } } }, "400": { "description": "Invalid parameters, or API key placed in the URL query string (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid `x-api-key` header (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Insufficient credit balance (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Account disabled (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Unknown endpoint or disabled unstable endpoint (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "405": { "description": "Method not allowed — all `/v1/*` data endpoints use `GET` (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded (not charged). Respect the `Retry-After` header.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Temporary upstream or gateway error (not charged). Retry with exponential backoff.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/music/posts": { "get": { "operationId": "v1_music_posts", "tags": [ "Music" ], "summary": "Get videos using a sound / music track", "description": "Paginated list of videos that use a specific sound (`data.videos`), including no-watermark playback streams and stats.", "parameters": [ { "name": "music_id", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Numeric music ID (`data.id` from `/v1/music/info`).", "example": "7106594322274962182" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 30, "default": 20 }, "description": "Number of videos per page (max 30).", "example": 20 }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "default": 0 }, "description": "Pagination cursor (`0` for first page, then pass `data.cursor`).", "example": 0 } ], "x-price-per-request": "$0.20 / 1K videos", "x-credits-per-request": "2 Credits / video (min 10 Credits)", "responses": { "200": { "description": "Success (`code === 0`). Charged according to the endpoint credit rate.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "example": 0 }, "provider": { "type": "string", "example": "https://shortvidapi.com" }, "status": { "type": "string", "example": "ok" }, "msg": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "videos": { "type": "array", "items": { "type": "object", "properties": { "aweme_id": { "type": "string", "example": "v12044gd0000chddvr3c77u85fgv2j40" }, "video_id": { "type": "string", "example": "7231338487075638570" }, "region": { "type": "string", "example": "US" }, "title": { "type": "string", "example": "take time for yourself this #MentalHealthAwarenessMonth bc even a minute matters #SelfCare #Meditation #Wellness #MentalHealth " }, "content_desc": { "type": "array", "items": { "type": "string" } }, "cover": { "type": "string", "example": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/ddd657d17f0b4abf8a35fd0a823b72ec~tplv-tiktokx-cropcenter-q:300:400:q70.jpeg?dr=8596&refresh_token" }, "ai_dynamic_cover": { "type": "string", "example": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/9152b7eacb1743a191bf96c1983d0640_1683677204~tplv-tiktokx-origin.image?dr=8606&refresh_token=19857" }, "origin_cover": { "type": "string", "example": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/1a7f7c9536334a789a11119b2b27c6ba_1683677204~tplv-tiktokx-shrink-aq:360:360:q75.webp?dr=11731&refr" }, "duration": { "type": "integer", "example": 60 }, "play": { "type": "string", "example": "https://v16m.tiktokcdn-us.com/a5a4ed31914f0da3531788548bf10a9d/6ae7aba9/video/tos/useast5/tos-useast5-pve-0068-tx/o0VI0vfHAA2QJjP6AIeIt4knsbeTxBbDHIC5aU/?a=1233" }, "wmplay": { "type": "string", "example": "https://v16m.tiktokcdn-us.com/2247886b766ca3b39f6bc1da788d2b68/6ae7aba9/video/tos/useast5/tos-useast5-ve-0068c002-tx/ossTIyaDjkebxfhI4AMbDUFtIAVIHQnUCsCHeC/?a=1" }, "size": { "type": "integer", "example": 590702 }, "wm_size": { "type": "integer", "example": 837720 }, "music": { "type": "string", "example": "https://sf16.tiktokcdn-us.com/obj/ies-music-tx/7231338526456204078.mp3" }, "play_count": { "type": "integer", "example": 589066 }, "digg_count": { "type": "integer", "example": 96441 }, "comment_count": { "type": "integer", "example": 1285 }, "share_count": { "type": "integer", "example": 933 }, "download_count": { "type": "integer", "example": 732 }, "collect_count": { "type": "integer", "example": 60365 }, "create_time": { "type": "integer", "example": 1683677202 }, "anchors": { "type": "string", "nullable": true }, "anchors_extras": { "type": "string", "example": "" }, "is_ad": { "type": "boolean", "example": false }, "commerce_info": { "type": "object", "properties": { "adv_promotable": { "type": "object" }, "auction_ad_invited": { "type": "object" }, "branded_content_type": { "type": "object" }, "is_diversion_ad": { "type": "object" }, "organic_log_extra": { "type": "object" }, "with_comment_filter_words": { "type": "object" } } }, "commercial_video_info": { "type": "string", "example": "" }, "item_comment_settings": { "type": "integer", "example": 0 }, "mentioned_users": { "type": "string", "example": "" }, "author": { "type": "object", "properties": { "id": { "type": "object" }, "unique_id": { "type": "object" }, "nickname": { "type": "object" }, "avatar": { "type": "object" } } }, "is_nff_or_nr": { "type": "boolean", "example": false }, "is_top": { "type": "integer", "example": 0 } } } }, "cursor": { "type": "integer", "example": 12 }, "hasMore": { "type": "integer", "example": 1 } } } } }, "example": { "code": 0, "provider": "https://shortvidapi.com", "status": "ok", "msg": "success", "data": { "videos": [ { "aweme_id": "v12044gd0000chddvr3c77u85fgv2j40", "video_id": "7231338487075638570", "region": "US", "title": "take time for yourself this #MentalHealthAwarenessMonth bc even a minute matters #SelfCare #Meditation #Wellness #MentalHealth ", "content_desc": [], "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/ddd657d17f0b4abf8a35fd0a823b72ec~tplv-tiktokx-cropcenter-q:300:400:q70.jpeg?dr=8596&refresh_token=8e96214b&x-expires=1793631600&x-signature=U5b%2FDUe%2Broz9F...", "ai_dynamic_cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/9152b7eacb1743a191bf96c1983d0640_1683677204~tplv-tiktokx-origin.image?dr=8606&refresh_token=198578b9&x-expires=1793631600&x-signature=AVxgNSblk6BwJakUWODvoi%...", "origin_cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/1a7f7c9536334a789a11119b2b27c6ba_1683677204~tplv-tiktokx-shrink-aq:360:360:q75.webp?dr=11731&refresh_token=fa5bd835&x-expires=1793631600&x-signature=IDxHgpBG...", "duration": 60, "play": "https://v16m.tiktokcdn-us.com/a5a4ed31914f0da3531788548bf10a9d/6ae7aba9/video/tos/useast5/tos-useast5-pve-0068-tx/o0VI0vfHAA2QJjP6AIeIt4knsbeTxBbDHIC5aU/?a=1233&bti=O3YpOjQ0Zik3OjlmOm0uMjM6ZDQ0MDo%3D&&bt=76&ft=aEKfuqT0mI...", "wmplay": "https://v16m.tiktokcdn-us.com/2247886b766ca3b39f6bc1da788d2b68/6ae7aba9/video/tos/useast5/tos-useast5-ve-0068c002-tx/ossTIyaDjkebxfhI4AMbDUFtIAVIHQnUCsCHeC/?a=1233&bti=O3YpOjQ0Zik3OjlmOm0uMjM6ZDQ0MDo%3D&&bt=108&ft=aEKfuq...", "size": 590702, "wm_size": 837720, "music": "https://sf16.tiktokcdn-us.com/obj/ies-music-tx/7231338526456204078.mp3", "play_count": 589066, "digg_count": 96441, "comment_count": 1285, "share_count": 933, "download_count": 732, "collect_count": 60365, "create_time": 1683677202, "anchors": null, "anchors_extras": "", "is_ad": false, "commerce_info": { "adv_promotable": false, "auction_ad_invited": false, "branded_content_type": 0, "is_diversion_ad": 0, "organic_log_extra": "{\"req_id\":\"202611011513167233332CA9C38CA5F55E\"}", "with_comment_filter_words": false }, "commercial_video_info": "", "item_comment_settings": 0, "mentioned_users": "", "author": { "id": "107955", "unique_id": "tiktok", "nickname": "TikTok", "avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:300:300.jpeg?dr=9638&refresh_token=4d557dce&x-expires=1793631600&x-signature=K%2FwI1k7NDfqQRCFbUFM..." }, "is_nff_or_nr": false, "is_top": 0 }, { "aweme_id": "v0f044gc0000chdhjrrc77u79b6ekl9g", "video_id": "7231403782897257755", "region": "IT", "title": "Corso Massaggio 🌿🍀☘ #Relax #CorsoMassaggio #CorsoMassaggio #relaxing #TikTok #EsteticaItalianaacademy Trainer Nataliya Dudar. One Minute Break #oneminute ", "content_desc": [ "Corso Massaggio 🌿🍀☘ #Relax #CorsoMassaggio #CorsoMassaggio #relaxing #TikTok #EsteticaItalianaacademy ", "" ], "cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-aiso/oksyLBzqEhAhXBHitCAoIQGfzYb37TVz4mSInG~tplv-tiktokx-cropcenter-q:300:400:q70.jpeg?dr=8596&refresh_token=94a3dcbe&x-expires=1793631600&x-signature=Pvm9eTIn...", "ai_dynamic_cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-aiso/ab6282bfc18243f1acd42161a46d2093_1683692424~tplv-tiktokx-origin.image?dr=8606&refresh_token=a6ab5bac&x-expires=1793631600&x-signature=Od603ttP92Z%2BX0BZtz...", "origin_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-aiso/920b07b806a44ff3a62b165f57d7a7cf_1683692443~tplv-tiktokx-shrink-aq:360:360:q75.webp?dr=11731&refresh_token=0949ea5d&x-expires=1793631600&x-signature=aq4fM...", "duration": 56, "play": "https://v16m.tiktokcdn-us.com/8f684ccfd343671a1b0c89ca8a7d19b8/6ae7aba5/video/tos/useast2a/tos-useast2a-ve-68c810-euttp/oAkePS2KvBVgxA8RdDpRz39AdWEOQeb61nNnDM/?a=1233&bti=O3YpOjQ0Zik3OjlmOm0uMjM6ZDQ0MDo%3D&&bt=1086&ft=aE...", "wmplay": "https://v16m.tiktokcdn-us.com/934069ed03f70e562cc000dbd690fc6a/6ae7aba5/video/tos/useast2a/tos-useast2a-ve-68c811-euttp/oMyLVHVGEBYTAqSCI3JbThAdQIf7Znts3ozzzh/?a=1233&bti=O3YpOjQ0Zik3OjlmOm0uMjM6ZDQ0MDo%3D&&bt=1309&ft=aE...", "size": 7855962, "wm_size": 9459412, "music": "https://sf16.tiktokcdn-us.com/obj/ies-music-tx/7231338526456204078.mp3", "play_count": 4970, "digg_count": 605, "comment_count": 6, "share_count": 0, "download_count": 0, "collect_count": 5, "create_time": 1683692421, "anchors": [ { "actions": [], "anchor_strong": null, "component_key": "anchor_poi", "description": "Location", "extra": "{\"Name\":\"Modena\",\"poi_id\":\"22535865212487759\",\"city_code\":\"3173330\",\"region_code\":\"3175395\",\"poi_backend_type\":\"Place and Address,Places,City|19a3a0\",\"poi_info_source\":\"unknown\",\"video_count\":152625,\"collect_info\":\"{\\\"tt...", "general_type": 1, "icon": { "height": 720, "uri": "tiktok-obj/fyp_Icon_Anchor-LS_POI_Location.png", "url_list": [ "https://p16-common.tiktokcdn-us.com/tiktok-obj/fyp_Icon_Anchor-LS_POI_Location.png~tplv-tiktokx-origin.image?biz_tag=anchor.poi&dr=9580&idc=useast8&ps=933b5bde&shcp=34ff8df6&shp=d05b14bd&t=4d5b0474", "https://p19-common.tiktokcdn-us.com/tiktok-obj/fyp_Icon_Anchor-LS_POI_Location.png~tplv-tiktokx-origin.image?biz_tag=anchor.poi&dr=9580&idc=useast8&ps=933b5bde&shcp=34ff8df6&shp=d05b14bd&t=4d5b0474" ], "url_prefix": null, "width": 720 }, "id": "22535865212487759", "keyword": "Modena", "log_extra": "{\"anchor_id\":\"22535865212487759\",\"anchor_name\":\"Modena\",\"anchor_type\":\"poi\",\"is_ad_signal\":\"0\"}", "schema": "aweme://poi/detail", "thumbnail": { "height": 64, "uri": "tiktok-obj/panel_Icon_Anchor-LS_POI_Location.png", "url_list": [ "https://p19-common.tiktokcdn-us.com/tiktok-obj/panel_Icon_Anchor-LS_POI_Location.png~tplv-tiktokx-origin.image?dr=9580&t=4d5b0474&ps=933b5bde&shp=d05b14bd&shcp=34ff8df6&idc=useast8", "https://p16-common.tiktokcdn-us.com/tiktok-obj/panel_Icon_Anchor-LS_POI_Location.png~tplv-tiktokx-origin.image?dr=9580&t=4d5b0474&ps=933b5bde&shp=d05b14bd&shcp=34ff8df6&idc=useast8" ], "url_prefix": null, "width": 64 }, "type": 45 } ], "anchors_extras": "", "is_ad": false, "commerce_info": { "adv_promotable": false, "auction_ad_invited": false, "branded_content_type": 0, "is_diversion_ad": 0, "organic_log_extra": "{\"req_id\":\"202611011513167233332CA9C38CA5F55E\"}", "with_comment_filter_words": false }, "commercial_video_info": "", "item_comment_settings": 0, "mentioned_users": "", "author": { "id": "6793262104088593413", "unique_id": "esteticaitalianaacademy", "nickname": "Estetica Italiana Academy", "avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/13da9730da8d3f06341f30f14485246a~tplv-tiktokx-cropcenter:300:300.jpeg?dr=9638&refresh_token=6a8c7a30&x-expires=1793631600&x-signature=zzNuoCGTnoR%2BFVHdy2OJg0X..." }, "is_nff_or_nr": false, "is_top": 0 } ], "cursor": 12, "hasMore": 1 } } } } }, "400": { "description": "Invalid parameters, or API key placed in the URL query string (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid `x-api-key` header (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Insufficient credit balance (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Account disabled (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Unknown endpoint or disabled unstable endpoint (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "405": { "description": "Method not allowed — all `/v1/*` data endpoints use `GET` (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded (not charged). Respect the `Retry-After` header.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Temporary upstream or gateway error (not charged). Retry with exponential backoff.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/feed/list": { "get": { "operationId": "v1_feed_list", "tags": [ "Trending" ], "summary": "Get regional trending video feed", "description": "Fetch currently trending TikTok videos for a specific country/region (`data`: array of video objects with direct no-watermark URLs and full engagement statistics).", "parameters": [ { "name": "region", "in": "query", "required": true, "schema": { "type": "string", "default": "US" }, "description": "Two-letter ISO country code (`US`, `GB`, `DE`, `BR`, `JP`, `KR`, etc.).", "example": "US" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 30, "default": 20 }, "description": "Number of trending videos to return.", "example": 20 } ], "x-price-per-request": "$0.20 / 1K videos", "x-credits-per-request": "2 Credits / video (min 10 Credits)", "responses": { "200": { "description": "Success (`code === 0`). Charged according to the endpoint credit rate.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "example": 0 }, "provider": { "type": "string", "example": "https://shortvidapi.com" }, "status": { "type": "string", "example": "ok" }, "msg": { "type": "string", "example": "success" }, "data": { "type": "array", "items": { "type": "object", "properties": { "aweme_id": { "type": "string", "example": "" }, "video_id": { "type": "string", "example": "7676927307113811203" }, "region": { "type": "string", "example": "GB" }, "title": { "type": "string", "example": "petition for more #pinkfont #relateable #fyp #foryoupage #fypシ゚ " }, "content_desc": { "type": "array", "items": { "type": "string" } }, "cover": { "type": "string", "example": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-i-photomode-tx/75edbdedd62c46578e5e51858ab672ab~tplv-photomode-image-cover:640:0:q70.webp?dr=12229&refresh_" }, "ai_dynamic_cover": { "type": "string", "example": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-i-photomode-tx/75edbdedd62c46578e5e51858ab672ab~tplv-photomode-image-cover:640:0:q70.webp?dr=12229&refresh_" }, "origin_cover": { "type": "string", "example": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-i-photomode-tx/75edbdedd62c46578e5e51858ab672ab~tplv-photomode-image-cover:640:0:q70.webp?dr=12229&refresh_" }, "duration": { "type": "integer", "example": 0 }, "play": { "type": "string", "example": "https://v19.tiktokcdn-us.com/a8b634537e0b24b316a0a0348ba324e4/6af091d3/video/tos/no1a/tos-no1a-v-2370-no/oYBHoidEa6zUBn58EfVAVNK1wyilCVnMR0YNI4/?a=1233&bti=OHYp" }, "wmplay": { "type": "string", "example": "https://v19.tiktokcdn-us.com/a8b634537e0b24b316a0a0348ba324e4/6af091d3/video/tos/no1a/tos-no1a-v-2370-no/oYBHoidEa6zUBn58EfVAVNK1wyilCVnMR0YNI4/?a=1233&bti=OHYp" }, "size": { "type": "integer", "example": 0 }, "wm_size": { "type": "integer", "example": 0 }, "music": { "type": "string", "example": "https://v19.tiktokcdn-us.com/a8b634537e0b24b316a0a0348ba324e4/6af091d3/video/tos/no1a/tos-no1a-v-2370-no/oYBHoidEa6zUBn58EfVAVNK1wyilCVnMR0YNI4/?a=1233&bti=OHYp" }, "music_info": { "type": "object", "properties": { "id": { "type": "string", "example": "7625347344855927574" }, "title": { "type": "string", "example": "original sound - claudiump4" }, "play": { "type": "string", "example": "https://v19.tiktokcdn-us.com/a8b634537e0b24b316a0a0348ba324e4/6af091d3/video/tos/no1a/tos-no1a-v-2370-no/oYBHoidEa6zUBn58EfVAVNK1wyilCVnMR0YNI4/?a=1233&bti=OHYp" }, "cover": { "type": "string", "example": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/39bc0a7790233b14867a2936d5c3bae2~tplv-tiktokx-cropcenter-q:1080:1080:q70.jpeg?dr=8837&refresh_token" }, "author": { "type": "string", "example": "claudiump" }, "original": { "type": "boolean", "example": false }, "duration": { "type": "integer", "example": 32 }, "album": { "type": "string", "example": "" } } }, "play_count": { "type": "integer", "example": 532054 }, "digg_count": { "type": "integer", "example": 85933 }, "comment_count": { "type": "integer", "example": 539 }, "share_count": { "type": "integer", "example": 5886 }, "download_count": { "type": "integer", "example": 58 }, "collect_count": { "type": "integer", "example": 7889 }, "create_time": { "type": "integer", "example": 1787423933 }, "anchors": { "type": "string", "nullable": true }, "anchors_extras": { "type": "string", "example": "" }, "is_ad": { "type": "boolean", "example": false }, "commerce_info": { "type": "string", "nullable": true }, "commercial_video_info": { "type": "string", "example": "" }, "item_comment_settings": { "type": "integer", "example": 0 }, "mentioned_users": { "type": "string", "example": "" }, "author": { "type": "object", "properties": { "id": { "type": "string", "example": "7144358461923836933" }, "unique_id": { "type": "string", "example": "chiikawaee" }, "nickname": { "type": "string", "example": "໒꒱" }, "avatar": { "type": "string", "example": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/5da4c559769627ad1ecd0e82fee2d9a5~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?dr=8834&refresh_token=c" } } }, "is_nff_or_nr": { "type": "string", "nullable": true }, "images": { "type": "array", "items": { "type": "string", "example": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-i-photomode-tx/75edbdedd62c46578e5e51858ab672ab~tplv-photomode-image-v1:q70.jpeg?dr=8793&refresh_token=8d6d" } } } } } } }, "example": { "code": 0, "provider": "https://shortvidapi.com", "status": "ok", "msg": "success", "data": [ { "aweme_id": "", "video_id": "7676927307113811203", "region": "GB", "title": "petition for more #pinkfont #relateable #fyp #foryoupage #fypシ゚ ", "content_desc": [], "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-i-photomode-tx/75edbdedd62c46578e5e51858ab672ab~tplv-photomode-image-cover:640:0:q70.webp?dr=12229&refresh_token=30c22c5b&x-expires=1794841200&x-signature=DzTg%2FBFzZ4...", "ai_dynamic_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-i-photomode-tx/75edbdedd62c46578e5e51858ab672ab~tplv-photomode-image-cover:640:0:q70.webp?dr=12229&refresh_token=30c22c5b&x-expires=1794841200&x-signature=DzTg%2FBFzZ4...", "origin_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-i-photomode-tx/75edbdedd62c46578e5e51858ab672ab~tplv-photomode-image-cover:640:0:q70.webp?dr=12229&refresh_token=30c22c5b&x-expires=1794841200&x-signature=DzTg%2FBFzZ4...", "duration": 0, "play": "https://v19.tiktokcdn-us.com/a8b634537e0b24b316a0a0348ba324e4/6af091d3/video/tos/no1a/tos-no1a-v-2370-no/oYBHoidEa6zUBn58EfVAVNK1wyilCVnMR0YNI4/?a=1233&bti=OHYpOTY0Zik3OjlmOm01MzE6ZDQ0MDo%3D&&bt=125&ft=aEKfuqT0mv_PD12VUW...", "wmplay": "https://v19.tiktokcdn-us.com/a8b634537e0b24b316a0a0348ba324e4/6af091d3/video/tos/no1a/tos-no1a-v-2370-no/oYBHoidEa6zUBn58EfVAVNK1wyilCVnMR0YNI4/?a=1233&bti=OHYpOTY0Zik3OjlmOm01MzE6ZDQ0MDo%3D&&bt=125&ft=aEKfuqT0mv_PD12VUW...", "size": 0, "wm_size": 0, "music": "https://v19.tiktokcdn-us.com/a8b634537e0b24b316a0a0348ba324e4/6af091d3/video/tos/no1a/tos-no1a-v-2370-no/oYBHoidEa6zUBn58EfVAVNK1wyilCVnMR0YNI4/?a=1233&bti=OHYpOTY0Zik3OjlmOm01MzE6ZDQ0MDo%3D&&bt=125&ft=aEKfuqT0mv_PD12VUW...", "music_info": { "id": "7625347344855927574", "title": "original sound - claudiump4", "play": "https://v19.tiktokcdn-us.com/a8b634537e0b24b316a0a0348ba324e4/6af091d3/video/tos/no1a/tos-no1a-v-2370-no/oYBHoidEa6zUBn58EfVAVNK1wyilCVnMR0YNI4/?a=1233&bti=OHYpOTY0Zik3OjlmOm01MzE6ZDQ0MDo%3D&&bt=125&ft=aEKfuqT0mv_PD12VUW...", "cover": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/39bc0a7790233b14867a2936d5c3bae2~tplv-tiktokx-cropcenter-q:1080:1080:q70.jpeg?dr=8837&refresh_token=b32bee9b&x-expires=1793631600&x-signature=%2BBiXet0X4ShiA72...", "author": "claudiump", "original": false, "duration": 32, "album": "" }, "play_count": 532054, "digg_count": 85933, "comment_count": 539, "share_count": 5886, "download_count": 58, "collect_count": 7889, "create_time": 1787423933, "anchors": null, "anchors_extras": "", "is_ad": false, "commerce_info": null, "commercial_video_info": "", "item_comment_settings": 0, "mentioned_users": "", "author": { "id": "7144358461923836933", "unique_id": "chiikawaee", "nickname": "໒꒱", "avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/5da4c559769627ad1ecd0e82fee2d9a5~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?dr=8834&refresh_token=c43d2025&x-expires=1793631600&x-signature=jFjHU3nsVEnfzrKA5Gp..." }, "is_nff_or_nr": null, "images": [ "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-i-photomode-tx/75edbdedd62c46578e5e51858ab672ab~tplv-photomode-image-v1:q70.jpeg?dr=8793&refresh_token=8d6dc75d&x-expires=1794841200&x-signature=9iWGUuZtVBq%2Fqo2pn18%..." ] }, { "aweme_id": "v14044g50000dbemd9vog65h5e6sb2f0", "video_id": "7700424018846878994", "region": "US", "title": "La calm", "content_desc": [], "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-p-0037/oIfqgLRfEvD3udLEWZFanINuB8HxQgBiWEIUVA~tplv-tiktokx-shrink_ep:640:640:q78.jpeg?dr=8592&refresh_token=dde558e6&x-expires=1793631600&x-signature=77wpIpItl7AQvltpHdx...", "ai_dynamic_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-p-0037/oIfqgLRfEvD3udLEWZFanINuB8HxQgBiWEIUVA~tplv-tiktokx-shrink_ep:640:640:q78.jpeg?dr=8592&refresh_token=dde558e6&x-expires=1793631600&x-signature=77wpIpItl7AQvltpHdx...", "origin_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-p-0037/oMEF8EBLQ2RUfagn0fiVdQWuquWZxDiz3HEgAB~tplv-tiktokx-shrink-aq:360:360:q75.webp?dr=11731&refresh_token=559f00b1&x-expires=1793631600&x-signature=wLero4dyREZMenkm%2...", "duration": 15, "play": "https://v19.tiktokcdn-us.com/d0fceae2477b530e53db22dd8175a274/6ae7ab81/video/tos/alisg/tos-alisg-pve-0037c001/owEdnVaE1xRugI3QgBFqAZfDg8UwIBUufW3ELi/?a=1233&bti=OHYpOTY0Zik3OjlmOm01MzE6ZDQ0MDo%3D&&bt=2408&ft=aEKfuqT0mv_P...", "wmplay": "https://v19.tiktokcdn-us.com/d0fceae2477b530e53db22dd8175a274/6ae7ab81/video/tos/alisg/tos-alisg-pve-0037c001/owEdnVaE1xRugI3QgBFqAZfDg8UwIBUufW3ELi/?a=1233&bti=OHYpOTY0Zik3OjlmOm01MzE6ZDQ0MDo%3D&&bt=2408&ft=aEKfuqT0mv_P...", "size": 4635726, "wm_size": 0, "music": "https://v19.tiktokcdn-us.com/3699917ae62bd04d163830da3ed2d155/6af091d0/video/tos/useast5/tos-useast5-v-27dcd7-tx/o4JfwM2fMYceMVCnE3WOkbTx7C83MlHQQKAVoR/?a=1233&bti=OHYpOTY0Zik3OjlmOm01MzE6ZDQ0MDo%3D&&bt=125&ft=aEKfuqT0mv...", "music_info": { "id": "7359555730812275499", "title": "original sound - sange_singinchinese", "play": "https://v19.tiktokcdn-us.com/3699917ae62bd04d163830da3ed2d155/6af091d0/video/tos/useast5/tos-useast5-v-27dcd7-tx/o4JfwM2fMYceMVCnE3WOkbTx7C83MlHQQKAVoR/?a=1233&bti=OHYpOTY0Zik3OjlmOm01MzE6ZDQ0MDo%3D&&bt=125&ft=aEKfuqT0mv...", "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/35891c922d019760d58068555cce2043~tplv-tiktokx-cropcenter-q:1080:1080:q70.jpeg?dr=8837&refresh_token=a19abc58&x-expires=1793631600&x-signature=eP%2BQLyHRu2%...", "author": "sange", "original": false, "duration": 29, "album": "" }, "play_count": 61216129, "digg_count": 12381003, "comment_count": 89056, "share_count": 2697975, "download_count": 709, "collect_count": 731378, "create_time": 1792894694, "anchors": null, "anchors_extras": "", "is_ad": false, "commerce_info": null, "commercial_video_info": "", "item_comment_settings": 0, "mentioned_users": "", "author": { "id": "6542437660387950593", "unique_id": "rayasianboy", "nickname": "Ray", "avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/a3ad48dc1b150e483e7a278577bb16b9~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?dr=8834&refresh_token=04467c49&x-expires=1793631600&x-signature=bMVw%2F39z5ZFJNeMY9A..." }, "is_nff_or_nr": null } ] } } } }, "400": { "description": "Invalid parameters, or API key placed in the URL query string (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid `x-api-key` header (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Insufficient credit balance (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Account disabled (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Unknown endpoint or disabled unstable endpoint (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "405": { "description": "Method not allowed — all `/v1/*` data endpoints use `GET` (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded (not charged). Respect the `Retry-After` header.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Temporary upstream or gateway error (not charged). Retry with exponential backoff.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/ads/top/ads": { "get": { "operationId": "v1_ads_top_ads", "tags": [ "Commercial Ads" ], "summary": "Search top-performing TikTok Creative Center ads", "description": "Query top-performing commercial ads from TikTok Creative Center (`data.materials`), filtered by country, time window, and ranking metric (`impression`, `ctr`, `like`).", "parameters": [ { "name": "country_code", "in": "query", "required": false, "schema": { "type": "string", "default": "US" }, "description": "Two-letter country code (`US`, `GB`, `CA`, `DE`, `JP`, etc.).", "example": "US" }, { "name": "period", "in": "query", "required": false, "schema": { "type": "integer", "enum": [ 7, 30, 180 ], "default": 7 }, "description": "Time range in days (`7`, `30`, or `180`).", "example": 7 }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "impression", "ctr", "like" ], "default": "impression" }, "description": "Ranking metric: `impression`, `ctr`, or `like`.", "example": "impression" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1 }, "description": "Page number (starts at `1`).", "example": 1 }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 20, "default": 20 }, "description": "Ads per page (max 20).", "example": 20 } ], "x-price-per-request": "$1.00 / 1K ads", "x-credits-per-request": "10 Credits / ad (min 10 Credits)", "responses": { "200": { "description": "Success (`code === 0`). Charged according to the endpoint credit rate.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "example": 0 }, "provider": { "type": "string", "example": "https://shortvidapi.com" }, "status": { "type": "string", "example": "ok" }, "msg": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "pagination": { "type": "object", "properties": { "has_more": { "type": "boolean", "example": true }, "page": { "type": "integer", "example": 1 }, "size": { "type": "integer", "example": 5 }, "total_count": { "type": "integer", "example": 31 } } }, "materials": { "type": "array", "items": { "type": "object", "properties": { "ad_title": { "type": "string", "example": "Up to 50% OFF! Clip Studio Paint is on sale now until October 15, 8:00 am (GMT)" }, "brand_name": { "type": "string", "example": "" }, "cost": { "type": "integer", "example": 1 }, "ctr": { "type": "number", "example": 0.05 }, "favorite": { "type": "boolean", "example": false }, "id": { "type": "string", "example": "7683023815559315476" }, "industry_key": { "type": "string", "example": "label_20110000000" }, "is_search": { "type": "boolean", "example": true }, "like": { "type": "integer", "example": 1252 }, "objective_key": { "type": "string", "example": "campaign_objective_traffic" }, "video_info": { "type": "object", "properties": { "vid": { "type": "object" }, "duration": { "type": "object" }, "cover": { "type": "object" }, "video_url": { "type": "object" }, "width": { "type": "object" }, "height": { "type": "object" } } } } } } } } } }, "example": { "code": 0, "provider": "https://shortvidapi.com", "status": "ok", "msg": "success", "data": { "pagination": { "has_more": true, "page": 1, "size": 5, "total_count": 31 }, "materials": [ { "ad_title": "Up to 50% OFF! Clip Studio Paint is on sale now until October 15, 8:00 am (GMT)", "brand_name": "", "cost": 1, "ctr": 0.05, "favorite": false, "id": "7683023815559315476", "industry_key": "label_20110000000", "is_search": true, "like": 1252, "objective_key": "campaign_objective_traffic", "video_info": { "vid": "v14033g50000dagfil7og65n0u801vn0", "duration": 53.547, "cover": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/oke2IMKHccp0d1kBfHFSQFAeAALVGqAfgDGQAI~tplv-noop.image?dr=18692&refresh_token=e649a007&x-expires=1793567657&x-signature=QJgVIVuRbkogtf235hpl%2FLqC3JM%3D&t=927...", "video_url": { "1080p": "https://v16m-default.tiktokcdn.com/7a9cb116e33a64d0adfc2397cb618116/6ae7aba9/video/tos/alisg/tos-alisg-ve-0051c001-sg/oAEPgQVIGh2tyCltAIecAVgg8Lf9NVDGMKKbRf/?a=0&bti=NTU4QDM1NGA%3D&&bt=1032&ft=cApXJCz7ThWH-mF8LGZmo0P&mim..." }, "width": 1080, "height": 1920 } }, { "ad_title": "Up to 50% OFF! Clip Studio Paint is on sale now until October 15, 8:00 am (GMT)", "brand_name": "", "cost": 1, "ctr": 0.05, "favorite": false, "id": "7683021402580942868", "industry_key": "label_20110000000", "is_search": true, "like": 719, "objective_key": "campaign_objective_traffic", "video_info": { "vid": "v14033g50000dagfil7og65rtkgdl760", "duration": 77.27, "cover": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/ocO3eqAdfAB9AkDUDVjBl2QgGFNQPoO11UEIBY~tplv-noop.image?dr=18692&refresh_token=7cc5d10e&x-expires=1793567681&x-signature=U44%2BJkhXzz6Re2B77RdTDz6hEl4%3D&t=927...", "video_url": { "1080p": "https://v16m-default.tiktokcdn.com/0468aede766225662615ec28e7212298/6ae7abc1/video/tos/alisg/tos-alisg-ve-0051c001-sg/oIOseAGPEJpD5LbFVyR5cBgGAgKfCyfRiTQyIQ/?a=0&bti=NTU4QDM1NGA%3D&&bt=2605&ft=cApXJCz7ThWH-mF8LGZmo0P&mim...", "360p": "https://v16m-default.tiktokcdn.com/2d4c871dee4081babf0a877ba7b14e73/6ae7abc1/video/tos/alisg/tos-alisg-ve-0051c001-sg/oQWg5IHcfoqAiwQkZ6EuBFnDNB7DZgOQCQfkoI/?a=0&bti=NTU4QDM1NGA%3D&&bt=389&ft=cApXJCz7ThWH-mF8LGZmo0P&mime...", "480p": "https://v16m-default.tiktokcdn.com/cc45a463c5c89cde7de3c023a2491778/6ae7abc1/video/tos/alisg/tos-alisg-ve-0051c001-sg/ooQBnnZAc5CDpZo2gKmN7cfODIBFfkEqgQiIoZ/?a=0&bti=NTU4QDM1NGA%3D&&bt=561&ft=cApXJCz7ThWH-mF8LGZmo0P&mime...", "540p": "https://v16m-default.tiktokcdn.com/939cdd82439563d966136e8bb5835cec/6ae7abc1/video/tos/alisg/tos-alisg-ve-0051c001-sg/ogADA2RffyVReCEdQ5GyQg5kgPJbIcLAHyFGEy/?a=0&bti=NTU4QDM1NGA%3D&&bt=771&ft=cApXJCz7ThWH-mF8LGZmo0P&mime...", "720p": "https://v16m-default.tiktokcdn.com/83fca92341598c4d3dad7719a6f0bfc7/6ae7abc1/video/tos/alisg/tos-alisg-ve-0051c001-sg/oQ5BVocf0f1qFBAoQO7iNkIDgEMDQmgZZCnKIs/?a=0&bti=NTU4QDM1NGA%3D&&bt=1150&ft=cApXJCz7ThWH-mF8LGZmo0P&mim..." }, "width": 720, "height": 1280 } } ] } } } } }, "400": { "description": "Invalid parameters, or API key placed in the URL query string (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid `x-api-key` header (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Insufficient credit balance (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Account disabled (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Unknown endpoint or disabled unstable endpoint (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "405": { "description": "Method not allowed — all `/v1/*` data endpoints use `GET` (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded (not charged). Respect the `Retry-After` header.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Temporary upstream or gateway error (not charged). Retry with exponential backoff.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/ads/top/ads/detail": { "get": { "operationId": "v1_ads_top_ads_detail", "tags": [ "Commercial Ads" ], "summary": "Get commercial ad detail & 1080p video source", "description": "Fetch full creative performance metrics, ad objective, landing page link, brand name, and direct 720p/1080p video source (`data.video_info.video_url`) for a Creative Center ad (`ads_id` or `material_id`).", "parameters": [ { "name": "ads_id", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Creative Center ad material ID (`id` from `/v1/ads/top/ads`; `material_id` is also accepted).", "example": "7206035139393372162" } ], "x-price-per-request": "$1.00 / 1K requests", "x-credits-per-request": "10 Credits / request", "responses": { "200": { "description": "Success (`code === 0`). Charged according to the endpoint credit rate.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "example": 0 }, "provider": { "type": "string", "example": "https://shortvidapi.com" }, "status": { "type": "string", "example": "ok" }, "msg": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "ad_title": { "type": "string", "example": "Up to 50% OFF! Clip Studio Paint is on sale now until October 15, 8:00 am (GMT)" }, "brand_name": { "type": "string", "example": "" }, "comment": { "type": "integer", "example": 44 }, "cost": { "type": "integer", "example": 1 }, "country_code": { "type": "array", "items": { "type": "string", "example": "CA" } }, "ctr": { "type": "number", "example": 0.05 }, "favorite": { "type": "boolean", "example": false }, "has_summary": { "type": "boolean", "example": false }, "highlight_text": { "type": "string", "example": "" }, "id": { "type": "string", "example": "7683023815559315476" }, "industry_key": { "type": "string", "example": "label_20110000000" }, "is_search": { "type": "boolean", "example": false }, "keyword_list": { "type": "string", "nullable": true }, "landing_page": { "type": "string", "example": "https://www.clipstudio.net/en/?utm_source=tiktok&utm_medium=display&utm_campaign=tiktok_ad&utm_id=__CAMPAIGN_ID__" }, "like": { "type": "integer", "example": 1252 }, "objective_key": { "type": "string", "example": "campaign_objective_traffic" }, "objectives": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string", "example": "campaign_objective_traffic" }, "value": { "type": "integer", "example": 1 } } } }, "pattern_label": { "type": "array", "items": { "type": "string" } }, "share": { "type": "integer", "example": 11 }, "source": { "type": "string", "example": "TikTok Ads Manager" }, "source_key": { "type": "integer", "example": 1 }, "video_info": { "type": "object", "properties": { "vid": { "type": "string", "example": "v14033g50000dagfil7og65n0u801vn0" }, "duration": { "type": "number", "example": 53.547 }, "cover": { "type": "string", "example": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/oke2IMKHccp0d1kBfHFSQFAeAALVGqAfgDGQAI~tplv-noop.image?dr=18692&refresh_token=7ce90c96&x-expires=1" }, "video_url": { "type": "object", "properties": { "1080p": { "type": "string", "example": "https://v16m-default.tiktokcdn.com/5906d1d3b7b1f1ed1d0e466521a61b47/6ae7abac/video/tos/alisg/tos-alisg-ve-0051c001-sg/oAEPgQVIGh2tyCltAIecAVgg8Lf9NVDGMKKbRf/?a=" } } }, "width": { "type": "integer", "example": 1080 }, "height": { "type": "integer", "example": 1920 } } }, "voice_over": { "type": "boolean", "example": false } } } } }, "example": { "code": 0, "provider": "https://shortvidapi.com", "status": "ok", "msg": "success", "data": { "ad_title": "Up to 50% OFF! Clip Studio Paint is on sale now until October 15, 8:00 am (GMT)", "brand_name": "", "comment": 44, "cost": 1, "country_code": [ "CA", "AU" ], "ctr": 0.05, "favorite": false, "has_summary": false, "highlight_text": "", "id": "7683023815559315476", "industry_key": "label_20110000000", "is_search": false, "keyword_list": null, "landing_page": "https://www.clipstudio.net/en/?utm_source=tiktok&utm_medium=display&utm_campaign=tiktok_ad&utm_id=__CAMPAIGN_ID__", "like": 1252, "objective_key": "campaign_objective_traffic", "objectives": [ { "label": "campaign_objective_traffic", "value": 1 } ], "pattern_label": [], "share": 11, "source": "TikTok Ads Manager", "source_key": 1, "video_info": { "vid": "v14033g50000dagfil7og65n0u801vn0", "duration": 53.547, "cover": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/oke2IMKHccp0d1kBfHFSQFAeAALVGqAfgDGQAI~tplv-noop.image?dr=18692&refresh_token=7ce90c96&x-expires=1793567660&x-signature=uI22idmkULsIhKJYzqFrKZrzfBE%3D&t=92767...", "video_url": { "1080p": "https://v16m-default.tiktokcdn.com/5906d1d3b7b1f1ed1d0e466521a61b47/6ae7abac/video/tos/alisg/tos-alisg-ve-0051c001-sg/oAEPgQVIGh2tyCltAIecAVgg8Lf9NVDGMKKbRf/?a=0&bti=NTU4QDM1NGA%3D&&bt=1032&ft=cApXJCz7ThWHPmF8LGZmo0P&mim..." }, "width": 1080, "height": 1920 }, "voice_over": false } } } } }, "400": { "description": "Invalid parameters, or API key placed in the URL query string (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid `x-api-key` header (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Insufficient credit balance (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Account disabled (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Unknown endpoint or disabled unstable endpoint (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "405": { "description": "Method not allowed — all `/v1/*` data endpoints use `GET` (not charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded (not charged). Respect the `Retry-After` header.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Temporary upstream or gateway error (not charged). Retry with exponential backoff.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } } }, "components": { "securitySchemes": { "ApiKey": { "type": "apiKey", "in": "header", "name": "x-api-key", "description": "API key starting with `tk_`. Get 10,500 free credits ($1.05, no card) at https://shortvidapi.com/dashboard" } }, "schemas": { "Error": { "type": "object", "required": [ "code", "status", "msg" ], "properties": { "code": { "type": "integer", "example": -1 }, "status": { "type": "string", "enum": [ "error" ] }, "msg": { "type": "string", "example": "Invalid API key." } } } } } }