TikTok Collection Videos

Page through posts saved in a public TikTok collection.

GET/api/v1/tiktok/collection-videos

Alpha: this endpoint is new and its response fields may still change.

Costs 1 credit per request; failed requests are refunded. Authentication, the search_metadata envelope and error codes are the same as for every endpoint (see the API reference). Try it in the playground.

Parameters

Request parameters

Parameter	Type	Description
`cursor`	string	Upstream pagination cursor from the preceding response; 0 starts a new feed.Default: 0.Range: 0 to 9223372036854776000.
`count`	integer	Requested page size, between 1 and 35.Default: 20.Range: 1 to 35.
`url`	string	Public TikTok collection URL; supply this or collection_id.Up to 2,048 characters.
`collection_id`	string	Numeric public saved-collection ID; supply this or url.

Response

A JSON object with search_metadata (request id, credits used and remaining) and the result groups the page returns. Groups and fields depend on the content of each page, so treat every field as optional.

Examples

cURL

curl "https://serpfast.com/api/v1/tiktok/collection-videos?url=https%3A%2F%2Fwww.tiktok.com%2F%40kibblemaster808%2Fcollection%2FWant-to-go-7665668414573546258&count=3" \
  -H "Authorization: Bearer $SERPFAST_KEY"

Node.js 18+

const params = new URLSearchParams({
  "url": "https://www.tiktok.com/@kibblemaster808/collection/Want-to-go-7665668414573546258",
  "count": 3
});
const res = await fetch(`https://serpfast.com/api/v1/tiktok/collection-videos?${params}`, {
  headers: { Authorization: `Bearer ${process.env.SERPFAST_KEY}` },
});
const data = await res.json();
console.log(data);

Python

import os, requests

params = {
  "url": "https://www.tiktok.com/@kibblemaster808/collection/Want-to-go-7665668414573546258",
  "count": 3
}
res = requests.get(
    "https://serpfast.com/api/v1/tiktok/collection-videos",
    params=params,
    headers={"Authorization": f"Bearer {os.environ['SERPFAST_KEY']}"},
    timeout=120,
)
print(res.json())