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 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, 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"
}
]
}
}