Skip to content

Structured TikTok data: send usernames. Cursor-paginated, 1 credit per successful call.

GET · POST1 credit / successful callCursor-paginated
GEThttps://api.scrapier.io/api/v2/tiktok-user-liked/Open in Playground

Call GET /api/v2/tiktok-user-liked/ with usernames. The results are in data.items; send data.next_cursor back as cursor to get the next page. 4 optional parameters refine the call (see Parameters).

Terminal window
curl -G "https://api.scrapier.io/api/v2/tiktok-user-liked/" \
-H "X-API-Key: YOUR_API_KEY" \
--data-urlencode "usernames=chipotle" \
--max-time 210
NameTypeRequiredDefaultDescription
X-API-Key headerstringyes—Your API key from the dashboard.
usernamesstringyese.g. chipotleTikTok username (chipotle / @chipotle), profile URL or numeric user id -> the videos this account has LIKED, newest like first: ONE native /api/favorite/item_list/ page (30 liked videos, under items) per call, paged through TikTok's own like-time cursor (+ the boundary ids it repeats, so pages never overlap). Required on the first call; ignored when cursor is supplied. Hidden / private liked list -> 404 "likes are private"; unknown handle -> 404; TikTok refusing every attempt -> 502.
user_idsstringno—Numeric TikTok user id (6646487634225135622), resolved via /share/user/{id}.
cursorstringno—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.
enrich_pagesstringnofalsefalse (default) = liked-list values only (fastest); true = one video page load per liked video (precise duration, region, TikTok labels, pinned flag; best effort inside the call deadline, ~10-20 s slower); N = only the first N rows of each page.
locked in cursor
regionstringno—ISO-2 market for the signed API calls (default: the page's region, else US); pins the proxy exit country.
locked in cursor
Advanced
NameTypeDefaultDescription
use_proxybooleantrueRoute the request through Scrapier's residential proxy pool. Default: true. Leave as is unless support tells you otherwise.
raw_databooleanfalseWhen 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.
{
"success": true,
"data": {
"usernames": "chipotle",
"username": "chipotle",
"user_id": "6646487634225135622",
"status": "ok",
"page": 1,
"page_size": 30,
"cursor": 0,
"cursor_us": "0",
"next_cursor_us": "1789417651030000",
"has_more": true,
"total": 6828,
"repeats_removed": 0,
"dropped": 0,
"attempts": 1,
"elapsed_sec": 3.7,
"account": {
"id": "6646487634225135622",
"username": "chipotle",
"display_name": "Chipotle",
"sec_uid": "MS4wLjABAAAAb-3Za1s2IerpSYNhYHyGARc7tptWc3wrDBk6DAmGR1T5T1iWvZK9RL_p9pyF0hZp",
"url": "https://www.tiktok.com/@chipotle",
"avatar_url": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/...",
"verified": true,
"private_account": false,
"liked_videos_public": true,
"liked_count": 6828,
"followers": 2917754,
"following": 304,
"video_count": 775,
"total_likes": 66151514
},
"media_access": {
"cookies": {
"ttwid": "1%7C...",
"tt_csrf_token": "...",
"tt_chain_token": "..."
},
"headers": {
"referer": "https://www.tiktok.com/",
"user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) ... Chrome/131.0.0.0 Safari/537.36"
},
"note": "content.media_urls / media_url_list / download_url of video rows need these cookies + Referer; photo image URLs, thumbnails, avatars and music play URLs are open."
},
"warnings": [],
"items": [
{
"input_username": "chipotle",
"input_user_id": null,
"username": "chipotle",
"user_id": "6646487634225135622",
"status": "ok",
"error": null,
"position": 1,
"page_position": 1,
"video_id": "7685839095632891166",
"url": "https://www.tiktok.com/@eatswithemmiee/video/7685839095632891166",
"description": "@Chipotle tacos🌮🔥✨ Chipotle never misses but with their TACOS? ... #mukbang #chipotle #foodie",
"content_type": "video",
"created_at": "2026-09-15T19:01:31.000Z",
"create_time": 1789498891,
"author_username": "eatswithemmiee",
"author_id": "7456588491607360554",
"author_display_name": "eatswithemmie",
"play_count": 365400,
"like_count": 57200,
"comment_count": 158,
"share_count": 1742,
"save_count": 6296,
"repost_count": 0,
"duration_seconds": 110.393,
"thumbnail_url": "https://p16-common-sign.tiktokcdn.com/...",
"play_url": "https://v16-webapp-prime.tiktok.com/video/tos/...&tk=tt_chain_token&...",
"download_url": "https://v16-webapp-prime.tiktok.com/video/tos/...",
"image_urls": [],
"hashtags": [
"mukbang",
"mukbangeatingshow",
"chipotle"
],
"mentions": [
"chipotle"
],
"music_title": "original sound",
"music_author": "eatswithemmie",
"region": "US",
"text_language": "en",
"pinned": false,
"enriched": false,
"author": {
"username": "eatswithemmiee",
"display_name": "eatswithemmie",
"id": "7456588491607360554",
"verified": false,
"followers": 23300,
"video_count": 330,
"total_likes": 1800000,
"...": "(sec_uid, url, signature, avatar_url)"
},
"post": {
"id": "7685839095632891166",
"url": "https://www.tiktok.com/@eatswithemmiee/video/7685839095632891166",
"content": {
"text": "...",
"media_urls": "https://v16-webapp-prime.tiktok.com/...",
"duration_seconds": 110.393,
"type": "video",
"width": 720,
"height": 1280,
"format": "mp4",
"codec": "h264",
"...": "(covers, bitrate, size, hashtags, mentions)"
},
"author": {
"...": "(author card)"
},
"engagement": {
"views": 365400,
"likes": 57200,
"comments": 158,
"shares": 1742,
"saves": 6296,
"reposts": 0
},
"flags": {
"pinned": false,
"ad": false,
"aigc": false,
"duet_enabled": true,
"...": "(stitch/share/comments flags)"
},
"published_at": "2026-09-15T19:01:31.000Z",
"ext": {
"music_id": "7685839201543277343",
"region": "US",
"text_language": "en",
"diversification_labels": [
"Mukbangs & Tasting",
"Food & Drink",
"Lifestyle"
],
"on_screen_texts": [
"Chili lime lol…😭"
],
"...": "(music, category, effect stickers)"
}
},
"computed": {
"engagement_rate": 0.161741,
"language": "en",
"content_category": "food",
"estimated_reach": 438480
},
"account": {
"...": "(same account card as the envelope)"
},
"media_access": {
"...": "(same as the envelope)"
},
"pagination": {
"cursor": 0,
"cursor_us": "0",
"next_cursor": "sc.eyJ2IjoyLCJjIjoiMTc4OTQxNzY1MTAzMDAwMCIsImUiOiJ0aWt0b2svdXNlci9saWtlZCIsInAiOiJjdXJzb3IiLCJzIjpbIjc2ODQ3NTk1NDY0NTUxMzM0NTMiXX0",
"next_cursor_us": "1789417651030000",
"next_cursor_ms": 1789417651030,
"has_more": true,
"page": 1,
"page_size": 30
},
"total": 6828,
"warnings": [],
"scraped_at": "2026-09-21T08:33:12.418Z"
},
"... 29 more rows (positions 2-30, newest like first) ..."
],
"next_cursor": "eyJoIjoiY2hpcG90bGUiLCJpIjoiY2hpcG90bGUiLCJpZCI6eyJhY2MiOnsuLi59LCJtc1Rva2VuIjoiLi4uIiwib2RpbklkIjoiNzY1NzU4MzcwMDU4MjcxMzM1MCIsInR0d2lkIjoiMSU3Qy4uLiIsIndpZCI6Ijc2ODc4MzUwMjk0NTIxNzI2ODYifSwiayI6ImhhbmRsZSIsImxrIjp7fSwicCI6MSwicG9zIjozMCwidCI6InNjLmV5SjJJam95TENKaklqb2lNVGM0T1RReE56WTFNVEF6TURBd01DSXNJbVVpT2lKMGFXdDBiMnN2ZFhObGNpOXNhV3RsWkNJc0luQWlPaUpqZFhKemIzSWlMQ0p6SWpwYklqYzJPRFEzTlRrMU5EWTBOVFV4TXpNME5UTWlYWDAifQ"
}
}

Sample from the live catalog; arrays trimmed to 3 items. Results are in data.items.

FieldTypeExampleDescription
usernamesstringchipotle—
usernamestringchipotle—
user_idstring6646487634225135622—
statusstringok—
pageinteger1—
page_sizeinteger30—
cursorinteger0—
cursor_usstring0—
next_cursor_usstring1789417651030000—
has_morebooleantrue—
totalinteger6828—
repeats_removedinteger0—
droppedinteger0—
attemptsinteger1—
elapsed_secnumber3.7—
accountobject{…}—
media_accessobject{…}—
warningsarray[]—
itemsarray[2 items]The results.
next_cursorstringeyJoIjoiY2hpcG90bGUiLCJpIjoiY2hpcG90bGUiLCJpZ…Pass back as cursor for the next page. null on the last page.
items[].input_usernamestringchipotle—
items[].input_user_idnullnull—
items[].usernamestringchipotle—
items[].user_idstring6646487634225135622—
items[].statusstringok—
items[].errornullnull—
items[].positioninteger1—
items[].page_positioninteger1—
items[].video_idstring7685839095632891166—
items[].urlstringhttps://www.tiktok.com/@eatswithemmiee/video/…—
items[].descriptionstring@Chipotle tacos🌮🔥✨ Chipotle never misses bu…—
items[].content_typestringvideo—
items[].created_atstring2026-09-15T19:01:31.000Z—
items[].create_timeinteger1789498891—
items[].author_usernamestringeatswithemmiee—
items[].author_idstring7456588491607360554—
items[].author_display_namestringeatswithemmie—
items[].play_countinteger365400—
items[].like_countinteger57200—
items[].comment_countinteger158—
items[].share_countinteger1742—
items[].save_countinteger6296—
items[].repost_countinteger0—
items[].duration_secondsnumber110.393—
items[].thumbnail_urlstringhttps://p16-common-sign.tiktokcdn.com/...—
items[].play_urlstringhttps://v16-webapp-prime.tiktok.com/video/tos…—
items[].download_urlstringhttps://v16-webapp-prime.tiktok.com/video/tos…—
items[].image_urlsarray[]—
items[].hashtagsarray[6 items]—
items[].mentionsarray[1 item]—
items[].music_titlestringoriginal sound—
items[].music_authorstringeatswithemmie—
items[].regionstringUS—
items[].text_languagestringen—
items[].pinnedbooleanfalse—
items[].enrichedbooleanfalse—
items[].authorobject{…}—
items[].postobject{…}—
items[].computedobject{…}—
items[].accountobject{…}—
items[].media_accessobject{…}—
items[].paginationobject{…}—
items[].totalinteger6828—
items[].warningsarray[]—
items[].scraped_atstring2026-09-21T08:33:12.418Z—

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-user-liked/";
let params = { usernames: "chipotle" };
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.items ?? []));
if (!data.next_cursor) break; // null = last page
params = { cursor: data.next_cursor };
}

Failed calls are free. Branch on the HTTP status and read the message from error (or detail). Full details in Errors.

StatusMeaningRetry?Charged?
400Bad or missing input.No — fix the paramsNo
401 / 403Missing, invalid or revoked API key.No — fix the keyNo
402Out of credits (body has balance).No — top upNo
404Unknown endpoint slug.No — check the slugNo
429 / 503Busy or throttled.Yes — after Retry-AfterNo
5xxTarget site or upstream failure, or timeout.Yes — with backoffNo
  • Locked into the cursor: enrich_pages, region. Set them on the first call; later pages reuse them.
  • 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 Collection Videos — Structured TikTok data: send urls. Cursor-paginated, 1 credit per successful call.