Keyword search
curl --request GET \
--url https://api.scraperize.com/v1/tiktok/search/keyword \
--header 'x-api-key: <api-key>'import requests
url = "https://api.scraperize.com/v1/tiktok/search/keyword"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.scraperize.com/v1/tiktok/search/keyword', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.scraperize.com/v1/tiktok/search/keyword",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.scraperize.com/v1/tiktok/search/keyword"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.scraperize.com/v1/tiktok/search/keyword")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.scraperize.com/v1/tiktok/search/keyword")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": {
"query": "lagos",
"region": "NG",
"regionName": "Nigeria",
"servedRegion": "NG",
"videos": [
{
"id": "7684727102066658578",
"url": "https://www.tiktok.com/@realokadaman/video/7684727102066658578",
"type": "video",
"description": "Our question today why Lagos state tack-force are not posting our bike when they arrested like before this is our question may be there’s something going on the ground we don’t know that’s why we are here to expose the secret we are losing thousands of bikes presently in Lagos state why Nigerian we are all your youths pity for us to keep surviving under the prosperity of feeding ourselves #nigeriangovernment #Okada #lagos OKADA MAN",
"createdAt": "2026-09-12T19:06:07.000Z",
"language": "en",
"stats": {
"playCount": 305600,
"likeCount": 35200,
"commentCount": 776,
"shareCount": 22500,
"collectCount": 7445,
"repostCount": 0
},
"author": {
"id": "7510720009678210104",
"secUid": "MS4wLjABAAAANShGKSKT626JzyipEKLY8jYc14LpZOze4CG1X9N5SEFmYFEXHtpyEsqEDFhd3-Bh",
"handle": "realokadaman",
"nickname": "okada man",
"bio": "Bike riders ambassador in Africa WhatsApp 09068141390",
"avatarUrl": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/12908100026978c790f49747ccef657a~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=91af7fff&x-expires=1791381600&x-signature=AWK32U%2BJ7VjgLk3DUtrcgwqkdGk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my2",
"verified": false,
"privateAccount": false,
"stats": {
"followerCount": 53200,
"followingCount": 27,
"likeCount": 336300,
"videoCount": 414,
"friendCount": 0,
"diggCount": 5006
}
},
"video": {
"duration": 91,
"width": 576,
"height": 1024,
"definition": "540p",
"format": "mp4",
"codec": "h264",
"bitrate": 555440,
"quality": "lowest",
"size": 6322793,
"coverUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/oIoZEjFMzPc9bYNlBBDAIFphRsqgoBiEgaEefD~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signature=dohMxCu4ZqL%2B4rEZ%2BDV%2FLKjcykA%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2",
"originCoverUrl": "https://p19-common-sign.tiktokcdn.com/tos-alisg-p-0037/owoLQGcRlEyasNDyBqgFxpUeQfR8q9EBPEFhLA~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signature=o6FiMikYWHFgpcZoF6vPPxTCpqY%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2",
"dynamicCoverUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/osoEpEGDgxZB8FyFfeqRBHAhQslPqpQCa9HK0c~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signature=v3jtS0%2BELQXzMvam7RvbERkO3ac%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2",
"playUrl": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oo6EeoZrIshEcEpBYlBDfBjRF9AFQBagGwPqEP/?a=1988&bti=ODszNWYuMDE6&&bt=542&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=aTtlO2czNTM0ZmllZzMzaEBpanJzNGo5cnl0ZDMzODczNEBgYDMzYDY2X18xMy5eNGBeYSNlZnNvMmRjL2ZhLS1kMWBzcw%3D%3D&expire=1791384440&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=481ceddafd3f4b808bd9ef88b3b03db1&tk=tt_chain_token&btag=e00048000",
"downloadUrl": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c815-sg/oYcBpBPAmaeDcshKQQZRv9fFEYBFloEqgIjEZv/?a=1988&bti=ODszNWYuMDE6&&bt=1475&eid=20480&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=ZmVlNzdpNzQ8ZWY7NGk0NkBpanJzNGo5cnl0ZDMzODczNEAzNDQ0YTEtXi8xYTAwMWAwYSNlZnNvMmRjL2ZhLS1kMWBzcw%3D%3D&expire=1791384440&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=2f189ad59eb5573c18c97c570e8491ef&tk=tt_chain_token&btag=e00088000",
"volume": {
"loudness": -12,
"peak": 0.53703
},
"formats": [
{
"gearName": "adapt_lower_720_1",
"qualityType": 14,
"codec": "h265_hvc1",
"format": null,
"bitrate": 579733,
"fps": null,
"width": 720,
"height": 1280,
"size": 6599320,
"url": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/o4felk9ABQBESZgshYDYcqELpIGF0qRDaFjEyP/?a=1988&bti=ODszNWYuMDE6&&bt=566&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=O2Y5OjpkODg1OzZlOjU8ZkBpanJzNGo5cnl0ZDMzODczNEAxNS4wMzZjNmMxYC00MGI2YSNlZnNvMmRjL2ZhLS1kMWBzcw%3D%3D&expire=1791384440&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=c1a53782b3279acbd5dbd521b5393043&tk=tt_chain_token&btag=e00048000"
},
{
"gearName": "lowest_540_0",
"qualityType": 25,
"codec": "h264",
"format": null,
"bitrate": 555440,
"fps": null,
"width": 576,
"height": 1024,
"size": 6322793,
"url": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oo6EeoZrIshEcEpBYlBDfBjRF9AFQBagGwPqEP/?a=1988&bti=ODszNWYuMDE6&&bt=542&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=aTtlO2czNTM0ZmllZzMzaEBpanJzNGo5cnl0ZDMzODczNEBgYDMzYDY2X18xMy5eNGBeYSNlZnNvMmRjL2ZhLS1kMWBzcw%3D%3D&expire=1791384440&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=481ceddafd3f4b808bd9ef88b3b03db1&tk=tt_chain_token&btag=e00048000"
},
{
"gearName": "adapt_540_1",
"qualityType": 28,
"codec": "h265_hvc1",
"format": null,
"bitrate": 411808,
"fps": null,
"width": 576,
"height": 1024,
"size": 4687767,
"url": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/ooPqpgDyQBBEIGhBfEAgIBeF8al92GxFHisRcq/?a=1988&bti=ODszNWYuMDE6&&bt=402&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=ZmdoNDVlZGlpOzM5Zjk5OEBpanJzNGo5cnl0ZDMzODczNEAzLmEwMzBeXjUxYV5hYGIxYSNlZnNvMmRjL2ZhLS1kMWBzcw%3D%3D&expire=1791384440&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=4ed18f70e33f87e1c9e54e055f8558f6&tk=tt_chain_token&btag=e00048000"
}
],
"subtitles": []
},
"photo": null,
"music": {
"id": "7684727154324540181",
"title": "original sound",
"url": "https://www.tiktok.com/music/original-sound-7684727154324540181",
"authorName": "okada man",
"album": null,
"duration": 91,
"preciseDuration": null,
"shootDuration": null,
"original": true,
"isCopyrighted": false,
"isCommerceMusic": false,
"isUnlimitedMusic": false,
"isPrivate": false,
"coverUrl": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/12908100026978c790f49747ccef657a~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=91af7fff&x-expires=1791381600&x-signature=AWK32U%2BJ7VjgLk3DUtrcgwqkdGk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my2",
"playUrl": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-v-27dcd7/ooqAQml4iBhEaCFJeBXEUqJAApUqgpfCiKoDEv/?a=1988&bti=ODszNWYuMDE6&&bt=125&ft=GNDpcInz7ThqfO-GXq8Zmo&mime_type=audio_mpeg&rc=ajQ8OHg5cjt0ZDMzODU8NEBpajQ8OHg5cjt0ZDMzODU8NEBrYzJwMmRrMmZhLS1kMS1zYSNrYzJwMmRrMmZhLS1kMS1zcw%3D%3D&expire=1791215239&l=20261005224548CC93FFEA156288A9DC30&ply_type=3&policy=3&signature=2f47dd8426e8bb14347b4c2869f79589&tk=0&btag=e00050000",
"streaming": []
},
"hashtags": [
{
"id": "1662313548384262",
"name": "nigeriangovernment",
"description": null
},
{
"id": "41082360",
"name": "okada",
"description": null
},
{
"id": "75619",
"name": "lagos",
"description": null
}
],
"mentions": [],
"effects": [
{
"id": "2140391842",
"name": "MOVIE"
}
],
"stickerTexts": [],
"location": null,
"contentCategory": {
"id": 120,
"name": "General"
},
"anchors": [],
"warnings": [],
"playlistId": null,
"isAd": false,
"isPinned": false,
"isPrivate": false,
"isCommerce": false,
"aigcDescription": null,
"aigcLabelType": null,
"duetEnabled": true,
"stitchEnabled": true,
"shareEnabled": true,
"canRepost": true,
"commentStatus": 0,
"suggestedSearches": []
},
{
"id": "7540669549193039122",
"url": "https://www.tiktok.com/@jr.amani/video/7540669549193039122",
"type": "video",
"description": "#traditional #lagos #ijorabadia #ijora #virall @Minister4Enjoyment",
"createdAt": "2025-08-20T14:09:11.000Z",
"language": "un",
"stats": {
"playCount": 257300,
"likeCount": 5711,
"commentCount": 113,
"shareCount": 176,
"collectCount": 513,
"repostCount": 0
},
"author": {
"id": "7044823145950741510",
"secUid": "MS4wLjABAAAAfNQrVdQqF3vGI9OyfFETlmgxmy1tA9zpr78F9cRJwO9aJFVEqkb1LkHfDT6orKa1",
"handle": "jr.amani",
"nickname": "Emmy",
"bio": "Love, laughs & Nigerian content — your daily dose of family fun 💛 children 💗",
"avatarUrl": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/b4d936abfb5ac8e25b72237d0c222a7f~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=210d0a31&x-expires=1791381600&x-signature=cGU8RZ0fyGzNUZ%2FrspjTgdpBsR4%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my2",
"verified": false,
"privateAccount": false,
"stats": {
"followerCount": 1640,
"followingCount": 320,
"likeCount": 14500,
"videoCount": 448,
"friendCount": 0,
"diggCount": 2276
}
},
"video": {
"duration": 32,
"width": 480,
"height": 854,
"definition": "480p",
"format": "mp4",
"codec": "h264",
"bitrate": 1572595,
"quality": "normal",
"size": 6390045,
"coverUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/o0uIENCGEFAxnpIgIRWDUXpLde1ma3olsByfBw~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signature=sg1uPwSj%2FsBT5yYDGiuwPZm6W14%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2",
"originCoverUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/owp8QMURREndxeDLBtgF8pwOQf1poXEByGa3lA~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signature=6KPmy4huQybswpPs2XAvmXoBgmw%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2",
"dynamicCoverUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/oYGp1dlxDQCwMl3aALFJUgRX8Bf0ofBQErgyEp~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signature=ogyzyvy5aOGklFqben7gC8QDxvc%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2",
"playUrl": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oQDyGE3QaE1pXFuEeUKfCpYyvLGGBRgxloIdAB/?a=1988&bti=ODszNWYuMDE6&&bt=1535&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=Zjc5NjQ4NTpnN2ZnODwzOEBpM3hsaHU5cjh3NTMzODczNEAuY2IxLTI1X2MxLWNhMzAyYSMwX15wMmRzYWZhLS1kMTFzcw%3D%3D&expire=1791384381&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=7bf2912775b83993bb0439eca72270cc&tk=tt_chain_token&btag=e00048000",
"downloadUrl": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c815-sg/owwffFBK4AKaBKYfiwbXSHiAkuNfrLievggAMx/?a=1988&bti=ODszNWYuMDE6&&bt=3907&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=NztlZGU2NzM2ODw5PGZmN0BpM3hsaHU5cjh3NTMzODczNEBeMDQzNDNiXi4xNTU1YjNjYSMwX15wMmRzYWZhLS1kMTFzcw%3D%3D&expire=1791384381&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=f94e14df1f04b557235785036750512c&tk=tt_chain_token&btag=e00088000",
"volume": {
"loudness": -23.1,
"peak": 0.35075
},
"formats": [
{
"gearName": "lower_540_0",
"qualityType": 24,
"codec": "h264",
"format": null,
"bitrate": 2097803,
"fps": null,
"width": 576,
"height": 1024,
"size": 8524163,
"url": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/okxQkF8yBDrppULLkMFlgaIERA3UgfXfEQBoQd/?a=1988&bti=ODszNWYuMDE6&&bt=2048&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=ZGZnNDU8OjYzOTlnNGc0Z0BpM3hsaHU5cjh3NTMzODczNEA1MjAwMjI1Nl4xYmIxLV4tYSMwX15wMmRzYWZhLS1kMTFzcw%3D%3D&expire=1791384381&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=feb2674b6098f0de6641e0d807a5d1b5&tk=tt_chain_token&btag=e00048000"
},
{
"gearName": "adapt_lower_720_1",
"qualityType": 14,
"codec": "h265_hvc1",
"format": null,
"bitrate": 1608520,
"fps": null,
"width": 720,
"height": 1280,
"size": 6536021,
"url": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/ocImEQBORQppAzDoxF6vfe8yGa3EXEGgULdXBx/?a=1988&bti=ODszNWYuMDE6&&bt=1570&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=ZGc1Omg6NjlmOWhnaDVlNEBpM3hsaHU5cjh3NTMzODczNEAtMzJfNi4wXzMxNDAvNmAyYSMwX15wMmRzYWZhLS1kMTFzcw%3D%3D&expire=1791384381&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=fdcb915fe3371482443db4d7987b1ed8&tk=tt_chain_token&btag=e00048000"
},
{
"gearName": "normal_480_0",
"qualityType": 30,
"codec": "h264",
"format": null,
"bitrate": 1572595,
"fps": null,
"width": 480,
"height": 854,
"size": 6390045,
"url": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oQDyGE3QaE1pXFuEeUKfCpYyvLGGBRgxloIdAB/?a=1988&bti=ODszNWYuMDE6&&bt=1535&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=Zjc5NjQ4NTpnN2ZnODwzOEBpM3hsaHU5cjh3NTMzODczNEAuY2IxLTI1X2MxLWNhMzAyYSMwX15wMmRzYWZhLS1kMTFzcw%3D%3D&expire=1791384381&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=7bf2912775b83993bb0439eca72270cc&tk=tt_chain_token&btag=e00048000"
}
],
"subtitles": []
},
"photo": null,
"music": {
"id": "7483909320038468358",
"title": "original sound",
"url": "https://www.tiktok.com/music/original-sound-7483909320038468358",
"authorName": "JACK IPARIPATE",
"album": null,
"duration": 32,
"preciseDuration": null,
"shootDuration": null,
"original": true,
"isCopyrighted": false,
"isCommerceMusic": false,
"isUnlimitedMusic": false,
"isPrivate": false,
"coverUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/79310f9ff32cc69b31662d2633168f6b~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=95b12f50&x-expires=1791381600&x-signature=a1daAMrTQ5xKvUXqyUiDXeZbyQc%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my2",
"playUrl": "https://v16-webapp-prime.tiktok.com/video/tos/useast2a/tos-useast2a-v-27dcd7/oEASeJOeMfIsGIKLJBG4FfLLA8fcASuIVmXAIh/?a=1988&bti=ODszNWYuMDE6&&bt=125&ft=GNDpcInz7ThqfO-GXq8Zmo&mime_type=audio_mpeg&rc=ajw1cXU5cnM1eTMzNzU8M0Bpajw1cXU5cnM1eTMzNzU8M0AwMmxmMmQ0c2JgLS1kMTZzYSMwMmxmMmQ0c2JgLS1kMTZzcw%3D%3D&expire=1791215180&l=20261005224548CC93FFEA156288A9DC30&ply_type=3&policy=3&signature=ae82fc283da89998edbb7dd27df654de&tk=0&btag=e00050000",
"streaming": []
},
"hashtags": [
{
"id": "364353",
"name": "traditional",
"description": null
},
{
"id": "75619",
"name": "lagos",
"description": null
},
{
"id": "7015638879273222150",
"name": "ijorabadia",
"description": null
}
],
"mentions": [
{
"userId": "7244950240003720197",
"handle": "minister4enjoyment100",
"secUid": "MS4wLjABAAAAJA0CNtHkedY2-sW8Ha0xPU9pVq83uu1jnASppwTq8RKGltHRZTJ-PNXg6I3ghhhu"
}
],
"effects": [
{
"id": "2140391842",
"name": "MOVIE"
}
],
"stickerTexts": [],
"location": {
"id": "22535865247435187",
"name": "Badia",
"address": "Lagos, Nigeria",
"city": null,
"province": null,
"category": "Place and Address"
},
"contentCategory": {
"id": 120,
"name": "General"
},
"anchors": [],
"warnings": [],
"playlistId": null,
"isAd": false,
"isPinned": false,
"isPrivate": false,
"isCommerce": false,
"aigcDescription": null,
"aigcLabelType": null,
"duetEnabled": true,
"stitchEnabled": true,
"shareEnabled": true,
"canRepost": true,
"commentStatus": 0,
"suggestedSearches": [
"aye cult battle ijora badia2026 at aliwo",
"the street fighter ijora badia vs aliwo",
"obale vs akamaye fight ijora badia"
]
},
{
"id": "7670142818631044370",
"url": "https://www.tiktok.com/@__slimtalldora/video/7670142818631044370",
"type": "video",
"description": "#CapCut #foryoupage #trend #__slimtalldora pool time at the continental Lagos❤️",
"createdAt": "2026-08-04T11:51:34.000Z",
"language": "en",
"stats": {
"playCount": 65500,
"likeCount": 1898,
"commentCount": 40,
"shareCount": 54,
"collectCount": 267,
"repostCount": 0
},
"author": {
"id": "7057403778752037893",
"secUid": "MS4wLjABAAAAMHMBDmwudz_iVgfeqWEcM6-OdRkpRRclH16IfQ2YqANKrv_hpYfFwctFGtzA0jel",
"handle": "__slimtalldora",
"nickname": "__slimtalldora",
"bio": "Hi I'm Dora🤭",
"avatarUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/947783683b0b9fab698e666e792d23da~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=0a391b6d&x-expires=1791381600&x-signature=%2Fp7zIQvG4LzM1eLHepsWFjHGB7c%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my2",
"verified": false,
"privateAccount": false,
"stats": {
"followerCount": 4540,
"followingCount": 1318,
"likeCount": 85100,
"videoCount": 2785,
"friendCount": 0,
"diggCount": 44300
}
},
"video": {
"duration": 11,
"width": 576,
"height": 1024,
"definition": "540p",
"format": "mp4",
"codec": "h264",
"bitrate": 982428,
"quality": "lowest",
"size": 1461362,
"coverUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/owq4cbxZ7B4IdAFRqBfIykjFlcEHgTfVPF0DES~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signature=0R3vbM0nH4Wc8jf3cY5NX0P8Rig%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2",
"originCoverUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/oYIxICBGR0HcAcDqZFpEf4LySFqE7EagcfdkBi~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signature=99qvTx0Yg89aWJ3a9Ay5afgBBzE%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2",
"dynamicCoverUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/o0kIke6xfAgjGpGQHPUIA3C40D4LQaQkUwLzeB~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signature=zEhmW%2FTAtmVYNtAU3nOT1mTv4bg%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2",
"playUrl": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oYqZcLxZ7B4IdAFRqBfEylOQBcEHg4fN5F0DES/?a=1988&bti=ODszNWYuMDE6&&bt=959&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=Mzs6ZDlkNTs1N2Q8ODU4OEBpM3JpaG85cnh3PDMzODczNEAxMGFjYDEzNl8xMi4wNDUwYSM2czUzMmRzL2xhLS1kMWBzcw%3D%3D&expire=1791384360&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=ffe7b65902a1a32a40b194968b54aea8&tk=tt_chain_token&btag=e00070000",
"downloadUrl": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oMUzQjwIAGIffArIkpPCeLSULD4d3Ikzj64P1g/?a=1988&bti=ODszNWYuMDE6&&bt=2989&eid=20480&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=cnF8b2hsc2d3SkBwaHIxaDFybndmaWQ4Zjg7M2U4ZGlmNjZpZEBpM3JpaG85cnh3PDMzODczNEBjRl5Nc3FePmJKYSNvYF90aHFmOiNhL2I0MF9jNmIxM2E2MGAwYSM2czUzMmRzL2xhLS1kMWBzcw%3D%3D&expire=1791384360&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=c8594d6f580f0ca2d7f6c3027d1b79c0&tk=tt_chain_token&btag=e000b0000",
"volume": {
"loudness": -23.5,
"peak": 0.30549
},
"formats": [
{
"gearName": "lowest_540_0",
"qualityType": 25,
"codec": "h264",
"format": null,
"bitrate": 982428,
"fps": null,
"width": 576,
"height": 1024,
"size": 1461362,
"url": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oYqZcLxZ7B4IdAFRqBfEylOQBcEHg4fN5F0DES/?a=1988&bti=ODszNWYuMDE6&&bt=959&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=Mzs6ZDlkNTs1N2Q8ODU4OEBpM3JpaG85cnh3PDMzODczNEAxMGFjYDEzNl8xMi4wNDUwYSM2czUzMmRzL2xhLS1kMWBzcw%3D%3D&expire=1791384360&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=ffe7b65902a1a32a40b194968b54aea8&tk=tt_chain_token&btag=e00070000"
}
],
"subtitles": []
},
"photo": null,
"music": {
"id": "7649070669913361173",
"title": "THAT GIRL X COME CLOSER SPXNZO EDIT",
"url": "https://www.tiktok.com/music/THAT-GIRL-X-COME-CLOSER-SPXNZO-EDIT-7649070669913361173",
"authorName": "deejayspxnzo",
"album": null,
"duration": 27,
"preciseDuration": null,
"shootDuration": null,
"original": true,
"isCopyrighted": false,
"isCommerceMusic": false,
"isUnlimitedMusic": false,
"isPrivate": false,
"coverUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/a940d0cf04de032f88718dbddc5e11a6~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=ededef4a&x-expires=1791381600&x-signature=9pIk%2FMS%2F5UkUUy7WN0o3ay1oszU%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my2",
"playUrl": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-v-27dcd7/oQABAAbuEQCBYlUACPUa1EAi0imn9ii7AADtQ/?a=1988&bti=ODszNWYuMDE6&&bt=125&ft=GNDpcInz7ThqfO-GXq8Zmo&mime_type=audio_mpeg&rc=MzY5O3U5cmppOzMzODU8NEBpMzY5O3U5cmppOzMzODU8NEBucGQ1MmQ0XmdhLS1kMS1zYSNucGQ1MmQ0XmdhLS1kMS1zcw%3D%3D&expire=1791215175&l=20261005224548CC93FFEA156288A9DC30&ply_type=3&policy=3&signature=e11e3b0a48d25e4fb9b2b77293aeed55&tk=0&btag=e00078000",
"streaming": []
},
"hashtags": [
{
"id": "1663935709411330",
"name": "capcut",
"description": "CapCut is a new, easy-to-use video editing tool designed for mobile platforms. CapCut provides users with a wide range of video editing functions, filters, audio & visual effects, video templates, while keeping it free of charge and ads-free. Everyone can be a creator by using CapCut. \n\nStart creating your cool videos today: \nhttps://capcut.onelink.me/XKqI/228cad85"
},
{
"id": "88764338",
"name": "foryoupage",
"description": null
},
{
"id": "44895",
"name": "trend",
"description": null
}
],
"mentions": [],
"effects": [
{
"id": "2140391842",
"name": "MOVIE"
}
],
"stickerTexts": [
"💕"
],
"location": null,
"contentCategory": {
"id": 120,
"name": "General"
},
"anchors": [
{
"id": "0",
"type": 54,
"keyword": "CapCut · Editing made easy",
"description": "CapCut · Video Editor",
"url": "https://www.capcut.com/tools/desktop-video-editor?channel=capcutpc_ttweb_anchor_edit1&download_channel=capcutpc_ttweb_anchor_edit1&enter_from=capcutpc_ttweb_anchor_edit1&force_dp=1&from_page=capcutpc_ttweb_anchor_edit1&type=tools",
"iconUrl": "https://p16-common-sign.tiktokcdn.com/tiktok-obj/capcut_logo_64px_bk.png~tplv-tiktokx-origin.image?dr=14566&x-expires=1791230400&x-signature=CWfYyIFO1N%2FLSGJtr3w7Jbbpa3M%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=9b759fb9&idc=my2"
}
],
"warnings": [],
"playlistId": null,
"isAd": false,
"isPinned": false,
"isPrivate": false,
"isCommerce": false,
"aigcDescription": null,
"aigcLabelType": null,
"duetEnabled": true,
"stitchEnabled": true,
"shareEnabled": true,
"canRepost": true,
"commentStatus": 0,
"suggestedSearches": []
}
],
"mediaHeaders": {
"Cookie": "tt_chain_token=<session token returned by the API>",
"Referer": "https://www.tiktok.com/"
},
"count": 12,
"cursor": "12_20261005224548CC93FFEA156288A9DC30",
"hasMore": true,
"fetchedAt": "2026-10-05T14:45:50.785Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}{
"error": {
"code": "BAD_REQUEST",
"message": "The request was invalid.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "API key required — pass it in the `x-api-key` header.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "INSUFFICIENT_CREDITS",
"message": "This request costs 1 credit, but your balance is 0. Top up to continue.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "The requested content was not found (it may not exist, be deleted, or be private).",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Request validation failed",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"details": [
{
"path": "url",
"message": "Required"
}
]
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded — max 100 requests per 60s. Retry in ~30s.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "UPSTREAM_BLOCKED",
"message": "The source is temporarily unavailable. Please try again shortly.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}TikTok
Keyword search
Returns the TikTok videos matching a keyword query in a region (default NG), about 12 per page in TikTok’s relevance order. Each video comes with its description, created date, language, stats (views, likes, comments, shares, saves, reposts — large view/like/comment/share counts are rounded; saves are exact), author (with stats, also rounded), video details (duration, size, covers, play/download URLs, every rendition, subtitles), music (with its TikTok sound page and Apple Music / Spotify links), hashtags, mentions, tagged place, effects, stickers, link anchors, AI-generated labels, flags and related searches. servedRegion is the region the results are for. Pass the returned cursor (with the same query and region) to get the next page; it is null on the last page.
About the results: TikTok matches loosely, so even an unusual query returns a few close matches. Results can shift slightly between identical searches. Results are videos only; filtering by post date and sorting are not available. Search isn’t available in every region (e.g. the United States); then the response is a 404 and another region may work. The first search in a region can take up to about a minute; later ones are much faster.
Downloading video files: TikTok only serves video.playUrl, video.downloadUrl and video.formats[].url to requests that send the Cookie and Referer headers returned in mediaHeaders (without them: 403 Access Denied). Send both headers from your code, e.g. curl -H "Cookie: <mediaHeaders.Cookie>" -H "Referer: <mediaHeaders.Referer>" "<video.playUrl>" -o video.mp4. Covers, music and subtitles need no headers. Media URLs expire within hours.
Watermarks: playUrl and every formats[].url are watermark-free; downloadUrl is TikTok’s download copy with the TikTok logo and @username burned in.
GET
/
v1
/
tiktok
/
search
/
keyword
Keyword search
curl --request GET \
--url https://api.scraperize.com/v1/tiktok/search/keyword \
--header 'x-api-key: <api-key>'import requests
url = "https://api.scraperize.com/v1/tiktok/search/keyword"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.scraperize.com/v1/tiktok/search/keyword', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.scraperize.com/v1/tiktok/search/keyword",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.scraperize.com/v1/tiktok/search/keyword"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.scraperize.com/v1/tiktok/search/keyword")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.scraperize.com/v1/tiktok/search/keyword")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": {
"query": "lagos",
"region": "NG",
"regionName": "Nigeria",
"servedRegion": "NG",
"videos": [
{
"id": "7684727102066658578",
"url": "https://www.tiktok.com/@realokadaman/video/7684727102066658578",
"type": "video",
"description": "Our question today why Lagos state tack-force are not posting our bike when they arrested like before this is our question may be there’s something going on the ground we don’t know that’s why we are here to expose the secret we are losing thousands of bikes presently in Lagos state why Nigerian we are all your youths pity for us to keep surviving under the prosperity of feeding ourselves #nigeriangovernment #Okada #lagos OKADA MAN",
"createdAt": "2026-09-12T19:06:07.000Z",
"language": "en",
"stats": {
"playCount": 305600,
"likeCount": 35200,
"commentCount": 776,
"shareCount": 22500,
"collectCount": 7445,
"repostCount": 0
},
"author": {
"id": "7510720009678210104",
"secUid": "MS4wLjABAAAANShGKSKT626JzyipEKLY8jYc14LpZOze4CG1X9N5SEFmYFEXHtpyEsqEDFhd3-Bh",
"handle": "realokadaman",
"nickname": "okada man",
"bio": "Bike riders ambassador in Africa WhatsApp 09068141390",
"avatarUrl": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/12908100026978c790f49747ccef657a~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=91af7fff&x-expires=1791381600&x-signature=AWK32U%2BJ7VjgLk3DUtrcgwqkdGk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my2",
"verified": false,
"privateAccount": false,
"stats": {
"followerCount": 53200,
"followingCount": 27,
"likeCount": 336300,
"videoCount": 414,
"friendCount": 0,
"diggCount": 5006
}
},
"video": {
"duration": 91,
"width": 576,
"height": 1024,
"definition": "540p",
"format": "mp4",
"codec": "h264",
"bitrate": 555440,
"quality": "lowest",
"size": 6322793,
"coverUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/oIoZEjFMzPc9bYNlBBDAIFphRsqgoBiEgaEefD~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signature=dohMxCu4ZqL%2B4rEZ%2BDV%2FLKjcykA%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2",
"originCoverUrl": "https://p19-common-sign.tiktokcdn.com/tos-alisg-p-0037/owoLQGcRlEyasNDyBqgFxpUeQfR8q9EBPEFhLA~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signature=o6FiMikYWHFgpcZoF6vPPxTCpqY%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2",
"dynamicCoverUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/osoEpEGDgxZB8FyFfeqRBHAhQslPqpQCa9HK0c~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signature=v3jtS0%2BELQXzMvam7RvbERkO3ac%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2",
"playUrl": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oo6EeoZrIshEcEpBYlBDfBjRF9AFQBagGwPqEP/?a=1988&bti=ODszNWYuMDE6&&bt=542&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=aTtlO2czNTM0ZmllZzMzaEBpanJzNGo5cnl0ZDMzODczNEBgYDMzYDY2X18xMy5eNGBeYSNlZnNvMmRjL2ZhLS1kMWBzcw%3D%3D&expire=1791384440&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=481ceddafd3f4b808bd9ef88b3b03db1&tk=tt_chain_token&btag=e00048000",
"downloadUrl": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c815-sg/oYcBpBPAmaeDcshKQQZRv9fFEYBFloEqgIjEZv/?a=1988&bti=ODszNWYuMDE6&&bt=1475&eid=20480&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=ZmVlNzdpNzQ8ZWY7NGk0NkBpanJzNGo5cnl0ZDMzODczNEAzNDQ0YTEtXi8xYTAwMWAwYSNlZnNvMmRjL2ZhLS1kMWBzcw%3D%3D&expire=1791384440&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=2f189ad59eb5573c18c97c570e8491ef&tk=tt_chain_token&btag=e00088000",
"volume": {
"loudness": -12,
"peak": 0.53703
},
"formats": [
{
"gearName": "adapt_lower_720_1",
"qualityType": 14,
"codec": "h265_hvc1",
"format": null,
"bitrate": 579733,
"fps": null,
"width": 720,
"height": 1280,
"size": 6599320,
"url": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/o4felk9ABQBESZgshYDYcqELpIGF0qRDaFjEyP/?a=1988&bti=ODszNWYuMDE6&&bt=566&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=O2Y5OjpkODg1OzZlOjU8ZkBpanJzNGo5cnl0ZDMzODczNEAxNS4wMzZjNmMxYC00MGI2YSNlZnNvMmRjL2ZhLS1kMWBzcw%3D%3D&expire=1791384440&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=c1a53782b3279acbd5dbd521b5393043&tk=tt_chain_token&btag=e00048000"
},
{
"gearName": "lowest_540_0",
"qualityType": 25,
"codec": "h264",
"format": null,
"bitrate": 555440,
"fps": null,
"width": 576,
"height": 1024,
"size": 6322793,
"url": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oo6EeoZrIshEcEpBYlBDfBjRF9AFQBagGwPqEP/?a=1988&bti=ODszNWYuMDE6&&bt=542&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=aTtlO2czNTM0ZmllZzMzaEBpanJzNGo5cnl0ZDMzODczNEBgYDMzYDY2X18xMy5eNGBeYSNlZnNvMmRjL2ZhLS1kMWBzcw%3D%3D&expire=1791384440&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=481ceddafd3f4b808bd9ef88b3b03db1&tk=tt_chain_token&btag=e00048000"
},
{
"gearName": "adapt_540_1",
"qualityType": 28,
"codec": "h265_hvc1",
"format": null,
"bitrate": 411808,
"fps": null,
"width": 576,
"height": 1024,
"size": 4687767,
"url": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/ooPqpgDyQBBEIGhBfEAgIBeF8al92GxFHisRcq/?a=1988&bti=ODszNWYuMDE6&&bt=402&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=ZmdoNDVlZGlpOzM5Zjk5OEBpanJzNGo5cnl0ZDMzODczNEAzLmEwMzBeXjUxYV5hYGIxYSNlZnNvMmRjL2ZhLS1kMWBzcw%3D%3D&expire=1791384440&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=4ed18f70e33f87e1c9e54e055f8558f6&tk=tt_chain_token&btag=e00048000"
}
],
"subtitles": []
},
"photo": null,
"music": {
"id": "7684727154324540181",
"title": "original sound",
"url": "https://www.tiktok.com/music/original-sound-7684727154324540181",
"authorName": "okada man",
"album": null,
"duration": 91,
"preciseDuration": null,
"shootDuration": null,
"original": true,
"isCopyrighted": false,
"isCommerceMusic": false,
"isUnlimitedMusic": false,
"isPrivate": false,
"coverUrl": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/12908100026978c790f49747ccef657a~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=91af7fff&x-expires=1791381600&x-signature=AWK32U%2BJ7VjgLk3DUtrcgwqkdGk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my2",
"playUrl": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-v-27dcd7/ooqAQml4iBhEaCFJeBXEUqJAApUqgpfCiKoDEv/?a=1988&bti=ODszNWYuMDE6&&bt=125&ft=GNDpcInz7ThqfO-GXq8Zmo&mime_type=audio_mpeg&rc=ajQ8OHg5cjt0ZDMzODU8NEBpajQ8OHg5cjt0ZDMzODU8NEBrYzJwMmRrMmZhLS1kMS1zYSNrYzJwMmRrMmZhLS1kMS1zcw%3D%3D&expire=1791215239&l=20261005224548CC93FFEA156288A9DC30&ply_type=3&policy=3&signature=2f47dd8426e8bb14347b4c2869f79589&tk=0&btag=e00050000",
"streaming": []
},
"hashtags": [
{
"id": "1662313548384262",
"name": "nigeriangovernment",
"description": null
},
{
"id": "41082360",
"name": "okada",
"description": null
},
{
"id": "75619",
"name": "lagos",
"description": null
}
],
"mentions": [],
"effects": [
{
"id": "2140391842",
"name": "MOVIE"
}
],
"stickerTexts": [],
"location": null,
"contentCategory": {
"id": 120,
"name": "General"
},
"anchors": [],
"warnings": [],
"playlistId": null,
"isAd": false,
"isPinned": false,
"isPrivate": false,
"isCommerce": false,
"aigcDescription": null,
"aigcLabelType": null,
"duetEnabled": true,
"stitchEnabled": true,
"shareEnabled": true,
"canRepost": true,
"commentStatus": 0,
"suggestedSearches": []
},
{
"id": "7540669549193039122",
"url": "https://www.tiktok.com/@jr.amani/video/7540669549193039122",
"type": "video",
"description": "#traditional #lagos #ijorabadia #ijora #virall @Minister4Enjoyment",
"createdAt": "2025-08-20T14:09:11.000Z",
"language": "un",
"stats": {
"playCount": 257300,
"likeCount": 5711,
"commentCount": 113,
"shareCount": 176,
"collectCount": 513,
"repostCount": 0
},
"author": {
"id": "7044823145950741510",
"secUid": "MS4wLjABAAAAfNQrVdQqF3vGI9OyfFETlmgxmy1tA9zpr78F9cRJwO9aJFVEqkb1LkHfDT6orKa1",
"handle": "jr.amani",
"nickname": "Emmy",
"bio": "Love, laughs & Nigerian content — your daily dose of family fun 💛 children 💗",
"avatarUrl": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/b4d936abfb5ac8e25b72237d0c222a7f~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=210d0a31&x-expires=1791381600&x-signature=cGU8RZ0fyGzNUZ%2FrspjTgdpBsR4%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my2",
"verified": false,
"privateAccount": false,
"stats": {
"followerCount": 1640,
"followingCount": 320,
"likeCount": 14500,
"videoCount": 448,
"friendCount": 0,
"diggCount": 2276
}
},
"video": {
"duration": 32,
"width": 480,
"height": 854,
"definition": "480p",
"format": "mp4",
"codec": "h264",
"bitrate": 1572595,
"quality": "normal",
"size": 6390045,
"coverUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/o0uIENCGEFAxnpIgIRWDUXpLde1ma3olsByfBw~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signature=sg1uPwSj%2FsBT5yYDGiuwPZm6W14%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2",
"originCoverUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/owp8QMURREndxeDLBtgF8pwOQf1poXEByGa3lA~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signature=6KPmy4huQybswpPs2XAvmXoBgmw%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2",
"dynamicCoverUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/oYGp1dlxDQCwMl3aALFJUgRX8Bf0ofBQErgyEp~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signature=ogyzyvy5aOGklFqben7gC8QDxvc%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2",
"playUrl": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oQDyGE3QaE1pXFuEeUKfCpYyvLGGBRgxloIdAB/?a=1988&bti=ODszNWYuMDE6&&bt=1535&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=Zjc5NjQ4NTpnN2ZnODwzOEBpM3hsaHU5cjh3NTMzODczNEAuY2IxLTI1X2MxLWNhMzAyYSMwX15wMmRzYWZhLS1kMTFzcw%3D%3D&expire=1791384381&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=7bf2912775b83993bb0439eca72270cc&tk=tt_chain_token&btag=e00048000",
"downloadUrl": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c815-sg/owwffFBK4AKaBKYfiwbXSHiAkuNfrLievggAMx/?a=1988&bti=ODszNWYuMDE6&&bt=3907&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=NztlZGU2NzM2ODw5PGZmN0BpM3hsaHU5cjh3NTMzODczNEBeMDQzNDNiXi4xNTU1YjNjYSMwX15wMmRzYWZhLS1kMTFzcw%3D%3D&expire=1791384381&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=f94e14df1f04b557235785036750512c&tk=tt_chain_token&btag=e00088000",
"volume": {
"loudness": -23.1,
"peak": 0.35075
},
"formats": [
{
"gearName": "lower_540_0",
"qualityType": 24,
"codec": "h264",
"format": null,
"bitrate": 2097803,
"fps": null,
"width": 576,
"height": 1024,
"size": 8524163,
"url": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/okxQkF8yBDrppULLkMFlgaIERA3UgfXfEQBoQd/?a=1988&bti=ODszNWYuMDE6&&bt=2048&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=ZGZnNDU8OjYzOTlnNGc0Z0BpM3hsaHU5cjh3NTMzODczNEA1MjAwMjI1Nl4xYmIxLV4tYSMwX15wMmRzYWZhLS1kMTFzcw%3D%3D&expire=1791384381&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=feb2674b6098f0de6641e0d807a5d1b5&tk=tt_chain_token&btag=e00048000"
},
{
"gearName": "adapt_lower_720_1",
"qualityType": 14,
"codec": "h265_hvc1",
"format": null,
"bitrate": 1608520,
"fps": null,
"width": 720,
"height": 1280,
"size": 6536021,
"url": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/ocImEQBORQppAzDoxF6vfe8yGa3EXEGgULdXBx/?a=1988&bti=ODszNWYuMDE6&&bt=1570&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=ZGc1Omg6NjlmOWhnaDVlNEBpM3hsaHU5cjh3NTMzODczNEAtMzJfNi4wXzMxNDAvNmAyYSMwX15wMmRzYWZhLS1kMTFzcw%3D%3D&expire=1791384381&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=fdcb915fe3371482443db4d7987b1ed8&tk=tt_chain_token&btag=e00048000"
},
{
"gearName": "normal_480_0",
"qualityType": 30,
"codec": "h264",
"format": null,
"bitrate": 1572595,
"fps": null,
"width": 480,
"height": 854,
"size": 6390045,
"url": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oQDyGE3QaE1pXFuEeUKfCpYyvLGGBRgxloIdAB/?a=1988&bti=ODszNWYuMDE6&&bt=1535&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=Zjc5NjQ4NTpnN2ZnODwzOEBpM3hsaHU5cjh3NTMzODczNEAuY2IxLTI1X2MxLWNhMzAyYSMwX15wMmRzYWZhLS1kMTFzcw%3D%3D&expire=1791384381&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=7bf2912775b83993bb0439eca72270cc&tk=tt_chain_token&btag=e00048000"
}
],
"subtitles": []
},
"photo": null,
"music": {
"id": "7483909320038468358",
"title": "original sound",
"url": "https://www.tiktok.com/music/original-sound-7483909320038468358",
"authorName": "JACK IPARIPATE",
"album": null,
"duration": 32,
"preciseDuration": null,
"shootDuration": null,
"original": true,
"isCopyrighted": false,
"isCommerceMusic": false,
"isUnlimitedMusic": false,
"isPrivate": false,
"coverUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/79310f9ff32cc69b31662d2633168f6b~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=95b12f50&x-expires=1791381600&x-signature=a1daAMrTQ5xKvUXqyUiDXeZbyQc%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my2",
"playUrl": "https://v16-webapp-prime.tiktok.com/video/tos/useast2a/tos-useast2a-v-27dcd7/oEASeJOeMfIsGIKLJBG4FfLLA8fcASuIVmXAIh/?a=1988&bti=ODszNWYuMDE6&&bt=125&ft=GNDpcInz7ThqfO-GXq8Zmo&mime_type=audio_mpeg&rc=ajw1cXU5cnM1eTMzNzU8M0Bpajw1cXU5cnM1eTMzNzU8M0AwMmxmMmQ0c2JgLS1kMTZzYSMwMmxmMmQ0c2JgLS1kMTZzcw%3D%3D&expire=1791215180&l=20261005224548CC93FFEA156288A9DC30&ply_type=3&policy=3&signature=ae82fc283da89998edbb7dd27df654de&tk=0&btag=e00050000",
"streaming": []
},
"hashtags": [
{
"id": "364353",
"name": "traditional",
"description": null
},
{
"id": "75619",
"name": "lagos",
"description": null
},
{
"id": "7015638879273222150",
"name": "ijorabadia",
"description": null
}
],
"mentions": [
{
"userId": "7244950240003720197",
"handle": "minister4enjoyment100",
"secUid": "MS4wLjABAAAAJA0CNtHkedY2-sW8Ha0xPU9pVq83uu1jnASppwTq8RKGltHRZTJ-PNXg6I3ghhhu"
}
],
"effects": [
{
"id": "2140391842",
"name": "MOVIE"
}
],
"stickerTexts": [],
"location": {
"id": "22535865247435187",
"name": "Badia",
"address": "Lagos, Nigeria",
"city": null,
"province": null,
"category": "Place and Address"
},
"contentCategory": {
"id": 120,
"name": "General"
},
"anchors": [],
"warnings": [],
"playlistId": null,
"isAd": false,
"isPinned": false,
"isPrivate": false,
"isCommerce": false,
"aigcDescription": null,
"aigcLabelType": null,
"duetEnabled": true,
"stitchEnabled": true,
"shareEnabled": true,
"canRepost": true,
"commentStatus": 0,
"suggestedSearches": [
"aye cult battle ijora badia2026 at aliwo",
"the street fighter ijora badia vs aliwo",
"obale vs akamaye fight ijora badia"
]
},
{
"id": "7670142818631044370",
"url": "https://www.tiktok.com/@__slimtalldora/video/7670142818631044370",
"type": "video",
"description": "#CapCut #foryoupage #trend #__slimtalldora pool time at the continental Lagos❤️",
"createdAt": "2026-08-04T11:51:34.000Z",
"language": "en",
"stats": {
"playCount": 65500,
"likeCount": 1898,
"commentCount": 40,
"shareCount": 54,
"collectCount": 267,
"repostCount": 0
},
"author": {
"id": "7057403778752037893",
"secUid": "MS4wLjABAAAAMHMBDmwudz_iVgfeqWEcM6-OdRkpRRclH16IfQ2YqANKrv_hpYfFwctFGtzA0jel",
"handle": "__slimtalldora",
"nickname": "__slimtalldora",
"bio": "Hi I'm Dora🤭",
"avatarUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/947783683b0b9fab698e666e792d23da~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=0a391b6d&x-expires=1791381600&x-signature=%2Fp7zIQvG4LzM1eLHepsWFjHGB7c%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my2",
"verified": false,
"privateAccount": false,
"stats": {
"followerCount": 4540,
"followingCount": 1318,
"likeCount": 85100,
"videoCount": 2785,
"friendCount": 0,
"diggCount": 44300
}
},
"video": {
"duration": 11,
"width": 576,
"height": 1024,
"definition": "540p",
"format": "mp4",
"codec": "h264",
"bitrate": 982428,
"quality": "lowest",
"size": 1461362,
"coverUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/owq4cbxZ7B4IdAFRqBfIykjFlcEHgTfVPF0DES~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signature=0R3vbM0nH4Wc8jf3cY5NX0P8Rig%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2",
"originCoverUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/oYIxICBGR0HcAcDqZFpEf4LySFqE7EagcfdkBi~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signature=99qvTx0Yg89aWJ3a9Ay5afgBBzE%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2",
"dynamicCoverUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/o0kIke6xfAgjGpGQHPUIA3C40D4LQaQkUwLzeB~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signature=zEhmW%2FTAtmVYNtAU3nOT1mTv4bg%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2",
"playUrl": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oYqZcLxZ7B4IdAFRqBfEylOQBcEHg4fN5F0DES/?a=1988&bti=ODszNWYuMDE6&&bt=959&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=Mzs6ZDlkNTs1N2Q8ODU4OEBpM3JpaG85cnh3PDMzODczNEAxMGFjYDEzNl8xMi4wNDUwYSM2czUzMmRzL2xhLS1kMWBzcw%3D%3D&expire=1791384360&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=ffe7b65902a1a32a40b194968b54aea8&tk=tt_chain_token&btag=e00070000",
"downloadUrl": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oMUzQjwIAGIffArIkpPCeLSULD4d3Ikzj64P1g/?a=1988&bti=ODszNWYuMDE6&&bt=2989&eid=20480&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=cnF8b2hsc2d3SkBwaHIxaDFybndmaWQ4Zjg7M2U4ZGlmNjZpZEBpM3JpaG85cnh3PDMzODczNEBjRl5Nc3FePmJKYSNvYF90aHFmOiNhL2I0MF9jNmIxM2E2MGAwYSM2czUzMmRzL2xhLS1kMWBzcw%3D%3D&expire=1791384360&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=c8594d6f580f0ca2d7f6c3027d1b79c0&tk=tt_chain_token&btag=e000b0000",
"volume": {
"loudness": -23.5,
"peak": 0.30549
},
"formats": [
{
"gearName": "lowest_540_0",
"qualityType": 25,
"codec": "h264",
"format": null,
"bitrate": 982428,
"fps": null,
"width": 576,
"height": 1024,
"size": 1461362,
"url": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oYqZcLxZ7B4IdAFRqBfEylOQBcEHg4fN5F0DES/?a=1988&bti=ODszNWYuMDE6&&bt=959&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=Mzs6ZDlkNTs1N2Q8ODU4OEBpM3JpaG85cnh3PDMzODczNEAxMGFjYDEzNl8xMi4wNDUwYSM2czUzMmRzL2xhLS1kMWBzcw%3D%3D&expire=1791384360&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=ffe7b65902a1a32a40b194968b54aea8&tk=tt_chain_token&btag=e00070000"
}
],
"subtitles": []
},
"photo": null,
"music": {
"id": "7649070669913361173",
"title": "THAT GIRL X COME CLOSER SPXNZO EDIT",
"url": "https://www.tiktok.com/music/THAT-GIRL-X-COME-CLOSER-SPXNZO-EDIT-7649070669913361173",
"authorName": "deejayspxnzo",
"album": null,
"duration": 27,
"preciseDuration": null,
"shootDuration": null,
"original": true,
"isCopyrighted": false,
"isCommerceMusic": false,
"isUnlimitedMusic": false,
"isPrivate": false,
"coverUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/a940d0cf04de032f88718dbddc5e11a6~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=ededef4a&x-expires=1791381600&x-signature=9pIk%2FMS%2F5UkUUy7WN0o3ay1oszU%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my2",
"playUrl": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-v-27dcd7/oQABAAbuEQCBYlUACPUa1EAi0imn9ii7AADtQ/?a=1988&bti=ODszNWYuMDE6&&bt=125&ft=GNDpcInz7ThqfO-GXq8Zmo&mime_type=audio_mpeg&rc=MzY5O3U5cmppOzMzODU8NEBpMzY5O3U5cmppOzMzODU8NEBucGQ1MmQ0XmdhLS1kMS1zYSNucGQ1MmQ0XmdhLS1kMS1zcw%3D%3D&expire=1791215175&l=20261005224548CC93FFEA156288A9DC30&ply_type=3&policy=3&signature=e11e3b0a48d25e4fb9b2b77293aeed55&tk=0&btag=e00078000",
"streaming": []
},
"hashtags": [
{
"id": "1663935709411330",
"name": "capcut",
"description": "CapCut is a new, easy-to-use video editing tool designed for mobile platforms. CapCut provides users with a wide range of video editing functions, filters, audio & visual effects, video templates, while keeping it free of charge and ads-free. Everyone can be a creator by using CapCut. \n\nStart creating your cool videos today: \nhttps://capcut.onelink.me/XKqI/228cad85"
},
{
"id": "88764338",
"name": "foryoupage",
"description": null
},
{
"id": "44895",
"name": "trend",
"description": null
}
],
"mentions": [],
"effects": [
{
"id": "2140391842",
"name": "MOVIE"
}
],
"stickerTexts": [
"💕"
],
"location": null,
"contentCategory": {
"id": 120,
"name": "General"
},
"anchors": [
{
"id": "0",
"type": 54,
"keyword": "CapCut · Editing made easy",
"description": "CapCut · Video Editor",
"url": "https://www.capcut.com/tools/desktop-video-editor?channel=capcutpc_ttweb_anchor_edit1&download_channel=capcutpc_ttweb_anchor_edit1&enter_from=capcutpc_ttweb_anchor_edit1&force_dp=1&from_page=capcutpc_ttweb_anchor_edit1&type=tools",
"iconUrl": "https://p16-common-sign.tiktokcdn.com/tiktok-obj/capcut_logo_64px_bk.png~tplv-tiktokx-origin.image?dr=14566&x-expires=1791230400&x-signature=CWfYyIFO1N%2FLSGJtr3w7Jbbpa3M%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=9b759fb9&idc=my2"
}
],
"warnings": [],
"playlistId": null,
"isAd": false,
"isPinned": false,
"isPrivate": false,
"isCommerce": false,
"aigcDescription": null,
"aigcLabelType": null,
"duetEnabled": true,
"stitchEnabled": true,
"shareEnabled": true,
"canRepost": true,
"commentStatus": 0,
"suggestedSearches": []
}
],
"mediaHeaders": {
"Cookie": "tt_chain_token=<session token returned by the API>",
"Referer": "https://www.tiktok.com/"
},
"count": 12,
"cursor": "12_20261005224548CC93FFEA156288A9DC30",
"hasMore": true,
"fetchedAt": "2026-10-05T14:45:50.785Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}{
"error": {
"code": "BAD_REQUEST",
"message": "The request was invalid.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "API key required — pass it in the `x-api-key` header.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "INSUFFICIENT_CREDITS",
"message": "This request costs 1 credit, but your balance is 0. Top up to continue.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "The requested content was not found (it may not exist, be deleted, or be private).",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Request validation failed",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"details": [
{
"path": "url",
"message": "Required"
}
]
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded — max 100 requests per 60s. Retry in ~30s.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "UPSTREAM_BLOCKED",
"message": "The source is temporarily unavailable. Please try again shortly.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}Cost: 1 credit per successful request. Errors and cache hits (
cache_max_age) are free.Copy for AI assistant
Copy for AI assistant
Paste this into ChatGPT, Claude or your coding assistant to generate working code for this endpoint (use the copy button).
Prompt
I want to make an API call to /v1/tiktok/search/keyword. Here are the details:
Endpoint: GET https://api.scraperize.com/v1/tiktok/search/keyword
Description: Returns the TikTok videos matching a keyword `query` in a `region` (default NG), about 12 per page in TikTok’s relevance order. Each video comes with its description, created date, language, stats (views, likes, comments, shares, saves, reposts — large view/like/comment/share counts are rounded; saves are exact), author (with stats, also rounded), video details (duration, size, covers, play/download URLs, every rendition, subtitles), music (with its TikTok sound page and Apple Music / Spotify links), hashtags, mentions, tagged place, effects, stickers, link anchors, AI-generated labels, flags and related searches. `servedRegion` is the region the results are for. Pass the returned `cursor` (with the same query and region) to get the next page; it is null on the last page.
Required Headers:
- x-api-key: Your API key
Parameters:
- query (string) [required]: The keyword(s) to search for (1–100 characters).
- region (select): The region (country) to get results for, as a two-letter code (ISO 3166-1). Defaults to NG (Nigeria).
- cursor (string): The `cursor` from the previous response (same query and region), to get the next page. Omit for the first page.
- cache_max_age (select): Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh.
Example Response:
{
"data": {
"query": "lagos",
"region": "NG",
"regionName": "Nigeria",
"servedRegion": "NG",
"videos": [
{
"id": "7684727102066658578",
"url": "https://www.tiktok.com/@realokadaman/video/7684727102066658578",
"type": "video",
"description": "Our question today why Lagos state tack-force are not posting our bike when they arrested like before this is our question may be there’s something going on the…",
"createdAt": "2026-09-12T19:06:07.000Z",
"language": "en",
"stats": {
"playCount": 305600,
"likeCount": 35200,
"commentCount": 776,
"shareCount": 22500,
"collectCount": 7445,
"repostCount": 0
},
"author": {
"id": "7510720009678210104",
"secUid": "MS4wLjABAAAANShGKSKT626JzyipEKLY8jYc14LpZOze4CG1X9N5SEFmYFEXHtpyEsqEDFhd3-Bh",
"handle": "realokadaman",
"nickname": "okada man",
"bio": "Bike riders ambassador in Africa WhatsApp 09068141390",
"avatarUrl": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/12908100026978c790f49747ccef657a~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=91af7ff…",
"verified": false,
"privateAccount": false,
"stats": {
"followerCount": 53200,
"followingCount": 27,
"likeCount": 336300,
"videoCount": 414,
"friendCount": 0,
"diggCount": 5006
}
},
"video": {
"duration": 91,
"width": 576,
"height": 1024,
"definition": "540p",
"format": "mp4",
"codec": "h264",
"bitrate": 555440,
"quality": "lowest",
"size": 6322793,
"coverUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/oIoZEjFMzPc9bYNlBBDAIFphRsqgoBiEgaEefD~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signatur…",
"originCoverUrl": "https://p19-common-sign.tiktokcdn.com/tos-alisg-p-0037/owoLQGcRlEyasNDyBqgFxpUeQfR8q9EBPEFhLA~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signatur…",
"dynamicCoverUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/osoEpEGDgxZB8FyFfeqRBHAhQslPqpQCa9HK0c~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signatur…",
"playUrl": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oo6EeoZrIshEcEpBYlBDfBjRF9AFQBagGwPqEP/?a=1988&bti=ODszNWYuMDE6&&bt=542&ft=-Csk_mIUPD…",
"downloadUrl": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c815-sg/oYcBpBPAmaeDcshKQQZRv9fFEYBFloEqgIjEZv/?a=1988&bti=ODszNWYuMDE6&&bt=1475&eid=20480&ft…",
"volume": {
"loudness": -12,
"peak": 0.53703
},
"formats": [
{
"gearName": "adapt_lower_720_1",
"qualityType": 14,
"codec": "h265_hvc1",
"format": null,
"bitrate": 579733,
"fps": null,
"width": 720,
"height": 1280,
"size": 6599320,
"url": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/o4felk9ABQBESZgshYDYcqELpIGF0qRDaFjEyP/?a=1988&bti=ODszNWYuMDE6&&bt=566&ft=-Csk_mIUPD…"
}
],
"subtitles": []
},
"photo": null,
"music": {
"id": "7684727154324540181",
"title": "original sound",
"url": "https://www.tiktok.com/music/original-sound-7684727154324540181",
"authorName": "okada man",
"album": null,
"duration": 91,
"preciseDuration": null,
"shootDuration": null,
"original": true,
"isCopyrighted": false,
"isCommerceMusic": false,
"isUnlimitedMusic": false,
"isPrivate": false,
"coverUrl": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/12908100026978c790f49747ccef657a~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=91af7ff…",
"playUrl": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-v-27dcd7/ooqAQml4iBhEaCFJeBXEUqJAApUqgpfCiKoDEv/?a=1988&bti=ODszNWYuMDE6&&bt=125&ft=GNDpcInz7ThqfO…",
"streaming": []
},
"hashtags": [
{
"id": "1662313548384262",
"name": "nigeriangovernment",
"description": null
}
],
"mentions": [],
"effects": [
{
"id": "2140391842",
"name": "MOVIE"
}
],
"stickerTexts": [],
"location": null,
"contentCategory": {
"id": 120,
"name": "General"
},
"anchors": [],
"warnings": [],
"playlistId": null,
"isAd": false,
"isPinned": false,
"isPrivate": false,
"isCommerce": false,
"aigcDescription": null,
"aigcLabelType": null,
"duetEnabled": true,
"stitchEnabled": true,
"shareEnabled": true,
"canRepost": true,
"commentStatus": 0,
"suggestedSearches": []
}
],
"mediaHeaders": {
"Cookie": "tt_chain_token=<session token returned by the API>",
"Referer": "https://www.tiktok.com/"
},
"count": 12,
"cursor": "12_20261005224548CC93FFEA156288A9DC30",
"hasMore": true,
"fetchedAt": "2026-10-05T14:45:50.785Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}
Please help me write code in my preferred programming language to make this API call and handle the response appropriately. Include error handling and best practices.
Authorizations
Your API key. Send it in the x-api-key header (or Authorization: Bearer <key>). Create and manage keys from your dashboard.
Query Parameters
The keyword(s) to search for (1–100 characters).
Required string length:
1 - 100The region (country) to get results for, as a two-letter code (ISO 3166-1). Defaults to NG (Nigeria).
Available options:
AL, DZ, AR, AU, AT, AZ, BY, BE, BO, BR, KH, CM, CA, CL, CO, CR, CZ, EG, FR, DE, GH, GR, HK, IS, IE, IL, IT, JM, JP, KZ, KE, KW, LI, LT, LU, MX, MA, MZ, NA, NL, NG, MK, NO, PA, PE, PH, PT, PR, RO, SA, SG, ZA, KR, ES, SE, CH, TW, TH, TT, TN, TR, UG, UA, AE, GB, US, UY, UZ, VE The cursor from the previous response (same query and region), to get the next page. Omit for the first page.
Optional. Return a cached result if one this age or newer exists — served for 0 credits with meta.cached=true and meta.cachedAt. Otherwise a fresh scrape runs (1 credit) and refreshes the cache. Omit to always scrape fresh.
Available options:
1d, 3d, 7d, 14d, 30d