Skip to content
/
Get Search

Influencer Hero API (1.4.2)

API documentation for the Influencer Hero platform.

Download OpenAPI description
ih_api.json
ih_api.yaml
Overview
URL
https://help.influencer-hero.com/
Influencer Hero Support
support@influencer-hero.com
Languages
Servers
https://api.influencer-hero.com/

Test endpoints

Endpoints to test authenticated and public requests

Operations

Search & Reports

Operations

Get Search

Request

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

Security
ApiKeyAuth
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' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE' \
  -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
}

Get Analytics Report

Request

Retrieves an analytics report for a specific influencer. If a report doesn't exist yet, one will be generated using your account's report credits.

Credit Usage:

  • If the influencer's report has been previously generated, no credits are used.
  • If a new report is needed, 1 report credit is deducted from your account.
Security
ApiKeyAuth
Query
user_idstringrequired

The influencer's platform-specific user ID.

Example: user_id=12345678
platformstringrequired

The social media platform of the influencer.

Enum"instagram""youtube""tiktok"
Example: platform=instagram
calculation_methodstring

The method used to calculate engagement metrics in the report.

Enum"median""average"
Example: calculation_method=median
curl -i -X GET \
  'https://api.influencer-hero.com/v1/search/get_analytics_page?user_id=12345678&platform=instagram&calculation_method=median' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'

Responses

Analytics report retrieved successfully.

Bodyapplication/json
report_creditsinteger

Remaining report credits in your account.

report_urlstring

URL path to view the report in the dashboard.

credits_usedboolean

Whether a report credit was used for this request.

successboolean

Indicates if the request was successful.

statusinteger

HTTP status code.

report_dataobject

Full analytics report data.

Response
application/json
{
  "report_credits": 49,
  "report_url": "/analytics/instagram/69380793c4711826ce751b67",
  "credits_used": true,
  "success": true,
  "status": 200,
  "report_data": {
    "success": true,
    "version": "2",
    "report_info": { … },
    "user_profile": { … },
    "audience_followers": { … },
    "audience_likers": { … },
    "audience_commenters": { … },
    "extra": { … }
  }
}

Identify influencers

Operations

Helper endpoints

Operations

Import influencers

Operations

Influencer Page

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

Managing Webhooks

Operations

Webhooks

Receive real-time notifications when events occur in your account. Webhooks are secured via HMAC-SHA256 signatures.

Webhooks