Influencer Search API - Instagram, TikTok, YouTube - Upfluence

Find Instagram, TikTok and YouTube influencers in the Upfluence creator index by keyword, follower range, engagement rate, country, language, location and audience demographics, then pull each creator's full profile, audience report, recent posts and brand mentions as clean rows for a spreadsheet, CRM or data warehouse.

What it collects

• Influencer search: creators matching your keywords (anywhere, or in one field such as the Instagram bio, Instagram post text, TikTok video names or YouTube descriptions), filtered by followers, minimum engagement rate, creator country, language and age, email availability, distance from a city, and audience country, gender and age share. Sorted by relevancy, influencer score, followers, engagement rate, average engagements, average likes or growth rate. Up to 200 per page, first 10,000 results.
• Search statistics: how many creators a search matches, broken down by creator country, language, platform reach, audience age, audience gender and real versus fake audience.
• Influencer profile: everything the provider holds for an influencer id: name, country, language, gender, bio, categories, email when unlocked, and every linked Instagram, TikTok, YouTube, Twitter (X), Pinterest and Twitch account with followers, engagement rate, average likes, comments, views and shares, growth rates and verified status.
• Profile lookup by URL: the same profile for a social profile link, such as https://www.instagram.com/nasa/ or https://www.tiktok.com/@nasa.
• Audience demographics: gender split, age groups, top countries, states and cities, fake follower share and legal drinking age share, each with its sample size and confidence flag.
• Recent posts: up to 100 recent Instagram posts, TikTok videos, YouTube videos or Shorts, tweets, pins or Twitch streams per account, with likes, comments, views or plays, shares, reach, impressions, mentions and hashtags.
• Brand mentions: the brands an Instagram or TikTok account mentions, with posts and engagements per brand and the account's mention totals.
• Read only, pay per result, bring your own token.

What is and is not wired

All calls go to https://api.upfluence.co, with the token from https://identity.upfluence.co/token, exactly as documented at docs.upfluence.co.

Mode	Route
Influencer search	POST /v1/matches
Search statistics	POST /v1/counts
Influencer profile	GET /v1/influencers/{id}
Profile lookup by URL	GET /v1/influencers/lookup
Audience demographics	GET /v1/audience
Recent posts	GET /v1/instagram_medias, /v1/tiktok_videos, /v1/youtube_videos, /v1/tweets, /v1/pins, /v1/twitch_streams
Brand mentions	GET /v1/media/mentions

The two POST routes are searches and change nothing. Not wired: profile ingestion, tags, merge fields and custom attributes, lists and list entries, campaigns, contributions, orders and the social listening streams. Nothing in your account is changed.

Input

Field	What it does
What to read	One of the seven modes above. Influencer search is the default.
Keywords, search keywords in, keyword match	Full text criteria and where they are matched.
Platform, minimum and maximum followers, minimum engagement rate	Reach and engagement filters on one platform.
Influencer countries, languages, age, only creators with an email	Creator filters.
Near city, radius	Location filter.
Audience platform, country, gender, age and their minimum shares	Audience filters on Instagram or TikTok followers.
Every platform filter must match	AND rather than OR between platform filters.
Sort by, sort direction	Search order.
Advanced filters	Any other documented filter as JSON, such as recent activity or list exclusion.
Statistics	The breakdowns search statistics counts.
Identifiers	Influencer ids, profile URLs or platform account ids, one per line.
Post platform, YouTube video type, posts per account	Options for recent posts and brand mentions.
Include the full record	Keep the provider's whole answer under raw.
Maximum results, requests per minute	Row cap and pacing.
Access token or client credentials	Your own access, as a secret input.

Example output

A search row:

{
  "mode": "search",
  "recordType": "influencer",
  "found": true,
  "rank": 1,
  "influencerId": 427878,
  "name": "Jane Smith",
  "country": "US",
  "language": "en",
  "gender": "female",
  "description": "Fashion and lifestyle content creator based in NYC",
  "communitySize": 158300,
  "followers": 158300,
  "hasEmail": true,
  "categories": ["Fashion", "Beauty"],
  "matchScore": 12,
  "score": 25,
  "note": null
}

A recent post row:

{
  "mode": "posts",
  "recordType": "post",
  "found": true,
  "platform": "instagram",
  "accountId": 144198,
  "postId": "3051234567890123456",
  "url": "https://www.instagram.com/p/Cx1234abcd/",
  "text": "Spring looks with @brand",
  "postType": "reel",
  "publishedAt": "2026-09-28T17:02:11.000Z",
  "likes": 18420,
  "comments": 312,
  "views": 254000,
  "reach": 190500,
  "impressions": 263100,
  "mentionedProfiles": ["brand"]
}

Values are illustrative.

FAQ

What is this influencer search API used for?

Building influencer shortlists and creator databases outside the Upfluence web app. A brand team searches for US fitness creators on Instagram with 50,000 to 500,000 followers, over 3% engagement and a mostly female audience, and loads them into a spreadsheet. An agency checks the audience countries and fake follower share of a list of TikTok creators before a campaign. A marketplace enriches creator profile links with followers, engagement and recent posts.

Which data source does this actor read?

The Upfluence API, through the routes in its public documentation at docs.upfluence.co: influencer search and statistics, influencer profiles and profile lookup, audience data, media and brand mentions. Upfluence indexes more than 14 million creators across Instagram, TikTok, YouTube, Twitter (X), Pinterest, Twitch and blogs.

Do I need an Upfluence account and API access?

Yes. This actor is bring-your-own-key and never ships one. Upfluence issues API client credentials to its customers. Paste either a ready access token, or your client id and secret as client_id:client_secret, in which case the actor asks the identity service for a one hour token at the start of the run. Or set the same value once as the DATA_API_KEY environment secret. A missing, expired or refused credential ends the run cleanly with a message saying which it was.

Does it use my Upfluence credits?

Yes. Upfluence meters searches and profile views against a monthly credit allowance, which resets at the start of each month; tokens.upfluence.com estimates what a query costs. The actor reads only as many search pages as the maximum results needs, logs the allowance headers the provider returns, and ends the run cleanly when the allowance is used up.

Which filters can the search use?

Every filter in the provider's search documentation. The input offers the common ones directly: keywords in any indexed field, followers, engagement rate, creator country, language and age, email availability, distance from a city, and audience country, gender and age share on Instagram or TikTok. Any other documented filter, such as recent posting activity, growth rates, brand safety or excluding creators already in one of your lists, goes in the advanced filters input as JSON.

What audience demographics are returned?

Per influencer: the female and male share, the age group distribution, the top countries, states and cities with their share, the fake versus real follower share and, on Instagram, the share above legal drinking age. Each comes with its sample size and whether the provider considers it statistically confident.

Can I get a creator's posts from a profile link?

Yes, in two steps. Run the profile lookup with the link; the row carries instagramId, tiktokId, youtubeId and the other platform account ids. Then run recent posts or brand mentions with those ids.

Are there limits?

A search serves its first 10,000 results, at most 200 per page. The identity service rate limits token requests, so the actor asks for one token per run and retries politely. Upfluence's terms restrict API data to your own internal use.

What happens when there is nothing for an identifier?

It becomes its own row with found: false and a note: an influencer id the provider does not have, a profile link it cannot match, or an influencer with no audience data. Those rows are never charged.

How is it priced?

Pay per result: $0.008 per influencer from a search, $0.015 per full profile or audience report, and $0.005 per post, brand mention or statistic bucket. Rows for identifiers that produced nothing are free. Your Upfluence subscription and credits apply separately.

Keywords

influencer search API, influencer discovery, Instagram influencer search, TikTok creator search, YouTube creator database, influencer audience demographics, fake follower check, influencer engagement rate, creator profile lookup, brand mentions, Upfluence API export