Influencer Hero API (1.4.2)

API documentation for the Influencer Hero platform.

Download OpenAPI description
Languages
Servers

https://api.influencer-hero.com/

Test endpoints

Endpoints to test authenticated and public requests

Operations

CRM

Endpoints related to CRM functionalities.

Operations

Affiliate Tracking

[Advanced] Server-side endpoints for tracking affiliate actions and performance. For most use cases, the client-side tracking script will be sufficient.

Operations

Account

Account-related functionalities for dealflow and brand searching.

Operations

Get Search

Request

Endpoint for the influencer finder. Each request provides 10 influencers, costing 1 search credits for every new influencer seen.

Bodyapplication/jsonrequired
platformstringrequired

Platform to search.

Enum"instagram""youtube""tiktok"
filterobjectrequired

Object of optional filters (see properties). Use IDs from /v1/search/locations for geo and audience_geo.

filter.​filter_idsArray of arrays

Search for individual influencers using the user id. (instagram, tiktok, youtube) Fetch user_id via /v1/search/database_influencers using type=search

filter.​textstring

Keyword in influencer bio/profile description. (instagram, tiktok, youtube)

filter.​keywordsstring

Single keyword in influencer posts. (instagram, tiktok, youtube)

filter.​relevanceobject

Lookalike-based influencer filter. (instagram, tiktok, youtube) Fetch possible handles via /v1/search/database_influencers using type=topic-tags.

filter.​audience_relevanceobject

Lookalike-based audience filter. (instagram, tiktok, youtube) Fetch possible handles via /v1/search/database_influencers using type=topic-tags.

filter.​last_postedstring

Days since last posted. (instagram, tiktok, youtube)

Enum"30""90""180"
filter.​audience_age_rangeobject

Audience age bracket + minimum share. (instagram, tiktok, youtube)

filter.​ageobject

Influencer’s age bracket. (instagram, tiktok, youtube)

filter.​audience_langobject

Audience language. (instagram, tiktok, youtube)

filter.​langobject

Profile language. (instagram, tiktok, youtube)

filter.​followersobject

Follower count range. (instagram, tiktok, youtube)

filter.​viewsobject

Average view count range. (tiktok, youtube)

filter.​engagementsobject

Total engagements range. (instagram)

filter.​engagement_rateobject

Minimum engagement rate as decimal. (instagram)

filter.​audience_geoArray of objects

Geography filters by location ID (from /v1/search/locations) + weight. (instagram, tiktok, youtube)

filter.​geoArray of objects

Geography filters by location ID (from /v1/search/locations). (instagram, tiktok, youtube)

filter.​followers_growthobject

Minimum follower growth % over X months. (instagram, tiktok, youtube)

filter.​total_views_growthobject

Minimum views growth % over X months. (tiktok, youtube)

filter.​with_contactArray of objects

Required/forbidden contact channels. (instagram, tiktok, youtube)

filter.​audience_raceobject

Ethnicity filter with minimum audience percentage. (instagram)

filter.​genderobject

Influencer gender. (instagram, tiktok, youtube)

filter.​audience_genderobject

Audience gender filter. (instagram, tiktok, youtube)

filter.​ih_magicstring

Influencer Hero magic score. (instagram, tiktok, youtube)

Enum"high""very_high"
filter.​audience_credibility_classArray of strings

Audience credibility class. (instagram, tiktok, youtube)

Items Enum"low""normal""high""best"
filter.​has_audience_databoolean

Whether audience data is available. (instagram, tiktok, youtube)

filter.​is_hiddenboolean

Whether the account is hidden. (instagram, tiktok, youtube)

filter.​is_verifiedboolean

Whether the account is verified. (instagram, tiktok, youtube)

filter.​account_typestring

Account type (1=Regular,2=Business,3=Creator). (instagram, tiktok, youtube)

Enum"1""2""3"
filter.​reels_playsobject

Reel plays range. (instagram)

search_timestampinteger

Optional Unix timestamp (seconds) for time-based filtering.

offsetinteger

Optional pagination offset.

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
  }'

Responses

Search response

Bodyapplication/json
resultsobject
search_credits_leftnumber(float)

Search Credits Left divided by 50. Multiply by 50 to get number of new influencers to be seen.

search_timestampinteger
successboolean
Response
application/json
{ "results": { "accounts": [] }, "cost": "0.01", "shown_accounts": [ "12345", "67890" ], "search_credits_left": 99.5, "search_timestamp": 1620000000, "success": true }

Database Influencers Search

Request

Retrieves influencer handles or topic-tags for use in relevance, audience_relevance, and search filters.

Query
qstringrequired

Search term.

typestringrequired

Filter type. Use topic-tags for lookalike influencers, and search for any influencer.

Enum"topic-tags""search"
platformstringrequired

Platform to search.

Enum"instagram""tiktok""youtube"
curl -i -X GET \
  'https://api.influencer-hero.com/v1/search/database_influencers?platform=instagram&q=string&type=topic-tags'

Responses

List of matching influencer handles or tags.

Bodyapplication/json
itemsArray of strings
Response
application/json
{ "items": [ "therock", "eminem", "techreview" ] }

Location Search

Request

Retrieves location IDs and names for use in geo and audience_geo filters.

Query
qstringrequired

Search term for location lookup.

curl -i -X GET \
  'https://api.influencer-hero.com/v1/search/locations?q=string'

Responses

List of matching locations.

Bodyapplication/json
Response
application/json
{ "items": [ {}, {}, {}, {} ], "inputPhrase": "United" }

webhooks

Webhooks