Influencer Search and Audience Analytics API - HypeAuditor

Find Instagram, YouTube, TikTok, Twitch and X (Twitter) influencers with real audience filters, then pull a full audience report for each one: audience quality score, fake follower share, audience gender, age, country and language, engagement rate and contact emails, as clean rows ready for a CRM, a spreadsheet or an outreach pipeline.

What it collects

• Influencer discovery search: creators on one network matching your filters: niche, keywords in profile, content or bio, category, creator country, language and gender, follower range, engagement rate, audience quality score (AQS) or YouTube channel quality score (CQS), average views, audience country, gender and age share, follower growth, recent posting, verified, has contact details, has run sponsored posts, similar to a given creator, Twitch games and live viewers. 20 creators per page, up to 10,000 per search.
• Influencer audience report: per username, profile URL, YouTube channel or user id. Audience quality score and mark, the split of real, suspicious, influencer and mass-follower accounts in the audience, audience gender and age, top audience countries and languages, followers, engagement rate, creator country, contact emails, plus the provider's whole report under raw. Advanced or mini report on Instagram, YouTube and TikTok; Twitch and X have one report type.
• Account suggester: accounts across networks that match a name, with followers and verified status.
• Twitch game ids: the ids the Twitch game filter takes.
• Credits left: report credits, mini and advanced reports left, and discovery requests left on your plan.
• Read only, pay per result, bring your own key.

Input

Field	What it does
What to read	Discovery search (default), influencer audience report, account suggester, Twitch game ids, or credits left.
Social network	Instagram, YouTube, TikTok, Twitch or Twitter (X), for discovery and reports.
Identifiers	Reports: usernames, profile URLs, channel ids or user ids. Suggester: names. Twitch game ids: game names.
Niche, keywords	Discovery: a niche phrase, or keywords anywhere, in content or in bio.
Category ids	Discovery: categories (Instagram, TikTok) or thematics (YouTube) to include or exclude.
Creator countries, languages, gender, account type	Discovery: who the creator is.
Followers, engagement rate, audience quality, channel quality, average views	Discovery: minimum and maximum ranges.
Audience countries, gender, age groups	Discovery: who the audience is, each with a minimum share.
Has contacts, has run sponsored posts, verified, posted within days, follower growth	Discovery: more creator filters.
Twitch game ids, live viewers	Discovery on Twitch.
Similar to, exclude usernames, sort	Discovery: lookalikes, exclusions and order.
Use the discovery sandbox	Discovery: free sample data to test a key. Not charged.
Look up reports by, report type, extra report features, include the full report, wait for new reports	Report options.
Suggester network	Suggester: one network or all.
Maximum results	Row cap for the run. It also caps the discovery pages spent.
Requests per minute	Pacing for calls to the provider, which allows 100 per minute.
API token	Your own API token, as a secret input.
Account id	Your account (client) id, issued with the token.

Filters that do not apply to the chosen network are left off with a warning in the log, because a filter a network does not support can quietly empty the result.

Example output

An influencer audience report row:

{
  "service": "report",
  "requested": "nasa",
  "found": true,
  "platform": "instagram",
  "username": "nasa",
  "userId": "528817151",
  "title": "NASA",
  "isVerified": true,
  "followers": 104344490,
  "engagementRate": 2.24,
  "audienceQualityScore": 92,
  "qualityMark": "Excellent",
  "reportState": "READY",
  "reportType": "advanced_report",
  "creatorCountry": "us",
  "emails": ["public-inquiries@hq.nasa.gov"],
  "audienceGender": { "male": 55.76, "female": 44.2 },
  "audienceAge": { "13-17": 4.1, "18-24": 18.26, "25-34": 47.5, "35-44": 17.61, "45-54": 6.91, "55-64": 3.27, "65+": 2.31 },
  "audienceCountries": [
    { "code": "us", "name": "United States (USA)", "percent": 17.56 },
    { "code": "in", "name": "India", "percent": 9.94 }
  ],
  "audienceLanguages": [{ "code": "en", "percent": 54.9 }],
  "audienceType": { "real": 79.44, "suspicious": 6.93, "influencers": 4.05, "massFollowers": 9.57 },
  "creditsLeft": 9920,
  "validUntil": "2026-11-29T10:12:33.000Z",
  "note": null
}

A discovery search row:

{
  "service": "discovery",
  "requested": "page 1",
  "found": true,
  "platform": "tiktok",
  "username": "fygh.bbk",
  "userId": "6985343550326539270",
  "title": "Yizhou",
  "followers": 1002683,
  "engagementRate": 7.8,
  "qualityMark": "poor",
  "reportState": "READY",
  "metrics": { "er": 7.8, "subscribers_count": 1002683, "likes_count": 16488514, "views_avg": 0 },
  "page": 1,
  "creditsLeft": 99958
}

Values are illustrative, taken from the provider's documented examples.

FAQ

What is this influencer search and audience analytics API used for?

Finding and vetting creators for influencer marketing. A brand team searches TikTok for fitness creators in the US with 50,000 to 500,000 followers, an audience quality score above 60 and at least 40 percent of the audience in the US, then pulls the audience report of the shortlist to check fake followers, audience age and gender before outreach. An agency audits a client's current Instagram influencers every month. A creator platform enriches sign-ups with engagement rate and audience geography.

Which data source does this actor read?

The HypeAuditor API at hypeauditor.com/api/method, through the routes of its public documentation at hypeauditor.readme.io: POST /auditor.search/ and /auditor.searchSandbox/ for discovery, GET /auditor.report/ and /auditor.reportByUserId/ for Instagram, /auditor.youtube/, /auditor.tiktok/ and /auditor.tiktokByUserId/, /auditor.twitch/ and /auditor.twitter/ for reports, /auditor.suggester, /auditor.games/ and /auditor.planInfo/. Nothing is written: lists, campaigns, media plans and recruitment are not called.

Do I need an API key?

Yes. This actor is bring-your-own-key and never ships one. HypeAuditor issues API access with two values: an API token and an account id (client id). Paste the token into the API token input and the id into the account id input, or set them once as the DATA_API_KEY and DATA_API_AUTH_ID environment secrets. They are sent in the X-Auth-Token and X-Auth-Id headers to the API host only. A missing or refused key ends the run cleanly with a message saying which it was.

What is the audience quality score?

The provider's 0 to 100 rating of how real and engaged an Instagram or TikTok audience is, with a mark such as poor, average, good or excellent. It is built from follower authenticity, engagement, growth and comment patterns. YouTube has the equivalent channel quality score (CQS). Both can be used as discovery filters and are returned in every report.

How are fake followers shown?

As audienceType: the share of the audience that is real, suspicious (bots and bought followers), influencers, and mass followers (accounts following thousands of others). It comes with Instagram and TikTok reports.

What does a report cost on the provider side?

An advanced report takes 1 report credit and a mini report 1 mini report credit on your HypeAuditor plan. A report stays unlocked for a year, so asking again for the same account in that time takes nothing. Credits are refunded when the provider cannot build a report. Each discovery page of 20 creators spends one discovery request. The credits left service shows your balance.

What happens when a report is not ready?

A report the provider has not built yet is requested, then asked for again after the wait the provider gives, for up to the wait for new reports input (180 seconds by default). If it is still building, the row has found: false and a note; run again later at no extra credit.

What happens when there is nothing for an account?

It becomes its own row with found: false and a note: private account, age restricted, too few followers, posts or views to analyse, or not found. Those rows are never charged.

How is it priced?

Pay per result: $0.005 per creator from a discovery search, suggested account or Twitch game id, and $0.02 per influencer audience report. Sandbox rows, the credit balance and rows for accounts that produced nothing are free. Your HypeAuditor subscription applies separately.

Pricing

Event	Price
Creator found (discovery, suggester, Twitch game)	$0.005 per row
Influencer audience report returned	$0.02 per report

Keyword map

influencer search API, influencer discovery API, influencer analytics API, audience quality score, fake follower checker, Instagram influencer audience demographics, TikTok influencer search, YouTube channel analytics, Twitch streamer search, creator marketing data, influencer vetting, audience authenticity, engagement rate API, HypeAuditor API, HypeAuditor discovery, HypeAuditor report.