Search users
curl --request GET \
--url https://api.scraperize.com/v1/tiktok/search/users \
--header 'x-api-key: <api-key>'import requests
url = "https://api.scraperize.com/v1/tiktok/search/users"
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/users', 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/users",
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/users"
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/users")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.scraperize.com/v1/tiktok/search/users")
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": "paul",
"correctedQuery": null,
"users": [
{
"id": "7673203716040442900",
"secUid": "MS4wLjABAAAANF3gh472UnRU4aAOCACvxj8PU1tHHL0FxG12kre-98mqiaB9ZbZmCG0sEMTr-8OX",
"handle": "paul430830",
"nickname": "Paul",
"bio": null,
"url": "https://www.tiktok.com/@paul430830",
"avatarUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/9680d75d3265b4ad61928d456600ab5c~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my2&ps=13740610&refresh_token=4358a587&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1791295200&x-signature=81niXSrfEjwb6lt1qecTrWo3WZA%3D",
"avatar": {
"uri": "tos-alisg-avt-0068/9680d75d3265b4ad61928d456600ab5c",
"urls": [
"https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/9680d75d3265b4ad61928d456600ab5c~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my2&ps=13740610&refresh_token=4358a587&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1791295200&x-signature=81niXSrfEjwb6lt1qecTrWo3WZA%3D",
"https://p19-common-sign.tiktokcdn.com/tos-alisg-avt-0068/9680d75d3265b4ad61928d456600ab5c~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my2&ps=13740610&refresh_token=bb3aa2be&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1791295200&x-signature=nkF9ZcbBc6L8BcflfYS2k%2F%2B2phQ%3D",
"https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/9680d75d3265b4ad61928d456600ab5c~tplv-tiktokx-cropcenter:100:100.jpeg?biz_tag=tiktok_user.user_cover&dr=14579&idc=my2&ps=13740610&refresh_token=312727bd&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1791295200&x-signature=9AlcPprWlfv1bYJ%2BCiQ9N2D497I%3D"
],
"width": 720,
"height": 720
},
"verified": false,
"verificationLabel": null,
"enterpriseVerifyReason": null,
"followerCount": 2822,
"likeCount": 1432,
"liveRoomId": null,
"isLive": false
},
{
"id": "6812646607822849030",
"secUid": "MS4wLjABAAAACYtfQgGRI1X0f8j_PuUGQmZRgJt5JpZx_RPRWSbm6EnygBHUmH0Qe-a-c8rbhndp",
"handle": "paulkincaid2",
"nickname": "Paul",
"bio": "Entertaining content to make you laugh, cry, or want to punch me in the face",
"url": "https://www.tiktok.com/@paulkincaid2",
"avatarUrl": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/fcf92f26f72f5f84ab54871715e90f35~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my2&ps=13740610&refresh_token=9df66af3&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1791295200&x-signature=i57ZIVx7nErBzSwCBJAr%2FOfY7IM%3D",
"avatar": {
"uri": "tos-maliva-avt-0068/fcf92f26f72f5f84ab54871715e90f35",
"urls": [
"https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/fcf92f26f72f5f84ab54871715e90f35~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my2&ps=13740610&refresh_token=9df66af3&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1791295200&x-signature=i57ZIVx7nErBzSwCBJAr%2FOfY7IM%3D",
"https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/fcf92f26f72f5f84ab54871715e90f35~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my2&ps=13740610&refresh_token=fe6a7fa4&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1791295200&x-signature=yDzcygnMFGxOAS5D%2F8g4AvazTZc%3D",
"https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/fcf92f26f72f5f84ab54871715e90f35~tplv-tiktokx-cropcenter:100:100.jpeg?biz_tag=tiktok_user.user_cover&dr=14579&idc=my2&ps=13740610&refresh_token=fa047825&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1791295200&x-signature=lkMoCVbRvcgP1rIhvH6tkG5JX8I%3D"
],
"width": 720,
"height": 720
},
"verified": false,
"verificationLabel": null,
"enterpriseVerifyReason": null,
"followerCount": 227900,
"likeCount": 2119547,
"liveRoomId": null,
"isLive": false
},
{
"id": "6818673157319721989",
"secUid": "MS4wLjABAAAAYXPoFhbxg1JNqiY7oYwLP8XqamMAf2wqzyKn0WVHVlCy8ooAf1jxTU3NZEipmetP",
"handle": "gavla_",
"nickname": "Paul",
"bio": "Just for laughs",
"url": "https://www.tiktok.com/@gavla_",
"avatarUrl": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/86b71631b8724d68fc46dd9f8aac680e~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my2&ps=13740610&refresh_token=71e851ce&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1791295200&x-signature=SOgVO7JNq%2FW9s5mgCvcDiVzsfgk%3D",
"avatar": {
"uri": "tos-maliva-avt-0068/86b71631b8724d68fc46dd9f8aac680e",
"urls": [
"https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/86b71631b8724d68fc46dd9f8aac680e~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my2&ps=13740610&refresh_token=71e851ce&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1791295200&x-signature=SOgVO7JNq%2FW9s5mgCvcDiVzsfgk%3D",
"https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/86b71631b8724d68fc46dd9f8aac680e~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my2&ps=13740610&refresh_token=5e45049f&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1791295200&x-signature=R7F2ECyyvjJT5fx%2Boe%2BuE4G9Foc%3D",
"https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/86b71631b8724d68fc46dd9f8aac680e~tplv-tiktokx-cropcenter:100:100.jpeg?biz_tag=tiktok_user.user_cover&dr=14579&idc=my2&ps=13740610&refresh_token=8773b27b&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1791295200&x-signature=xNPiynUo27IL4s%2BmRqaB07IeetM%3D"
],
"width": 720,
"height": 720
},
"verified": false,
"verificationLabel": null,
"enterpriseVerifyReason": null,
"followerCount": 200200,
"likeCount": 3096593,
"liveRoomId": null,
"isLive": false
}
],
"count": 10,
"cursor": "10_20261005224524E46DA90E886C6A7D7452",
"hasMore": true,
"fetchedAt": "2026-10-05T14:45:25.529Z"
},
"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": "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
Search users
Searches TikTok accounts matching a query, 10 per page in TikTok’s own ranking (it matches loosely — usernames, nicknames and bios — so a query rarely returns nothing). Each account comes with its user id and secUid, username, nickname, bio, profile link, avatar, verification badge and label, follower count, total likes, and its LIVE room id when it is live. Pass the returned cursor (with the same query) to get the next page; it is null on the last page. Results can shift slightly between identical searches. Search results round large follower counts and don’t always carry the verification badge — for exact stats, an authoritative verified flag and the full profile use /v1/tiktok/profile.
GET
/
v1
/
tiktok
/
search
/
users
Search users
curl --request GET \
--url https://api.scraperize.com/v1/tiktok/search/users \
--header 'x-api-key: <api-key>'import requests
url = "https://api.scraperize.com/v1/tiktok/search/users"
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/users', 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/users",
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/users"
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/users")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.scraperize.com/v1/tiktok/search/users")
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": "paul",
"correctedQuery": null,
"users": [
{
"id": "7673203716040442900",
"secUid": "MS4wLjABAAAANF3gh472UnRU4aAOCACvxj8PU1tHHL0FxG12kre-98mqiaB9ZbZmCG0sEMTr-8OX",
"handle": "paul430830",
"nickname": "Paul",
"bio": null,
"url": "https://www.tiktok.com/@paul430830",
"avatarUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/9680d75d3265b4ad61928d456600ab5c~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my2&ps=13740610&refresh_token=4358a587&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1791295200&x-signature=81niXSrfEjwb6lt1qecTrWo3WZA%3D",
"avatar": {
"uri": "tos-alisg-avt-0068/9680d75d3265b4ad61928d456600ab5c",
"urls": [
"https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/9680d75d3265b4ad61928d456600ab5c~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my2&ps=13740610&refresh_token=4358a587&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1791295200&x-signature=81niXSrfEjwb6lt1qecTrWo3WZA%3D",
"https://p19-common-sign.tiktokcdn.com/tos-alisg-avt-0068/9680d75d3265b4ad61928d456600ab5c~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my2&ps=13740610&refresh_token=bb3aa2be&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1791295200&x-signature=nkF9ZcbBc6L8BcflfYS2k%2F%2B2phQ%3D",
"https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/9680d75d3265b4ad61928d456600ab5c~tplv-tiktokx-cropcenter:100:100.jpeg?biz_tag=tiktok_user.user_cover&dr=14579&idc=my2&ps=13740610&refresh_token=312727bd&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1791295200&x-signature=9AlcPprWlfv1bYJ%2BCiQ9N2D497I%3D"
],
"width": 720,
"height": 720
},
"verified": false,
"verificationLabel": null,
"enterpriseVerifyReason": null,
"followerCount": 2822,
"likeCount": 1432,
"liveRoomId": null,
"isLive": false
},
{
"id": "6812646607822849030",
"secUid": "MS4wLjABAAAACYtfQgGRI1X0f8j_PuUGQmZRgJt5JpZx_RPRWSbm6EnygBHUmH0Qe-a-c8rbhndp",
"handle": "paulkincaid2",
"nickname": "Paul",
"bio": "Entertaining content to make you laugh, cry, or want to punch me in the face",
"url": "https://www.tiktok.com/@paulkincaid2",
"avatarUrl": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/fcf92f26f72f5f84ab54871715e90f35~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my2&ps=13740610&refresh_token=9df66af3&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1791295200&x-signature=i57ZIVx7nErBzSwCBJAr%2FOfY7IM%3D",
"avatar": {
"uri": "tos-maliva-avt-0068/fcf92f26f72f5f84ab54871715e90f35",
"urls": [
"https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/fcf92f26f72f5f84ab54871715e90f35~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my2&ps=13740610&refresh_token=9df66af3&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1791295200&x-signature=i57ZIVx7nErBzSwCBJAr%2FOfY7IM%3D",
"https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/fcf92f26f72f5f84ab54871715e90f35~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my2&ps=13740610&refresh_token=fe6a7fa4&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1791295200&x-signature=yDzcygnMFGxOAS5D%2F8g4AvazTZc%3D",
"https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/fcf92f26f72f5f84ab54871715e90f35~tplv-tiktokx-cropcenter:100:100.jpeg?biz_tag=tiktok_user.user_cover&dr=14579&idc=my2&ps=13740610&refresh_token=fa047825&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1791295200&x-signature=lkMoCVbRvcgP1rIhvH6tkG5JX8I%3D"
],
"width": 720,
"height": 720
},
"verified": false,
"verificationLabel": null,
"enterpriseVerifyReason": null,
"followerCount": 227900,
"likeCount": 2119547,
"liveRoomId": null,
"isLive": false
},
{
"id": "6818673157319721989",
"secUid": "MS4wLjABAAAAYXPoFhbxg1JNqiY7oYwLP8XqamMAf2wqzyKn0WVHVlCy8ooAf1jxTU3NZEipmetP",
"handle": "gavla_",
"nickname": "Paul",
"bio": "Just for laughs",
"url": "https://www.tiktok.com/@gavla_",
"avatarUrl": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/86b71631b8724d68fc46dd9f8aac680e~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my2&ps=13740610&refresh_token=71e851ce&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1791295200&x-signature=SOgVO7JNq%2FW9s5mgCvcDiVzsfgk%3D",
"avatar": {
"uri": "tos-maliva-avt-0068/86b71631b8724d68fc46dd9f8aac680e",
"urls": [
"https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/86b71631b8724d68fc46dd9f8aac680e~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my2&ps=13740610&refresh_token=71e851ce&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1791295200&x-signature=SOgVO7JNq%2FW9s5mgCvcDiVzsfgk%3D",
"https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/86b71631b8724d68fc46dd9f8aac680e~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my2&ps=13740610&refresh_token=5e45049f&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1791295200&x-signature=R7F2ECyyvjJT5fx%2Boe%2BuE4G9Foc%3D",
"https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/86b71631b8724d68fc46dd9f8aac680e~tplv-tiktokx-cropcenter:100:100.jpeg?biz_tag=tiktok_user.user_cover&dr=14579&idc=my2&ps=13740610&refresh_token=8773b27b&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1791295200&x-signature=xNPiynUo27IL4s%2BmRqaB07IeetM%3D"
],
"width": 720,
"height": 720
},
"verified": false,
"verificationLabel": null,
"enterpriseVerifyReason": null,
"followerCount": 200200,
"likeCount": 3096593,
"liveRoomId": null,
"isLive": false
}
],
"count": 10,
"cursor": "10_20261005224524E46DA90E886C6A7D7452",
"hasMore": true,
"fetchedAt": "2026-10-05T14:45:25.529Z"
},
"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": "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/users. Here are the details:
Endpoint: GET https://api.scraperize.com/v1/tiktok/search/users
Description: Searches TikTok accounts matching a `query`, 10 per page in TikTok’s own ranking (it matches loosely — usernames, nicknames and bios — so a query rarely returns nothing). Each account comes with its user id and secUid, username, nickname, bio, profile link, avatar, verification badge and label, follower count, total likes, and its LIVE room id when it is live. Pass the returned `cursor` (with the same query) to get the next page; it is null on the last page. Results can shift slightly between identical searches. Search results round large follower counts and don’t always carry the verification badge — for exact stats, an authoritative `verified` flag and the full profile use `/v1/tiktok/profile`.
Required Headers:
- x-api-key: Your API key
Parameters:
- query (string) [required]: The search text, e.g. a name or username (1–100 characters).
- cursor (string): The `cursor` from the previous response (same query), 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": "paul",
"correctedQuery": null,
"users": [
{
"id": "7673203716040442900",
"secUid": "MS4wLjABAAAANF3gh472UnRU4aAOCACvxj8PU1tHHL0FxG12kre-98mqiaB9ZbZmCG0sEMTr-8OX",
"handle": "paul430830",
"nickname": "Paul",
"bio": null,
"url": "https://www.tiktok.com/@paul430830",
"avatarUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/9680d75d3265b4ad61928d456600ab5c~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr…",
"avatar": {
"uri": "tos-alisg-avt-0068/9680d75d3265b4ad61928d456600ab5c",
"urls": [
"https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/9680d75d3265b4ad61928d456600ab5c~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr…"
],
"width": 720,
"height": 720
},
"verified": false,
"verificationLabel": null,
"enterpriseVerifyReason": null,
"followerCount": 2822,
"likeCount": 1432,
"liveRoomId": null,
"isLive": false
}
],
"count": 10,
"cursor": "10_20261005224524E46DA90E886C6A7D7452",
"hasMore": true,
"fetchedAt": "2026-10-05T14:45:25.529Z"
},
"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 search text, e.g. a name or username (1–100 characters).
Required string length:
1 - 100The cursor from the previous response (same query), 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