TikTok Collection Videos
Structured TikTok data: send urls. Cursor-paginated, 1 credit per successful call.
Overview
Section titled “Overview”Call GET /api/v2/tiktok-collection-videos/ with urls. The results are in data.videos; send data.next_cursor back as cursor to get the next page. 2 optional parameters refine the call (see Parameters).
Request
Section titled “Request”curl -G "https://api.scrapier.io/api/v2/tiktok-collection-videos/" \ -H "X-API-Key: YOUR_API_KEY" \ --data-urlencode "urls=https://www.tiktok.com/@tiktok/collection/Summer-of-Sports-7394627756635573022" \ --max-time 210const params = new URLSearchParams({ urls: "https://www.tiktok.com/@tiktok/collection/Summer-of-Sports-7394627756635573022" });
const res = await fetch(`https://api.scrapier.io/api/v2/tiktok-collection-videos/?${params}`, { headers: { "X-API-Key": "YOUR_API_KEY" }, signal: AbortSignal.timeout(210_000),});const body = await res.json();if (!res.ok) throw new Error(body.error ?? body.detail ?? `HTTP ${res.status}`);
console.log(body.data.videos);import requests
resp = requests.get( "https://api.scrapier.io/api/v2/tiktok-collection-videos/", headers={"X-API-Key": "YOUR_API_KEY"}, params={"urls": "https://www.tiktok.com/@tiktok/collection/Summer-of-Sports-7394627756635573022"}, timeout=210,)body = resp.json()if not resp.ok: raise RuntimeError(body.get("error") or body.get("detail"))
print(body["data"]["videos"])curl -X POST "https://api.scrapier.io/api/v2/tiktok-collection-videos/" \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"urls":"https://www.tiktok.com/@tiktok/collection/Summer-of-Sports-7394627756635573022"}' \ --max-time 210Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
X-API-Key header | string | yes | — | Your API key from the dashboard. |
urls | string | yes | e.g. https://www.tiktok.com/@tiktok/collection/Summer-of-Sports-7394627756635573022 | TikTok collection URL (https://www.tiktok.com/@user/collection/Name-<id>), bare collection id, or a vm.tiktok.com share link. One native page (up to 30 videos, under videos) per call, paged through TikTok's own offset. Required first call; ignored when cursor is supplied. |
cursor | string | no | — | Pagination cursor returned in the previous response's next_cursor. Pass it back unchanged to fetch the next page. When next_cursor is null, you have reached the last page. |
include_collection_info | boolean | no | true | Fetch owner profile + collection name / total / cover on page 1 (carried to later pages in the cursor). locked in cursor |
Advanced
| Name | Type | Default | Description |
|---|---|---|---|
use_proxy | boolean | true | Route the request through Scrapier's residential proxy pool. Default: true. Leave as is unless support tells you otherwise. |
raw_data | boolean | false | When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under raw_responses, in place of the formatted items. When false (default) you get the formatted output. Pagination (cursor / next_cursor) works the same in both modes. |
Response
Section titled “Response”{ "success": true, "data": { "urls": "https://www.tiktok.com/@tiktok/collection/Summer-of-Sports-7394627756635573022", "collection_id": "7394627756635573022", "collection": { "id": "7394627756635573022", "name": "Summer of Sports", "slug": "Summer-of-Sports", "url": "https://www.tiktok.com/@tiktok/collection/Summer-of-Sports-7394627756635573022", "total_videos": 139, "cover_url": "https://p16-common-sign.tiktokcdn.com/tos-useast2a-p-0037-euttp/d71c5a45982a4fde9ef046df412d308b_1...(signed)", "cover_urls": [ "https://p16-common-sign.tiktokcdn.com/tos-useast2a-p-0037-euttp/d71c5a45982a4fde9ef046df412d308b_1...(signed)" ], "status": 3, "source": "collection_list", "owner": { "username": "tiktok", "display_name": "TikTok", "id": "107955", "sec_uid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM", "profile_url": "https://www.tiktok.com/@tiktok", "avatar_url": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-ti...(signed)", "bio": "Your next discovery is waiting on TikTok.", "verified": true, "private_account": false, "follower_count": 95800000, "following_count": 1, "heart_count": 464100000, "video_count": 1506, "profile_status_code": 0, "profile_status": "ok" }, "warnings": [] }, "page": 1, "page_size": 29, "offset": 0, "next_offset": 30, "has_more": true, "dropped": 1, "videos": [ { "input_url": "https://www.tiktok.com/@tiktok/collection/Summer-of-Sports-7394627756635573022", "collection_id": "7394627756635573022", "collection_url": "https://www.tiktok.com/@tiktok/collection/Summer-of-Sports-7394627756635573022", "collection": { "id": "7394627756635573022", "name": "Summer of Sports", "slug": "Summer-of-Sports", "url": "https://www.tiktok.com/@tiktok/collection/Summer-of-Sports-7394627756635573022", "total_videos": 139, "cover_url": "https://p16-common-sign.tiktokcdn.com/tos-useast2a-p-0037-euttp/d71c5a45982a4fde9ef046df412d308b_1...(signed)", "cover_urls": [ "https://p16-common-sign.tiktokcdn.com/tos-useast2a-p-0037-euttp/d71c5a45982a4fde9ef046df412d308b_1...(signed)" ], "status": 3, "source": "collection_list", "owner": { "username": "tiktok", "display_name": "TikTok", "id": "107955", "sec_uid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM", "profile_url": "https://www.tiktok.com/@tiktok", "avatar_url": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-ti...(signed)", "bio": "Your next discovery is waiting on TikTok.", "verified": true, "private_account": false, "follower_count": 95800000, "following_count": 1, "heart_count": 464100000, "video_count": 1506, "profile_status_code": 0, "profile_status": "ok" }, "warnings": [] }, "position": 2, "video_id": "7399613114368396574", "url": "https://www.tiktok.com/@nikita.ducarroz/video/7399613114368396574", "caption": "Until next time! 🫶🏻 #olympics #paris2024 #olympicgames #bmx #OlympicVillage ", "hashtags": [ "olympics", "paris2024", "olympicgames" ], "mentions": [], "create_time": 1722856728, "created_at": "2024-08-05T11:18:48.000Z", "duration_seconds": 10, "stats": { "play_count": 150400, "like_count": 15700, "comment_count": 147, "share_count": 89, "save_count": 532, "repost_count": 0 }, "author": { "username": "nikita.ducarroz", "display_name": "Nikita Ducarroz", "avatar_url": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/034acdd1b4d32f87ed37bf9b8ea48185~tplv-ti...(signed)", "verified": false, "id": "6765667025392108550", "sec_uid": "MS4wLjABAAAAV8vrjebD8zqVNPqUJg4slIdqErA77t-Hi-CTHphLQVHp7MhvcHvASPOJ-JZ03Bd3", "profile_url": "https://www.tiktok.com/@nikita.ducarroz", "bio": "✨ BMX | 2X OLYMPIAN | 🥉 MEDALIST\nRED BULL ATHLETE", "private_account": false, "follower_count": 17300, "following_count": 73, "heart_count": 2000000, "video_count": 142, "digg_count": 1199, "friend_count": 0, "comment_setting": 0, "duet_setting": 0, "stitch_setting": 0, "download_setting": 0, "is_ad_virtual": false, "is_embed_banned": false }, "music": { "id": "6714159100260813573", "title": "sad SpongeBob music", "author_name": "michael", "album": null, "duration_seconds": 19, "original": true, "copyrighted": true, "commerce_music": true, "play_url": "https://v58.tiktokcdn.com/video/tos/useast2a/tos-useast2a-v-27dcd7/dfd5490caffb4978adf...(signed)", "cover_url": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/d0f7aa6aac3dc16795713c98be2f51f0~tplv-ti...(signed)", "url": "https://www.tiktok.com/music/sad-SpongeBob-music-6714159100260813573" }, "play_url": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/oYCtpyIAqTAiZiFt2rIU3...(signed)", "play_urls": [ "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/oYCtpyIAqTAiZiFt2rIU3...(signed)" ], "download_url": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/oIyPggVDmBtvoQqFEEvLj...(signed)", "cover_url": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/54ce5365fc8e49c19d91dd07815cd894_1722...(signed)", "origin_cover_url": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/c172def72489494eac790dd7b2e93e7f_1722...(signed)", "dynamic_cover_url": "https://p19-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/cb480402ab8549a7b933d351be2b3009_1722...(signed)", "thumbnail_url": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/54ce5365fc8e49c19d91dd07815cd894_1722...(signed)", "zoom_covers": { "240": "https://p19-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/54ce5365fc8e49c19d91dd07815cd894_1722...(signed)", "480": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/54ce5365fc8e49c19d91dd07815cd894_1722...(signed)", "720": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/54ce5365fc8e49c19d91dd07815cd894_1722...(signed)", "960": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/54ce5365fc8e49c19d91dd07815cd894_1722...(signed)" }, "video": { "width": 576, "height": 1024, "ratio": "540p", "definition": "540p", "video_quality": "normal", "codec": "h264", "format": "mp4", "bitrate": 1643649, "size_bytes": 2143730, "vq_score": "62.63", "is_hd": false, "bitrate_variants": [ { "gear": "normal_540_0", "quality_type": 20, "codec": "h264", "format": "mp4", "bitrate": 1643649, "fps": 30, "width": 576, "height": 1024, "size_bytes": 2143730, "url": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/oYCtpyIAqTAiZiFt2rIU3...(signed)" } ], "subtitles": [] }, "text_language": "en", "caption_lines": [ "Until next time! 🫶🏻", "#olympics #paris2024 #olympicgames #bmx #OlympicVillage " ], "ai_generated": null, "aigc_description": null, "stickers": [ "Unfortunately I have\nleft the Olympic Villa. " ], "effects": [ "Green Screen", "Green Screen Video" ], "location": { "id": "23661696391172616", "name": "Paris 2024 Paralympic Village", "address": "7 Rue Nicolau, 93400 Saint-Ouen-sur-Seine, France", "city": "Seine Saint Denis", "province": "", "country": "", "country_code": "3017382", "category": "Residential", "type": "Residential" }, "anchors": [], "warnings": [], "flags": { "nsfw": null, "spoiler": null, "pinned": null, "deleted": false, "is_ad": false, "is_prohibited": false, "is_reviewing": false, "private_item": false, "secret": false, "official_item": false, "original_item": false, "for_friend": false, "share_enabled": true, "duet_enabled": true, "stitch_enabled": true, "can_repost": true, "can_comment": null, "can_share": null, "comment_status": 0, "show_aigc": true, "video_status": 10 }, "category_type": 112, "playlist_id": "7399001233681550126", "computed": { "engagement_rate": 0.105957, "language": "en", "content_category": "sports", "estimated_reach": 180480, "engagement_rate_with_saves": 0.109495, "total_interactions": 16468, "like_rate": 0.104388, "comment_rate": 0.000977, "share_rate": 0.000592, "save_rate": 0.003537, "age_days": 774.95, "views_per_day": 194.08, "hashtag_count": 5, "caption_length": 76 }, "scraped_at": "2026-09-19T10:03:23.186Z" } ], "next_cursor": "eyJjIjoiNzM5NDYyNzc1NjYzNTU3MzAyMiIsImNpIjp7ImNv..." }}Bad input. The exact message varies by endpoint.
{ "success": false, "error": "…"}Balance below the endpoint’s price.
{ "error": "Insufficient credits. Buy more to scrape more.", "balance": 1, "required": 2}Invalid or unknown API key.
{ "detail": "Authentication service unavailable or invalid API key."}Throttled — wait for Retry-After.
{ "detail": "Request was throttled. Expected available in N seconds."}Sample from the live catalog; arrays trimmed to 3 items. Results are in data.videos.
Response fields
Section titled “Response fields”| Field | Type | Example | Description |
|---|---|---|---|
urls | string | https://www.tiktok.com/@tiktok/collection/Sum… | — |
collection_id | string | 7394627756635573022 | — |
collection | object | {…} | — |
page | integer | 1 | — |
page_size | integer | 29 | — |
offset | integer | 0 | — |
next_offset | integer | 30 | — |
has_more | boolean | true | — |
dropped | integer | 1 | — |
videos | array | [1 item] | The results. |
next_cursor | string | eyJjIjoiNzM5NDYyNzc1NjYzNTU3MzAyMiIsImNpIjp7I… | Pass back as cursor for the next page. null on the last page. |
videos[].input_url | string | https://www.tiktok.com/@tiktok/collection/Sum… | — |
videos[].collection_id | string | 7394627756635573022 | — |
videos[].collection_url | string | https://www.tiktok.com/@tiktok/collection/Sum… | — |
videos[].collection | object | {…} | — |
videos[].position | integer | 2 | — |
videos[].video_id | string | 7399613114368396574 | — |
videos[].url | string | https://www.tiktok.com/@nikita.ducarroz/video… | — |
videos[].caption | string | Until next time! 🫶🏻 #olympics #paris2024 #o… | — |
videos[].hashtags | array | [5 items] | — |
videos[].mentions | array | [] | — |
videos[].create_time | integer | 1722856728 | — |
videos[].created_at | string | 2024-08-05T11:18:48.000Z | — |
videos[].duration_seconds | integer | 10 | — |
videos[].stats | object | {…} | — |
videos[].author | object | {…} | — |
videos[].music | object | {…} | — |
videos[].play_url | string | https://v16-webapp-prime.tiktok.com/video/tos… | — |
videos[].play_urls | array | [1 item] | — |
videos[].download_url | string | https://v16-webapp-prime.tiktok.com/video/tos… | — |
videos[].cover_url | string | https://p16-common-sign.tiktokcdn.com/tos-use… | — |
videos[].origin_cover_url | string | https://p16-common-sign.tiktokcdn.com/tos-use… | — |
videos[].dynamic_cover_url | string | https://p19-common-sign.tiktokcdn.com/tos-use… | — |
videos[].thumbnail_url | string | https://p16-common-sign.tiktokcdn.com/tos-use… | — |
videos[].zoom_covers | object | {…} | — |
videos[].video | object | {…} | — |
videos[].text_language | string | en | — |
videos[].caption_lines | array | [2 items] | — |
videos[].ai_generated | null | null | — |
videos[].aigc_description | null | null | — |
videos[].stickers | array | [1 item] | — |
videos[].effects | array | [2 items] | — |
videos[].location | object | {…} | — |
videos[].anchors | array | [] | — |
videos[].warnings | array | [] | — |
videos[].flags | object | {…} | — |
videos[].category_type | integer | 112 | — |
videos[].playlist_id | string | 7399001233681550126 | — |
videos[].computed | object | {…} | — |
videos[].scraped_at | string | 2026-09-19T10:03:23.186Z | — |
Pagination
Section titled “Pagination”Pass data.next_cursor back as cursor until it is null. Required inputs are ignored once a cursor is sent. Each page is one billed call. More in Pagination.
const url = "https://api.scrapier.io/api/v2/tiktok-collection-videos/";let params = { urls: "https://www.tiktok.com/@tiktok/collection/Summer-of-Sports-7394627756635573022" };const items = [];
for (let page = 0; page < 10; page++) { // each page is one billed call const res = await fetch(`${url}?${new URLSearchParams(params)}`, { headers: { "X-API-Key": "YOUR_API_KEY" }, signal: AbortSignal.timeout(210_000), }); const body = await res.json(); if (!res.ok) throw new Error(body.error ?? body.detail ?? `HTTP ${res.status}`); const data = body.data; items.push(...(data.videos ?? [])); if (!data.next_cursor) break; // null = last page params = { cursor: data.next_cursor };}import requests
URL = "https://api.scrapier.io/api/v2/tiktok-collection-videos/"HEADERS = {"X-API-Key": "YOUR_API_KEY"}params = {"urls": "https://www.tiktok.com/@tiktok/collection/Summer-of-Sports-7394627756635573022"}items = []
for _ in range(10): # each page is one billed call resp = requests.get(URL, headers=HEADERS, params=params, timeout=210) resp.raise_for_status() data = resp.json()["data"] items.extend(data.get("videos") or []) if not data.get("next_cursor"): # None = last page break params = {"cursor": data["next_cursor"]}Errors
Section titled “Errors”Failed calls are free. Branch on the HTTP status and read the message from error (or detail). Full details in Errors.
| Status | Meaning | Retry? | Charged? |
|---|---|---|---|
400 | Bad or missing input. | No — fix the params | No |
401 / 403 | Missing, invalid or revoked API key. | No — fix the key | No |
402 | Out of credits (body has balance). | No — top up | No |
404 | Unknown endpoint slug. | No — check the slug | No |
429 / 503 | Busy or throttled. | Yes — after Retry-After | No |
5xx | Target site or upstream failure, or timeout. | Yes — with backoff | No |
- Locked into the cursor:
include_collection_info. Set them on the first call; later pages reuse them.
Related
Section titled “Related”- TikTok Ad Library Leads — Structured TikTok data: every input is optional. Single lookup, 3 credits per successful call.
- TikTok Ad Library — Structured TikTok data: send
urls. Cursor-paginated, 1 credit per successful call. - TikTok Ads Top — Structured TikTok data: every input is optional. Cursor-paginated, 1 credit per successful call.
- TikTok Comment Replies — Structured TikTok data: send
urls. Cursor-paginated, 1 credit per successful call.