curl -H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"input":[{"search_url":"https://www.tiktok.com/search/user?q=cooking","country":"us"}],"limit_per_input":null}' \
"https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1villgoiiidt09ci¬ify=false&include_errors=true&type=discover_new&discover_by=search_url"
import requests
response = requests.post(
"https://api.brightdata.com/datasets/v3/scrape",
params={
"dataset_id": "gd_l1villgoiiidt09ci",
"notify": "false",
"include_errors": "true",
"type": "discover_new",
"discover_by": "search_url",
},
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={
"input": [
{
"search_url": "https://www.tiktok.com/search/user?q=cooking",
"country": "us",
},
],
"limit_per_input": None,
},
)
print(response.text)
const params = new URLSearchParams({
dataset_id: "gd_l1villgoiiidt09ci",
notify: "false",
include_errors: "true",
type: "discover_new",
discover_by: "search_url",
});
const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
input: [
{
search_url: "https://www.tiktok.com/search/user?q=cooking",
country: "us",
},
],
limit_per_input: null,
}),
});
console.log(await response.text());
[
{
"account_id": "987654321",
"nickname": "Cooking Daily",
"biography": "Easy recipes for busy people",
"bio_link": "https://example.com/recipes",
"is_verified": false,
"followers": 2500000,
"following": 150,
"likes": 45000000,
"videos_count": 320,
"create_time": "2020-03-15T00:00:00.000Z",
"url": "https://www.tiktok.com/@cookingdaily",
"profile_pic_url": "https://p16-sign-sg.tiktokcdn.com/example-avatar~100x100.jpeg",
"profile_pic_url_hd": "https://p16-sign-sg.tiktokcdn.com/example-avatar~720x720.jpeg",
"awg_engagement_rate": 0.0521,
"is_private": false,
"region": "US"
}
]
TikTok
Discover TikTok profiles by search URL
Discover TikTok profiles from a search results URL with the Bright Data Scraper API. Send POST /datasets/v3/scrape with dataset_id gd_l1villgoiiidt09ci.
POST
/
datasets
/
v3
/
scrape
curl -H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"input":[{"search_url":"https://www.tiktok.com/search/user?q=cooking","country":"us"}],"limit_per_input":null}' \
"https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1villgoiiidt09ci¬ify=false&include_errors=true&type=discover_new&discover_by=search_url"
import requests
response = requests.post(
"https://api.brightdata.com/datasets/v3/scrape",
params={
"dataset_id": "gd_l1villgoiiidt09ci",
"notify": "false",
"include_errors": "true",
"type": "discover_new",
"discover_by": "search_url",
},
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={
"input": [
{
"search_url": "https://www.tiktok.com/search/user?q=cooking",
"country": "us",
},
],
"limit_per_input": None,
},
)
print(response.text)
const params = new URLSearchParams({
dataset_id: "gd_l1villgoiiidt09ci",
notify: "false",
include_errors: "true",
type: "discover_new",
discover_by: "search_url",
});
const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
input: [
{
search_url: "https://www.tiktok.com/search/user?q=cooking",
country: "us",
},
],
limit_per_input: null,
}),
});
console.log(await response.text());
[
{
"account_id": "987654321",
"nickname": "Cooking Daily",
"biography": "Easy recipes for busy people",
"bio_link": "https://example.com/recipes",
"is_verified": false,
"followers": 2500000,
"following": 150,
"likes": 45000000,
"videos_count": 320,
"create_time": "2020-03-15T00:00:00.000Z",
"url": "https://www.tiktok.com/@cookingdaily",
"profile_pic_url": "https://p16-sign-sg.tiktokcdn.com/example-avatar~100x100.jpeg",
"profile_pic_url_hd": "https://p16-sign-sg.tiktokcdn.com/example-avatar~720x720.jpeg",
"awg_engagement_rate": 0.0521,
"is_private": false,
"region": "US"
}
]
Query Parameters
string
default:"gd_l1villgoiiidt09ci"
required
The dataset ID used for this request.
Must be set to
gd_l1villgoiiidt09ci to collect Discover by Search URL data.string
default:"discover_new"
Must be set to
discover_new.string
default:"search_url"
Must be set to
search_url.boolean
default:false
Whether to send notifications when the request is completed.
boolean
default:true
Whether to include errors in the response.
Request Body
object[]
required
curl -H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"input":[{"search_url":"https://www.tiktok.com/search/user?q=cooking","country":"us"}],"limit_per_input":null}' \
"https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1villgoiiidt09ci¬ify=false&include_errors=true&type=discover_new&discover_by=search_url"
import requests
response = requests.post(
"https://api.brightdata.com/datasets/v3/scrape",
params={
"dataset_id": "gd_l1villgoiiidt09ci",
"notify": "false",
"include_errors": "true",
"type": "discover_new",
"discover_by": "search_url",
},
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={
"input": [
{
"search_url": "https://www.tiktok.com/search/user?q=cooking",
"country": "us",
},
],
"limit_per_input": None,
},
)
print(response.text)
const params = new URLSearchParams({
dataset_id: "gd_l1villgoiiidt09ci",
notify: "false",
include_errors: "true",
type: "discover_new",
discover_by: "search_url",
});
const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
input: [
{
search_url: "https://www.tiktok.com/search/user?q=cooking",
country: "us",
},
],
limit_per_input: null,
}),
});
console.log(await response.text());
[
{
"account_id": "987654321",
"nickname": "Cooking Daily",
"biography": "Easy recipes for busy people",
"bio_link": "https://example.com/recipes",
"is_verified": false,
"followers": 2500000,
"following": 150,
"likes": 45000000,
"videos_count": 320,
"create_time": "2020-03-15T00:00:00.000Z",
"url": "https://www.tiktok.com/@cookingdaily",
"profile_pic_url": "https://p16-sign-sg.tiktokcdn.com/example-avatar~100x100.jpeg",
"profile_pic_url_hd": "https://p16-sign-sg.tiktokcdn.com/example-avatar~720x720.jpeg",
"awg_engagement_rate": 0.0521,
"is_private": false,
"region": "US"
}
]
Was this page helpful?