API referenceTikTok
TikTok collection posts
Videos saved inside a public collection.
Authorization
ApiKeyAuth X-API-Key<token>
Your API key. Sent on every request.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/scrapers/tiktok-collection-posts-v4" \ -H "Content-Type: application/json" \ -d '{ "collection": "7394627756635573022", "cursor": "0", "count": 30 }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "collection_id": "7394627756635573022", "has_more": true, "max_cursor": "30", "status_code": 0, "status_msg": "", "videos": [ { "AIGCDescription": null, "CategoryType": null, "IsHDBitrate": null, "ShowAIGC": null, "anchors": null, "author": { "id": "6791598551904076805", "nickname": "Noah Lyles", "uniqueId": "nojo18" }, "createTime": 1722860874, "desc": null, "id": "7399631056783035690", "stats": { "collectCount": 39003, "commentCount": 3099, "diggCount": 500659, "playCount": 3343899, "shareCount": 22578 }, "video": { "cover": "https://p16-common-sign.tiktokcdn.com/tos-useast5-p-0068-tx/oYQIDWNuYCYeHwMTg8ffGkBAQLFT0YdJD7qAjS~tplv-tiktokx-cropcenter-q:300:400:q70.webp?dr=14782&refresh_token=508b88d1&x-expires=1787572800&x-signature=wnQqvoC900NRS57hvy8idetqlzI%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=a3668259&idc=my&biz_tag=tt_video&s=OTHERS… (+20 chars)", "duration": 48, "height": null, "width": null } }, { "AIGCDescription": null, "CategoryType": null, "IsHDBitrate": null, "ShowAIGC": null, "anchors": [ { "actions": [ { "action_type": 1, "icon": { "height": 720, "uri": "tiktok-obj/28px_primary_create_onDark3x.png", "url_list": [ "https://p19-common.tiktokcdn.com/tiktok-obj/28px_primary_create_onDark3x.png~tplv-tiktokx-origin.image?biz_tag=anchor.ucg_template&dr=14000&idc=my&ps=933b5bde&shcp=34ff8df6&shp=d05b14bd&t=4d5b0474", "https://p16-common.tiktokcdn.com/tiktok-obj/28px_primary_create_onDark3x.png~tplv-tiktokx-origin.image?biz_tag=anchor.ucg_template&dr=14000&idc=my&ps=933b5bde&shcp=34ff8df6&shp=d05b14bd&t=4d5b0474", "… 1 more item in the full response" ], "url_prefix": null, "width": 720 }, "schema": "shoot" } ], "anchor_strong": null, "component_key": "anchor_ucg_template", "description": "Templates", "extra": "{\"nle_summary\":\"{\\\"slots\\\":\\\"[{\\\\\\\"clip_end\\\\\\\":0.5378779768943787,\\\\\\\"clip_start\\\\\\\":0.0,\\\\\\\"description\\\\\\\":\\\\\\\"\\\\\\\",\\\\\\\"endtime\\\\\\\":0.5378779768943787,\\\\\\\"height\\\\\\\":1920,\\\\\\\"origin_material_type\\\\\\\":\\\\\\\"video\\\\\\\",\\\\\\\"source\\\\\\\":\\\\\\\"\\\\\\\",\\\\\\\"starttime\\\\\\\":0.0,\\\\\\\"type\\\\\\\":\\\\\\\"video\\\\\\\",\\\\\\\"uuid\\\\\\\":\\\\\\\"1722856550416… (+2066 chars)", "icon": { "height": 720, "uri": "tiktok-obj/Templates_Cards.png", "url_list": [ "https://p19-common.tiktokcdn.com/tiktok-obj/Templates_Cards.png~tplv-tiktokx-origin.image?biz_tag=anchor.ucg_template&dr=14000&idc=my&ps=933b5bde&shcp=34ff8df6&shp=d05b14bd&t=4d5b0474", "https://p16-common.tiktokcdn.com/tiktok-obj/Templates_Cards.png~tplv-tiktokx-origin.image?biz_tag=anchor.ucg_template&dr=14000&idc=my&ps=933b5bde&shcp=34ff8df6&shp=d05b14bd&t=4d5b0474", "… 1 more item in the full response" ], "url_prefix": null, "width": 720 }, "id": "7399612877658669099", "keyword": "Try TikTok template", "log_extra": "{\"anchor_id\":\"7399612877658669099\",\"anchor_name\":\"Try TikTok template\",\"anchor_type\":\"ugc_template\",\"has_friends_info\":\"0\"}", "schema": "", "thumbnail": { "height": 720, "uri": "tiktok-obj/Templates_Cards.png", "url_list": [ "https://p16-common.tiktokcdn.com/tiktok-obj/Templates_Cards.png~tplv-tiktokx-origin.image?dr=14000&t=4d5b0474&ps=933b5bde&shp=d05b14bd&shcp=34ff8df6&idc=my", "https://p19-common.tiktokcdn.com/tiktok-obj/Templates_Cards.png~tplv-tiktokx-origin.image?dr=14000&t=4d5b0474&ps=933b5bde&shp=d05b14bd&shcp=34ff8df6&idc=my", "… 1 more item in the full response" ], "url_prefix": null, "width": 720 }, "type": 65 } ], "author": { "id": "6765667025392108550", "nickname": "Nikita Ducarroz", "uniqueId": "nikita.ducarroz" }, "createTime": 1722856728, "desc": "Until next time! 🫶🏻 #olympics #paris2024 #olympicgames #bmx #OlympicVillage", "id": "7399613114368396574", "stats": { "collectCount": 530, "commentCount": 147, "diggCount": 15647, "playCount": 149739, "shareCount": 89 }, "video": { "cover": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/54ce5365fc8e49c19d91dd07815cd894_1722856730~tplv-tiktokx-cropcenter-q:300:400:q70.webp?dr=14782&refresh_token=b44016c4&x-expires=1787572800&x-signature=Fd5l760qCF2FgSEyDnCQMvnxsjs%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=a3668259&idc=my&sc=cover&biz_tag=tt… (+26 chars)", "duration": 10, "height": null, "width": null } }, "… 26 more items in the full response" ] }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "tiktok-collection-posts-v4", "billable": true, "duration_ms": 2819 }}