HypeAuditor For Suggester
Changelog
Important:
- Social Network Snapchat has added to Endpoint since 12/03/2024.
Endpoint
Get suggested social networks accounts by keyword:
GET https://hypeauditor.com/api/method/auditor.suggester?search={search_string}&st={social_type}&exclSt={social_types}
search (REQUIRED) is search keyword for example nasa st (OPTIONAL) is social network title for search only in this network for example instagram exclSt (OPTIONAL) is comma separated list of social networks excluded from search for example (&exclSt=instagram,twitter)
List of network titles:
| Social Network | Title |
|---|---|
| YouTube | youtube |
| TikTok | tiktok |
| Twitch | twitch |
| Snapchat | snapchat |
Returns the list of suggested social network accounts.
Account Object
| Attributes | Type | |
|---|---|---|
| title | string | Title of account |
| avatar_url | string | Avatar url |
| subscribers_count | integer | Count of account subscribers |
| is_private | bool | Is account private |
| is_verified | bool | Is account verified |
| social_networks | array | array of {social_id: string, avatar_url: string, subscribers_count: int, type: string, title: string, er: float, username: string} objects. social_id is the identifier in this network, avatar_url is link to avatar, subscribers_count is the count of account subscribers, Type is integer code of social network, title is the name in social network, er is account engagement rate, username is the account username. |
Requests
Set YOUR_ID and YOUR_TOKEN from HypeAuditor.
curl -X GET \
https://hypeauditor.com/api/method/auditor.suggester?search=nasa \
-H 'content-type: application/x-www-form-urlencoded' \
-H 'x-auth-id: %YOUR_ID%' \
-H 'x-auth-token: %YOUR_TOKEN%' \
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://hypeauditor.com/api/method/auditor.suggester?search=nasa',
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_HTTPHEADER => [
'x-auth-id: YOUR_ID',
'x-auth-token: YOUR_TOKEN'
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo 'cURL Error #:' . $err;
} else {
echo $response;
}
Sample request
GET https://hypeauditor.com/api/method/auditor.suggester?search=nasa
Sample response
{
"result": {
"list": [
{
"title": "NASA",
"avatar_url": "https://cdn.hypeauditor.com/img/instagram/user/528817151.jpg?w=150&till=1688832101&sign=a4a685309906b4d00cf060115e007f45",
"subscribers_count": 92829060,
"is_private": false,
"is_verified": true,
"social_networks": [
{
"social_id": "528817151",
"avatar_url": "https://cdn.hypeauditor.com/img/instagram/user/528817151.jpg?w=150&till=1685775600&sign=c76cc65d75979217967f236efb1e1c13",
"subscribers_count": 92829060,
"state": "READY",
"type": "instagram",
"title": "NASA",
"er": 1.059817,
"username": "nasa"
},
{
"social_id": "UCLA_DiR1FfKNvjuUpBHmylQ",
"avatar_url": "https://yt3.googleusercontent.com/ytc/AGIKgqPx1k80jRiCjB6iIa4U9hFGXbbShN-FwpswRd1VykE=s900-c-k-c0x00ffffff-no-rj",
"subscribers_count": 11148773,
"state": "READY",
"type": "youtube",
"title": "NASA",
"er": 4.32,
"username": "NASA"
},
{
"social_id": "151920918",
"avatar_url": "https://static-cdn.jtvnw.net/jtv_user_pictures/nasa-profile_image-739106d9e1948b76-300x300.png",
"subscribers_count": 1215979,
"state": "READY_LOW_CONFIDENCE",
"type": "twitch",
"title": "NASA",
"er": 0,
"username": "nasa"
},
{
"social_id": "UC_aP7p621ATY_yAa8jMqUVA",
"avatar_url": "https://yt3.googleusercontent.com/ytc/AGIKgqM3XIV7958dnUx4CZulcV0teZGz4xY86HYxOC3J9g=s900-c-k-c0x00ffffff-no-rj",
"subscribers_count": 908138,
"state": "READY_LOW_CONFIDENCE",
"type": "youtube",
"title": "NASA Video",
"er": 3.85,
"username": "NASAgovVideo"
}
],
"username": "nasa",
"user_id": "528817151",
"type": "instagram"
},
{
"title": "NASA",
"avatar_url": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_400x400.jpg",
"subscribers_count": 73918398,
"is_private": false,
"is_verified": false,
"social_networks": [
{
"social_id": "528817151",
"avatar_url": "https://cdn.hypeauditor.com/img/instagram/user/528817151.jpg?w=150&till=1686157200&sign=d1040da10574ca852a0ff9994069d7a3",
"subscribers_count": 92829060,
"state": "READY",
"type": "instagram",
"title": "NASA",
"er": 1.059817,
"username": "nasa"
},
{
"social_id": "11348282",
"avatar_url": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_400x400.jpg",
"subscribers_count": 73918398,
"state": "READY",
"type": "twitter",
"title": "NASA",
"er": 0.0040025,
"username": "nasa"
},
{
"social_id": "UCLA_DiR1FfKNvjuUpBHmylQ",
"avatar_url": "https://yt3.googleusercontent.com/ytc/AGIKgqPx1k80jRiCjB6iIa4U9hFGXbbShN-FwpswRd1VykE=s900-c-k-c0x00ffffff-no-rj",
"subscribers_count": 11148773,
"state": "READY",
"type": "youtube",
"title": "NASA",
"er": 4.32,
"username": "NASA"
},
{
"social_id": "1104426670",
"avatar_url": "https://cdn.hypeauditor.com/img/instagram/user/1104426670.jpg?w=150&till=1686157200&sign=e98b69f17c876bfa78f839430678ee79",
"subscribers_count": 2811216,
"state": "READY_LOW_CONFIDENCE",
"type": "instagram",
"title": "NASA Artemis",
"er": 0.826208,
"username": "nasaartemis"
},
{
"social_id": "UC_aP7p621ATY_yAa8jMqUVA",
"avatar_url": "https://yt3.googleusercontent.com/ytc/AGIKgqM3XIV7958dnUx4CZulcV0teZGz4xY86HYxOC3J9g=s900-c-k-c0x00ffffff-no-rj",
"subscribers_count": 908138,
"state": "READY_LOW_CONFIDENCE",
"type": "youtube",
"title": "NASA Video",
"er": 3.85,
"username": "NASAgovVideo"
}
],
"username": "nasa",
"user_id": "11348282",
"type": "twitter"
},
{
"title": "NASA",
"avatar_url": "https://static-cdn.jtvnw.net/jtv_user_pictures/nasa-profile_image-739106d9e1948b76-300x300.png",
"subscribers_count": 1215825,
"is_private": false,
"is_verified": false,
"social_networks": [
{
"social_id": "151920918",
"avatar_url": "https://static-cdn.jtvnw.net/jtv_user_pictures/nasa-profile_image-739106d9e1948b76-300x300.png",
"subscribers_count": 1215825,
"state": "READY_LOW_CONFIDENCE",
"type": "twitch",
"title": "NASA",
"er": 0,
"username": "nasa"
}
],
"username": "nasa",
"user_id": "151920918",
"type": "twitch"
},
{
"title": "NASA",
"avatar_url": "https://yt3.googleusercontent.com/ytc/AGIKgqPx1k80jRiCjB6iIa4U9hFGXbbShN-FwpswRd1VykE=s900-c-k-c0x00ffffff-no-rj",
"subscribers_count": 11148773,
"is_private": false,
"is_verified": true,
"social_networks": [
{
"social_id": "528817151",
"avatar_url": "https://cdn.hypeauditor.com/img/instagram/user/528817151.jpg?w=150&till=1684508400&sign=87ab193876374e4798f3b29101be9f4e",
"subscribers_count": 92544593,
"state": "READY",
"type": "instagram",
"title": "NASA",
"er": 0.922557,
"username": "nasa"
},
{
"social_id": "UCLA_DiR1FfKNvjuUpBHmylQ",
"avatar_url": "https://yt3.googleusercontent.com/ytc/AGIKgqPx1k80jRiCjB6iIa4U9hFGXbbShN-FwpswRd1VykE=s900-c-k-c0x00ffffff-no-rj",
"subscribers_count": 11148773,
"state": "READY",
"type": "youtube",
"title": "NASA",
"er": 4.32,
"username": "NASA"
},
{
"social_id": "151920918",
"avatar_url": "https://static-cdn.jtvnw.net/jtv_user_pictures/nasa-profile_image-739106d9e1948b76-300x300.png",
"subscribers_count": 1215991,
"state": "READY_LOW_CONFIDENCE",
"type": "twitch",
"title": "NASA",
"er": 0,
"username": "nasa"
},
{
"social_id": "UC_aP7p621ATY_yAa8jMqUVA",
"avatar_url": "https://yt3.googleusercontent.com/ytc/AGIKgqM3XIV7958dnUx4CZulcV0teZGz4xY86HYxOC3J9g=s900-c-k-c0x00ffffff-no-rj",
"subscribers_count": 908138,
"state": "READY_LOW_CONFIDENCE",
"type": "youtube",
"title": "NASA Video",
"er": 3.85,
"username": "NASAgovVideo"
}
],
"username": "NASA",
"channel_id": "UCLA_DiR1FfKNvjuUpBHmylQ",
"type": "youtube"
},
{
"title": "NASA Artemis",
"avatar_url": "https://cdn.hypeauditor.com/img/instagram/user/1104426670.jpg?w=150&till=1688832101&sign=6f0a307c534c0aed6c18773caa122824",
"subscribers_count": 2811216,
"is_private": false,
"is_verified": true,
"social_networks": [
{
"social_id": "1104426670",
"avatar_url": "https://cdn.hypeauditor.com/img/instagram/user/1104426670.jpg?w=150&till=1685646000&sign=7b86aeecd8ee653384ee47828697c85b",
"subscribers_count": 2811216,
"state": "READY_LOW_CONFIDENCE",
"type": "instagram",
"title": "NASA Artemis",
"er": 0.826208,
"username": "nasaartemis"
}
],
"username": "nasaartemis",
"user_id": "1104426670",
"type": "instagram"
},
{
"title": "NASA Mars",
"avatar_url": "https://pbs.twimg.com/profile_images/1273027228410867713/iTO6CkbM_400x400.jpg",
"subscribers_count": 1363479,
"is_private": false,
"is_verified": true,
"social_networks": [
{
"social_id": "15165502",
"avatar_url": "https://pbs.twimg.com/profile_images/1273027228410867713/iTO6CkbM_400x400.jpg",
"subscribers_count": 1363479,
"state": "READY",
"type": "twitter",
"title": "NASA Mars",
"er": 0.0199125,
"username": "nasamars"
}
],
"username": "nasamars",
"user_id": "15165502",
"type": "twitter"
},
{
"title": "NASA Earth",
"avatar_url": "https://pbs.twimg.com/profile_images/1587556120821784576/bjr0s_kc_400x400.jpg",
"subscribers_count": 3649895,
"is_private": false,
"is_verified": true,
"social_networks": [
{
"social_id": "24919888",
"avatar_url": "https://pbs.twimg.com/profile_images/1587556120821784576/bjr0s_kc_400x400.jpg",
"subscribers_count": 3649895,
"state": "READY",
"type": "twitter",
"title": "NASA Earth",
"er": 0.0065485000000000005,
"username": "nasaearth"
}
],
"username": "nasaearth",
"user_id": "24919888",
"type": "twitter"
},
{
"title": "NASA's Kennedy Space Center",
"avatar_url": "https://pbs.twimg.com/profile_images/1113501416558141440/csp6nhvI_normal.png",
"subscribers_count": 2750289,
"is_private": false,
"is_verified": true,
"social_networks": [
{
"social_id": "16580226",
"avatar_url": "https://pbs.twimg.com/profile_images/1113501416558141440/csp6nhvI_normal.png",
"subscribers_count": 2750289,
"state": "READY",
"type": "twitter",
"title": "NASA's Kennedy Space Center",
"er": 0.0134715,
"username": "nasakennedy"
}
],
"username": "nasakennedy",
"user_id": "16580226",
"type": "twitter"
},
{
"title": "NASA Technology",
"avatar_url": "https://pbs.twimg.com/profile_images/1074223648/nasalogo_twitter_400x400.jpg",
"subscribers_count": 1050735,
"is_private": false,
"is_verified": true,
"social_networks": [
{
"social_id": "159588456",
"avatar_url": "https://pbs.twimg.com/profile_images/1074223648/nasalogo_twitter_400x400.jpg",
"subscribers_count": 1050735,
"state": "READY",
"type": "twitter",
"title": "NASA Technology",
"er": 0.008756,
"username": "nasa_technology"
}
],
"username": "nasa_technology",
"user_id": "159588456",
"type": "twitter"
},
{
"title": "NASA JPL",
"avatar_url": "https://pbs.twimg.com/profile_images/1033103993709322240/m7jGqR6X_400x400.jpg",
"subscribers_count": 3853415,
"is_private": false,
"is_verified": true,
"social_networks": [
{
"social_id": "19802879",
"avatar_url": "https://pbs.twimg.com/profile_images/1033103993709322240/m7jGqR6X_400x400.jpg",
"subscribers_count": 3853415,
"state": "READY",
"type": "twitter",
"title": "NASA JPL",
"er": 0.008810499999999999,
"username": "nasajpl"
}
],
"username": "nasajpl",
"user_id": "19802879",
"type": "twitter"
}
]
}
}