API referenceTikTok
TikTok collection posts
Videos saved inside a public collection.
The example response below is real output from this endpoint, not an illustration. Long lists and long strings are shortened to keep the page readable, and each place that happens is marked. This example took 3.5s.
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 }}