API documentation for the Influencer Hero platform.
https://api.influencer-hero.com/
[Advanced] Server-side endpoints for tracking affiliate actions and performance. For most use cases, the client-side tracking script will be sufficient.
Object of optional filters (see properties). Use IDs from /v1/search/locations
for geo
and audience_geo
.
Search for individual influencers using the user id. (instagram, tiktok, youtube) Fetch user_id via /v1/search/database_influencers
using type=search
Lookalike-based influencer filter. (instagram, tiktok, youtube) Fetch possible handles via /v1/search/database_influencers
using type=topic-tags
.
Lookalike-based audience filter. (instagram, tiktok, youtube) Fetch possible handles via /v1/search/database_influencers
using type=topic-tags
.
Geography filters by location ID (from /v1/search/locations
) + weight. (instagram, tiktok, youtube)
Geography filters by location ID (from /v1/search/locations
). (instagram, tiktok, youtube)
Required/forbidden contact channels. (instagram, tiktok, youtube)
Influencer Hero magic score. (instagram, tiktok, youtube)
Audience credibility class. (instagram, tiktok, youtube)
Whether the account is hidden. (instagram, tiktok, youtube)
Account type (1=Regular,2=Business,3=Creator). (instagram, tiktok, youtube)
https://api.influencer-hero.com/v1/search/get_search
curl -i -X POST \
https://api.influencer-hero.com/v1/search/get_search \
-H 'Content-Type: application/json' \
-d '{
"platform": "instagram",
"filter": {
"filter_ids": [],
"text": "string",
"keywords": "string",
"relevance": {
"value": "string"
},
"audience_relevance": {
"value": "string"
},
"last_posted": "30",
"audience_age_range": {
"left_number": "13",
"right_number": "13",
"weight": "0.01"
},
"age": {
"left_number": "13",
"right_number": "13"
},
"audience_lang": {
"code": "en"
},
"lang": {
"code": "en"
},
"followers": {
"left_number": "5000",
"right_number": "5000"
},
"views": {
"left_number": "5000",
"right_number": "5000"
},
"engagements": {
"left_number": "0",
"right_number": "100"
},
"engagement_rate": {
"value": "0.01"
},
"audience_geo": [
{
"id": 0,
"weight": "0.01"
}
],
"geo": [
{
"id": 0
}
],
"followers_growth": {
"value": "0.00",
"interval": "i1months"
},
"total_views_growth": {
"value": "0.00",
"interval": "i1months"
},
"with_contact": [
{
"type": "email",
"action": "must"
}
],
"audience_race": {
"code": "Black",
"weight": "0.01"
},
"gender": {
"code": "MALE"
},
"audience_gender": {
"code": "MALE",
"weight": "0.01"
},
"ih_magic": "high",
"audience_credibility_class": [
"low"
],
"has_audience_data": true,
"is_hidden": true,
"is_verified": true,
"account_type": "1",
"reels_plays": {
"left_number": "5000",
"right_number": "5000"
}
},
"search_timestamp": 0,
"offset": 0
}'
{ "results": { "accounts": [ … ] }, "cost": "0.01", "shown_accounts": [ "12345", "67890" ], "search_credits_left": 99.5, "search_timestamp": 1620000000, "success": true }
https://api.influencer-hero.com/v1/search/database_influencers
curl -i -X GET \
'https://api.influencer-hero.com/v1/search/database_influencers?platform=instagram&q=string&type=topic-tags'
{ "items": [ "therock", "eminem", "techreview" ] }
https://api.influencer-hero.com/v1/search/locations
curl -i -X GET \
'https://api.influencer-hero.com/v1/search/locations?q=string'
{ "items": [ { … }, { … }, { … }, { … } ], "inputPhrase": "United" }