HypeAuditor For Discovery - TikTok
JSON Example
Here you can find request with all available filters
{
"social_network": "tiktok",
"similar": "6557821753438371845",
"category": {
"include": [
3,
4
]
},
"search": [
"nasa"
],
"er": {
"from": 1,
"to": 20
},
"aqs": {
"from": 80,
"to": 90
},
"account_geo": {
"country": [
"gb",
"us"
],
"city": [
2643743
]
},
"account_age": {
"from": 13,
"to": 65
},
"account_languages": [
"en",
"es"
],
"blogger_prices": {
"post_price": {
"from": 10,
"to": 10000
}
},
"account_has_contacts": true,
"account_has_launched_advertising": false,
"likes_avg": {
"from": 10000
},
"alikes_avg": {
"from": 10000
},
"views_avg": {
"from": 15000
},
"comments_avg": {
"from": 1000
},
"shares_avg": {
"from": 1000
},
"likes_growth_prc": {
"from": 1
},
"audience_geo": {
"countries": [
{
"id": "gb",
"prc": 20
},
{
"id": "us",
"prc": 20
}
],
"cities": [
{
"id": 2643743,
"prc": 20
}
]
},
"audience_age": {
"groups": ["13_17","18_24"],
"prc": 50
},
"audience_gender": {
"gender": "female",
"prc": 20
},
"subscribers_count": {
"from": 120000
},
"last_media_time": {
"from": 1723631206
},
"media_count": {
"from": 1
},
"reactions_rate": {"marks": ["average", "good"]},
"comments_rate": {"marks": ["average", "good"]},
"growth": {
"period": "7d",
"from": 10,
"to": 30
},
"sort": {
"field": "subscribers_count",
"order": "desc"
},
"page": 1
}
Requests
Set YOUR_ID and YOUR_TOKEN from HypeAuditor.
$postFields = [
'social_network' => 'tiktok',
'account_has_contacts' => true,
];
$opts = [
CURLOPT_URL => 'https://hypeauditor.com/api/method/auditor.searchSandbox',
CURLOPT_TIMEOUT => 10,
CURLOPT_POSTFIELDS => $postFields,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'X-Auth-Id: CLIENT_ID_HERE',
'X-Auth-Token: API_TOKEN_HERE',
],
];
$ch = curl_init();
curl_setopt_array($ch, $opts);
$response = curl_exec($ch);
var_dump($response);
$postFields = json_encode([
'social_network' => 'tiktok',
'account_has_contacts' => true,
]);
$opts = [
CURLOPT_URL => 'https://hypeauditor.com/api/method/auditor.searchSandbox',
CURLOPT_TIMEOUT => 10,
CURLOPT_POSTFIELDS => $postFields,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'X-Auth-Id: CLIENT_ID_HERE',
'X-Auth-Token: API_TOKEN_HERE',
'Content-Type: application/json',
'Content-Length: '.strlen($postFields),
],
];
$ch = curl_init();
curl_setopt_array($ch, $opts);
$response = curl_exec($ch);
var_dump($response);
Response Object
Response can contain search_results array. Please, check Change Log for further information.
{
"result": {
"search_results": [
{
"basic": {
"username": "fygh.bbk",
"title": "Yizhou",
"avatar_url": "https://cdn.hypeauditor.com/img/tiktok/user/6985343550326539270.jpg?w=150&till=1700564400&sign=3310e98029bc445f9102226d96ae57e5"
},
"metrics": {
"er": {
"value": 7.83
},
"subscribers_count": {
"value": 1031725
},
"likes_count": {
"value": 16481231
},
"views_avg": {
"value": 0
}
},
"features": {
"social_networks": [
{
"social_id": "6985343550326539270",
"avatar_url": "https://cdn.hypeauditor.com/img/tiktok/user/6985343550326539270.jpg?w=150&till=1696827600&sign=162292401f42d48559ea7bb26d71f7b1",
"subscribers_count": 1031725,
"state": "READY",
"type": "tiktok",
"title": "Yizhou",
"er": 7.83,
"username": "fygh.bbk"
}
],
"aqs": {
"data": {
"mark": "poor"
}
},
"search_content": null
}
}
],
"current_page": 1,
"total_pages": 1,
"queries_left": 999
}
}