Influencer Search and Creator Data API - Phyllo

Search public Instagram, YouTube, TikTok, Twitch and X creators with audience filters, pull a full public profile analytics report for any creator, and read the accounts, posts and audience demographics of creators who connected their accounts to your own app, as clean rows ready for a CRM, a spreadsheet or a creator marketing pipeline.

What it collects

• Creator discovery search: public creators on one platform matching your filters: follower or subscriber range, engagement rate, average likes and views, creator gender and language, creator location, audience gender, age band, languages and locations with a minimum share, audience credibility score, bio keywords and bio phrase, hashtags and mentions used, lookalike creators or lookalike audiences, verified, has contact details, must have an email, sponsored posts (Instagram), account type and last post date. Up to 500 creators per search, sorted by followers, engagement rate, likes, views, content count, follower growth, reels views or bio keyword relevance.
• Public profile analytics: per profile URL, username or handle. Followers, engagement rate, average likes, comments, views and reels views, creator location, gender, age group and language, public contacts and emails, top hashtags, interests and brand affinities, top content, lookalike profiles, and the audience: credibility score, gender and age split, top countries, cities, languages and interests, and real, suspicious, influencer and mass follower shares. The provider's whole report is kept under raw.
• Connected accounts: every account creators linked to your app, with platform, username, connection status and the data products enabled.
• Connected account profiles: name, bio, URL, followers, following, subscribers, content count, verified and business flags, emails and phone numbers the platform shares with your app.
• Connected account content: each post, video, reel or story with likes, comments, views, shares, saves, organic and paid reach and impressions, hashtags and mentions, over an optional date window.
• Connected account audience: audience countries, cities and gender by age split for each connected account.
• Read only, pay per result, bring your own keys.

Input

Field	What it does
What to read	Discovery search (default), public profile analytics, connected accounts, profiles, content or audience.
Platform	Instagram, YouTube, TikTok, Twitch or X, for discovery and profile analytics.
Identifiers	Profile analytics: profile URLs or handles. Connected profiles, content, audience: connected account ids.
Followers, engagement rate, average likes, average views	Discovery: minimum and maximum ranges.
Creator gender, language, location ids	Discovery: who the creator is.
Audience gender, age band, languages, location ids, credibility	Discovery: who the audience is, each with a minimum share.
Bio keywords, bio phrase, hashtags, mentions	Discovery: what the creator says.
Creators like, audience like	Discovery: lookalike search from a handle.
Verified, has contact details, must have an email, has sponsored posts, account type, posted within days	Discovery: more creator filters.
Sort by	Discovery: the order of results, highest first.
Include the full report	Profile analytics: keep the whole report under raw.
Connected account platform, user id	Connected accounts and profiles: narrow to one platform or one user.
Content from date, content to date	Connected content: the publishing window.
Environment	Production, staging or sandbox (mock data, never charged).
Maximum results	Row cap for the run.
Requests per minute	Pacing for calls to the provider, which allows 10 per second.
Client secret, client id	Your own credentials, both as secret inputs.

Filters that do not apply to the chosen platform are left off with a warning in the log.

Example output

A public profile analytics row:

{
  "service": "profileAnalytics",
  "requested": "https://www.instagram.com/trailrunner.jo/",
  "found": true,
  "platform": "instagram",
  "username": "trailrunner.jo",
  "fullName": "Jo Trail Runner",
  "url": "https://www.instagram.com/trailrunner.jo",
  "isVerified": false,
  "followers": 284000,
  "engagementRate": 3.4,
  "averageLikes": 9100,
  "averageComments": 240,
  "creatorCountry": "United States",
  "emails": ["press@example.com"],
  "audienceCredibilityScore": 0.71,
  "audienceGender": { "female": 46.2, "male": 53.8 },
  "audienceAge": { "13-17": 4.1, "18-24": 29.5, "25-34": 38.7, "35-44": 17.3, "45-64": 10.4 },
  "audienceCountries": [{ "code": "us", "percent": 18.4 }, { "code": "in", "percent": 9.7 }],
  "followerTypes": [{ "name": "REAL", "percent": 64.1 }, { "name": "MASS_FOLLOWERS", "percent": 18.3 }],
  "topHashtags": ["trailrunner.jo", "wildlife"],
  "note": null
}

A connected content row:

{
  "service": "connectedContents",
  "requested": "3f1c2a9e-7b4d-4e8a-9c21-5d6e7f8a9b0c",
  "found": true,
  "platform": "youtube",
  "accountId": "3f1c2a9e-7b4d-4e8a-9c21-5d6e7f8a9b0c",
  "contentType": "VIDEO",
  "contentFormat": "VIDEO",
  "title": "A week in the Alps",
  "publishedAt": "2026-09-14T16:00:00",
  "likes": 18400,
  "comments": 912,
  "views": 402331,
  "shares": 1210,
  "reach": 380002,
  "impressions": 655120
}

Values are illustrative.

FAQ

What is this influencer search and creator data API used for?

Finding, vetting and reporting on creators for influencer marketing and creator economy products. A brand team searches TikTok for creators with 50,000 to 500,000 followers, an engagement rate above 3 percent and a mostly female audience aged 18 to 34 in the United States, then pulls the public profile analytics of the shortlist to check audience credibility and fake follower shares. A creator platform reads the posts and audience demographics of creators who connected their YouTube or Instagram accounts, to verify their reach before a campaign or a payout.

Which data source does this actor read?

The Phyllo API, through the routes of its public documentation at docs.getphyllo.com: POST /v1/social/creators/profiles/search for discovery, POST /v1/social/creators/profiles/analytics for public profile analytics, GET /v1/work-platforms to look up platform ids, and GET /v1/accounts, GET /v1/profiles, GET /v1/social/contents and GET /v1/audience for connected accounts. Nothing is written: users, connection links, refresh jobs, publishing and webhooks are not called.

What is the difference between public and connected data?

Public data (discovery search and profile analytics) covers any public creator profile, built by the provider from publicly available signals. Connected data covers only creators who linked their accounts to your app through the provider's connect flow, and comes from the platform itself with the creator's permission: exact reach and impressions per post, private audience demographics and profile contacts. Connected services take the account ids your app received; the connected accounts service lists them.

Do I need API keys?

Yes. This actor is bring-your-own-key and never ships one. The provider issues a client id and a client secret on its dashboard, one pair per environment. Paste the secret into the client secret input and the id into the client id input, or set them once as the DATA_API_KEY and DATA_API_AUTH_ID environment secrets. They are sent as HTTP Basic authorization to the API host only. A missing or refused key ends the run cleanly with a message saying which it was.

Which environment should I use?

Production for real data, which is what your plan bills. Staging for internal testing with real accounts, limited to 25 connections. Sandbox returns mock data for any request, which is useful to test a key and the output shape; sandbox rows are never charged by this actor.

What is the audience credibility score?

A score from 0 to 1 for how much of a creator's audience the provider judges to be genuine people rather than bots, inactive or mass-following accounts. It is returned in public profile analytics together with the follower type split, and it can be used as a minimum in the discovery search.

How do location filters work?

The creator and audience location filters take the provider's own location ids, which are UUIDs from its location dictionary, such as the id for France or for Los Angeles. Paste them into the creator or audience location ids input; anything that is not a UUID is refused before a call is made. The dictionary route itself is documented but not served by the API today, so this actor does not list it.

What happens when there is nothing for a profile or account?

It becomes its own row with found: false and a note: profile not found, account id unknown, account disconnected or session expired, or no audience data yet. Those rows are never charged.

How is it priced?

Pay per result: $0.005 per creator found by a search, connected account or connected profile, $0.005 per connected content item, $0.01 per connected audience report and $0.02 per public profile analytics report. Sandbox rows and rows for requests that produced nothing are free. Your provider plan applies separately.

Pricing

Event	Price
Creator or account found (search, connected accounts, connected profiles)	$0.005 per row
Content item returned (connected content)	$0.005 per item
Connected audience report returned	$0.01 per report
Public profile analytics returned	$0.02 per report

Keyword map

influencer search API, creator discovery API, influencer analytics API, creator data API, public profile analytics, audience demographics API, audience credibility score, fake follower check, Instagram influencer search, TikTok creator search, YouTube channel analytics, Twitch streamer search, X creator search, connected creator accounts, creator content engagement, creator economy data, influencer vetting, Phyllo API, Phyllo creator search, Phyllo profile analytics.