HypeAuditor For Suggester
Changelog
Important:
- The object
social_networksis deprecated.- Social Network Snapchat has added to Endpoint since 12/03/2024.
Endpoint
Get suggested social networks accounts by search_string:
GET https://hypeauditor.com/api/method/auditor.suggester?search={search_string}&st={social_type}&exclSt={social_types}
search (REQUIRED) is search term for example username 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, state: string} objects. |
social_networks array
This array of objects provides information about the social accounts by the searched username
| Object | Type | Description |
|---|---|---|
| type | integer | code of a social network instagram, tiktok, youtube, twitter, twitch, snapchat |
| title | string | name/title from a social network bio |
| social_id | string | report ID |
| username | string | social account username |
| avatar_url | string | a link to a social network account's avatar |
| subscribers_count | integer | count of account subscribers |
| er | integer | influencer engagement rate in percent; this integer is always 0 for Twitch and Snapchat because the er does not exist in reports |
| state | string | identifies if a report is fully READY, lacks demographic data due to the low audience activityREADY_LOW_CONFIDENCE, not ready yet NOT_READY, PRIVATE, DELETED, RESTRICTED, or has LOW_VIEWS(for TikTok, YouTube ). |
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://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvUVg2VHZkaDBHNUMzcXVidWhWaTJhP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,90_FMjpeg",
"subscribers_count": 802800,
"is_private": false,
"is_verified": true,
"social_networks": [
{
"type": "snapchat",
"title": "NASA",
"social_id": "nasa",
"username": "nasa",
"avatar_url": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvUVg2VHZkaDBHNUMzcXVidWhWaTJhP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,90_FMjpeg",
"subscribers_count": 802800,
"er": 0,
"state": "READY"
},
{
"type": "instagram",
"title": "Nether Majid",
"social_id": "22584706766",
"username": "8_n20",
"avatar_url": "https://cdn.hypeauditor.com/img/instagram/user/22584706766.jpg?w=150&till=1733803200&sign=4cfb49712c0d751aaae2f6af5fc2c725",
"subscribers_count": 4283,
"er": 0.723792,
"state": "READY"
},
{
"type": "instagram",
"title": "Himanshu Lohar",
"social_id": "48330039347",
"username": "himanshu__panchal__90",
"avatar_url": "https://cdn.hypeauditor.com/img/instagram/user/48330039347.jpg?w=150&till=1733803200&sign=3e38526d7d5b3da9d286c7ab2c2ed2c6",
"subscribers_count": 1465,
"er": 2.525597,
"state": "READY_LOW_CONFIDENCE"
}
],
"username": "nasa",
"user_id": "nasa",
"type": "snapchat"
},
{
"title": "NASA",
"avatar_url": "https://cdn.hypeauditor.com/img/instagram/user/528817151.jpg?w=150&till=1740787140&sign=2b06782dfbe96d267bfd26c08d37dbfa",
"subscribers_count": 96803924,
"is_private": false,
"is_verified": true,
"social_networks": [
{
"type": "instagram",
"title": "NASA",
"social_id": "528817151",
"username": "nasa",
"avatar_url": "https://cdn.hypeauditor.com/img/instagram/user/528817151.jpg?w=150&till=1736848800&sign=6e62ccb8a7a14957e35a1789b868a5cb",
"subscribers_count": 96803924,
"er": 0.735237,
"state": "READY"
},
{
"type": "twitter",
"title": "NASA",
"social_id": "11348282",
"username": "nasa",
"avatar_url": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_400x400.jpg",
"subscribers_count": 84756058,
"er": 0,
"state": "READY"
},
{
"type": "youtube",
"title": "NASA",
"social_id": "UCLA_DiR1FfKNvjuUpBHmylQ",
"username": "nasa",
"avatar_url": "https://yt3.googleusercontent.com/eIf5fNPcIcj9ig-wZBeq4stFy1lgjWTW1nLT5dYlFkHZprZ03QBiMcbpwNMB6XSBjrSFGtAGQg=s900-c-k-c0x00ffffff-no-rj",
"subscribers_count": 12245889,
"er": 2.65,
"state": "READY"
},
{
"type": "instagram",
"title": "NASA Artemis",
"social_id": "1104426670",
"username": "nasaartemis",
"avatar_url": "https://cdn.hypeauditor.com/img/instagram/user/1104426670.jpg?w=150&till=1736848800&sign=d8853cb103b12932ad039001de05874f",
"subscribers_count": 2839172,
"er": 0.403128,
"state": "READY"
},
{
"type": "youtube",
"title": "NASA Video",
"social_id": "UC_aP7p621ATY_yAa8jMqUVA",
"username": "nasagovvideo",
"avatar_url": "https://yt3.googleusercontent.com/ytc/AIdro_mAavC7uPluTw_kro_ji26VOxzjsQ6FFnAdtaFi6mmJu8A=s900-c-k-c0x00ffffff-no-rj",
"subscribers_count": 995062,
"er": 5.18,
"state": "READY_LOW_CONFIDENCE"
}
],
"username": "nasa",
"user_id": "528817151",
"type": "instagram"
},
{
"title": "NASA",
"avatar_url": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_400x400.jpg",
"subscribers_count": 84925988,
"is_private": false,
"is_verified": true,
"social_networks": [
{
"type": "instagram",
"title": "NASA",
"social_id": "528817151",
"username": "nasa",
"avatar_url": "https://cdn.hypeauditor.com/img/instagram/user/528817151.jpg?w=150&till=1736848800&sign=6e62ccb8a7a14957e35a1789b868a5cb",
"subscribers_count": 96857523,
"er": 0.656191,
"state": "READY"
},
{
"type": "twitter",
"title": "NASA",
"social_id": "11348282",
"username": "nasa",
"avatar_url": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_400x400.jpg",
"subscribers_count": 84925988,
"er": 0,
"state": "READY"
},
{
"type": "youtube",
"title": "NASA",
"social_id": "UCLA_DiR1FfKNvjuUpBHmylQ",
"username": "nasa",
"avatar_url": "https://yt3.googleusercontent.com/eIf5fNPcIcj9ig-wZBeq4stFy1lgjWTW1nLT5dYlFkHZprZ03QBiMcbpwNMB6XSBjrSFGtAGQg=s900-c-k-c0x00ffffff-no-rj",
"subscribers_count": 12245889,
"er": 2.65,
"state": "READY"
},
{
"type": "instagram",
"title": "NASA Artemis",
"social_id": "1104426670",
"username": "nasaartemis",
"avatar_url": "https://cdn.hypeauditor.com/img/instagram/user/1104426670.jpg?w=150&till=1736848800&sign=d8853cb103b12932ad039001de05874f",
"subscribers_count": 2839172,
"er": 0.403128,
"state": "READY"
},
{
"type": "youtube",
"title": "NASA Video",
"social_id": "UC_aP7p621ATY_yAa8jMqUVA",
"username": "nasagovvideo",
"avatar_url": "https://yt3.googleusercontent.com/ytc/AIdro_mAavC7uPluTw_kro_ji26VOxzjsQ6FFnAdtaFi6mmJu8A=s900-c-k-c0x00ffffff-no-rj",
"subscribers_count": 995062,
"er": 5.18,
"state": "READY_LOW_CONFIDENCE"
}
],
"username": "nasa",
"user_id": "11348282",
"type": "twitter"
},
{
"title": "NASA",
"avatar_url": "https://yt3.googleusercontent.com/eIf5fNPcIcj9ig-wZBeq4stFy1lgjWTW1nLT5dYlFkHZprZ03QBiMcbpwNMB6XSBjrSFGtAGQg=s900-c-k-c0x00ffffff-no-rj",
"subscribers_count": 12244637,
"is_private": false,
"is_verified": false,
"social_networks": [
{
"type": "instagram",
"title": "NASA",
"social_id": "528817151",
"username": "nasa",
"avatar_url": "https://cdn.hypeauditor.com/img/instagram/user/528817151.jpg?w=150&till=1736848800&sign=6e62ccb8a7a14957e35a1789b868a5cb",
"subscribers_count": 96857523,
"er": 0.656191,
"state": "READY"
},
{
"type": "twitter",
"title": "NASA",
"social_id": "11348282",
"username": "nasa",
"avatar_url": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_400x400.jpg",
"subscribers_count": 84756058,
"er": 0,
"state": "READY"
},
{
"type": "youtube",
"title": "NASA",
"social_id": "UCLA_DiR1FfKNvjuUpBHmylQ",
"username": "nasa",
"avatar_url": "https://yt3.googleusercontent.com/eIf5fNPcIcj9ig-wZBeq4stFy1lgjWTW1nLT5dYlFkHZprZ03QBiMcbpwNMB6XSBjrSFGtAGQg=s900-c-k-c0x00ffffff-no-rj",
"subscribers_count": 12244637,
"er": 2.72,
"state": "READY"
},
{
"type": "instagram",
"title": "NASA Artemis",
"social_id": "1104426670",
"username": "nasaartemis",
"avatar_url": "https://cdn.hypeauditor.com/img/instagram/user/1104426670.jpg?w=150&till=1736848800&sign=d8853cb103b12932ad039001de05874f",
"subscribers_count": 2839172,
"er": 0.403128,
"state": "READY"
},
{
"type": "youtube",
"title": "NASA Video",
"social_id": "UC_aP7p621ATY_yAa8jMqUVA",
"username": "nasagovvideo",
"avatar_url": "https://yt3.googleusercontent.com/ytc/AIdro_mAavC7uPluTw_kro_ji26VOxzjsQ6FFnAdtaFi6mmJu8A=s900-c-k-c0x00ffffff-no-rj",
"subscribers_count": 995062,
"er": 5.18,
"state": "READY_LOW_CONFIDENCE"
}
],
"username": "NASA",
"channel_id": "UCLA_DiR1FfKNvjuUpBHmylQ",
"type": "youtube"
},
{
"title": "NASA",
"avatar_url": "https://static-cdn.jtvnw.net/jtv_user_pictures/8dbb66f7-0b18-4ca6-b0be-7e53aa7bf50b-profile_image-300x300.png",
"subscribers_count": 1287496,
"is_private": false,
"is_verified": false,
"social_networks": [
{
"type": "youtube",
"title": "NASA",
"social_id": "UCLA_DiR1FfKNvjuUpBHmylQ",
"username": "nasa",
"avatar_url": "https://yt3.googleusercontent.com/2kw8s66dhLUegJ3XrqZSkZMfp77CRhCfYm1NurDwDB2L9sT_-CaoUix_iWjoE_t66b07JzoR=s900-c-k-c0x00ffffff-no-rj",
"subscribers_count": 12259373,
"er": 2.775,
"state": "READY"
},
{
"type": "twitch",
"title": "NASA",
"social_id": "151920918",
"username": "nasa",
"avatar_url": "https://static-cdn.jtvnw.net/jtv_user_pictures/8dbb66f7-0b18-4ca6-b0be-7e53aa7bf50b-profile_image-300x300.png",
"subscribers_count": 1287496,
"er": 0,
"state": "READY_LOW_CONFIDENCE"
},
{
"type": "youtube",
"title": "NASA Video",
"social_id": "UC_aP7p621ATY_yAa8jMqUVA",
"username": "nasagovvideo",
"avatar_url": "https://yt3.googleusercontent.com/ytc/AIdro_mAavC7uPluTw_kro_ji26VOxzjsQ6FFnAdtaFi6mmJu8A=s900-c-k-c0x00ffffff-no-rj",
"subscribers_count": 987466,
"er": 4.015,
"state": "READY_LOW_CONFIDENCE"
}
],
"username": "nasa",
"user_id": "151920918",
"type": "twitch"
},
{
"title": "user3890627351453",
"avatar_url": "https://cdn.hypeauditor.com/img/tiktok/user/7036907917069124610.jpg?w=150&till=1740787140&sign=4242dbe99adaa5de62e10eb9bb56288a",
"subscribers_count": 568,
"is_private": false,
"is_verified": false,
"social_networks": [
{
"type": "tiktok",
"title": "user3890627351453",
"social_id": "7036907917069124610",
"username": "nasa",
"avatar_url": "https://cdn.hypeauditor.com/img/tiktok/user/7036907917069124610.jpg?w=150&till=1735066800&sign=1acdb33c54f3a3c07c2bf4578639e0c7",
"subscribers_count": 566,
"er": 0,
"state": "READY_LOW_CONFIDENCE"
}
],
"username": "nasa",
"user_id": "7036907917069124610",
"type": "tiktok"
},
{
"title": "NASA Astronauts",
"avatar_url": "https://pbs.twimg.com/profile_images/1007645578266927104/vnWMv9-3_400x400.jpg",
"subscribers_count": 1614475,
"is_private": false,
"is_verified": true,
"social_networks": [
{
"type": "twitter",
"title": "NASA Astronauts",
"social_id": "43166813",
"username": "nasa_astronauts",
"avatar_url": "https://pbs.twimg.com/profile_images/1007645578266927104/vnWMv9-3_400x400.jpg",
"subscribers_count": 1614475,
"er": 1.0e-6,
"state": "READY"
}
],
"username": "nasa_astronauts",
"user_id": "43166813",
"type": "twitter"
},
{
"title": "NASA's Kennedy Space Center",
"avatar_url": "https://pbs.twimg.com/profile_images/1113501416558141440/csp6nhvI_normal.png",
"subscribers_count": 2954758,
"is_private": false,
"is_verified": true,
"social_networks": [
{
"type": "twitter",
"title": "NASA's Kennedy Space Center",
"social_id": "16580226",
"username": "nasakennedy",
"avatar_url": "https://pbs.twimg.com/profile_images/1113501416558141440/csp6nhvI_normal.png",
"subscribers_count": 2954758,
"er": 1.5e-6,
"state": "READY"
},
{
"type": "instagram",
"title": "NASA's Kennedy Space Center",
"social_id": "549403870",
"username": "nasakennedy",
"avatar_url": "https://cdn.hypeauditor.com/img/instagram/user/549403870.jpg?w=150&till=1715680800&sign=349219601b6f5de805af4eec91938302",
"subscribers_count": 769230,
"er": 0.857546,
"state": "READY"
},
{
"type": "youtube",
"title": "NASA's Kennedy Space Center",
"social_id": "UCjJtr2fFcUp6yljzJOzpHUg",
"username": "NASAKennedy",
"avatar_url": "https://yt3.googleusercontent.com/ytc/AIdro_kFVq11zKbabllzdvhms8Gjct6mmiyWfRMT4ErfhOxnbA=s900-c-k-c0x00ffffff-no-rj",
"subscribers_count": 126486,
"er": 3.32,
"state": "READY_LOW_CONFIDENCE"
}
],
"username": "nasakennedy",
"user_id": "16580226",
"type": "twitter"
},
{
"title": "NASA Exoplanets",
"avatar_url": "https://pbs.twimg.com/profile_images/1720144719462981632/e2tdHLFm_400x400.jpg",
"subscribers_count": 1454399,
"is_private": false,
"is_verified": true,
"social_networks": [
{
"type": "twitter",
"title": "NASA Exoplanets",
"social_id": "17781165",
"username": "nasaexoplanets",
"avatar_url": "https://pbs.twimg.com/profile_images/1720144719462981632/e2tdHLFm_400x400.jpg",
"subscribers_count": 1454399,
"er": 3.5e-6,
"state": "READY"
}
],
"username": "nasaexoplanets",
"user_id": "17781165",
"type": "twitter"
},
{
"title": "NASA Technology",
"avatar_url": "https://pbs.twimg.com/profile_images/1074223648/nasalogo_twitter_400x400.jpg",
"subscribers_count": 1185489,
"is_private": false,
"is_verified": true,
"social_networks": [
{
"type": "twitter",
"title": "NASA Technology",
"social_id": "159588456",
"username": "nasa_technology",
"avatar_url": "https://pbs.twimg.com/profile_images/1074223648/nasalogo_twitter_400x400.jpg",
"subscribers_count": 1185489,
"er": 1.0e-6,
"state": "READY"
}
],
"username": "nasa_technology",
"user_id": "159588456",
"type": "twitter"
}
]
}
}