Skip to content
/
Identify Influencers by E...

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

Identify influencers

Operations

Identify Influencers by Email (async)

Request

Identifies influencers based on email addresses. This can be used e.g. to identify influencers from your customer lists. This endpoint is asynchronous and will return a success message immediately. The influencers will be processed in the background and will appear in the "Your customers" tab of the influencer finder after a few minutes.

Security
ApiKeyAuth
Bodyapplication/jsonrequired
influencer_listArray of stringsrequired

List of email addresses.

Example: ["influencer1@example.com","influencer2@example.com"]
brand_idinteger

ID of the brand. If not provided, the first brand in the account will be used.

Example: 4819
source_typestring

Source type for your reference (will be shown in the IH dashboard).

Example: "sendinblue"
curl -i -X POST \
  https://api.influencer-hero.com/v1/search/identify_influencers \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE' \
  -d '{
    "influencer_list": [
      "influencer1@example.com",
      "influencer2@example.com"
    ],
    "brand_id": 4819,
    "source_type": "sendinblue"
  }'

Responses

Successfully sent contact details to the processing queue.

Bodyapplication/json
Response
application/json
{
  "message": "Successfully sent contact details to queue. Please allow for up to an hour for the system to process the data"
}

Identify Influencer by Email (real-time)

Request

Identifies a single influencer based on their email address in real-time. Unlike the async endpoint, this returns the influencer data immediately if a match is found. Please use the async endpoint for high-throughput use cases or when possible.

Security
ApiKeyAuth
Query
brand_idintegerrequired

ID of the brand.

Example: brand_id=4810
influencer_emailstringrequired

Email address of the influencer to identify.

Example: influencer_email=influencer@example.com
curl -i -X GET \
  'https://api.influencer-hero.com/v1/search/identify_influencers_real_time?brand_id=4810&influencer_email=influencer%40example.com' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'

Responses

Influencer identification result.

Bodyapplication/json
is_influencerboolean

Whether the email belongs to a known influencer.

typestring

The social media platform (if influencer is found).

Example: "instagram"
user_idstring

The platform-specific user ID (if influencer is found).

Example: "308206489"
urlstring

URL to the influencer's profile (if influencer is found).

Example: "https://www.instagram.com/therock/"
usernamestring

The influencer's handle/username (if influencer is found).

Example: "therock"
fullnamestring

The influencer's display name (if influencer is found).

Example: "Dwayne Johnson"
picturestring

URL to the influencer's profile picture (if influencer is found).

followersinteger

Number of followers (if influencer is found).

Example: 1347
is_verifiedboolean

Whether the influencer is verified on the platform (if influencer is found).

Response
application/json
{
  "is_influencer": true,
  "type": "instagram",
  "user_id": "308206489",
  "url": "https://www.instagram.com/therock/",
  "username": "therock",
  "fullname": "Dwayne Johnson",
  "picture": "https://example.com/profile.jpg",
  "followers": 1347,
  "is_verified": false
}

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