Creators

Endpoints for discovering creators and pulling their stats, sponsor history, and audience.

Search creators

GET /api/v1/creators

Search YouTube creators by topic or brand, with optional typed filters. Returns a relevance-ranked, paginated list of up to 25 creators per page. Costs 1 credit per page.

curl -H "Authorization: Bearer ifsk_your_key" \
  "https://platform.influesque.com/api/v1/creators?query=gaming&min_subscribers=100000&has_sponsors=true"

Query parameters

Parameter	Type	Description
`query`	string, required	Short topic, keyword, or brand terms (e.g. `travel vlogs`). Not a full sentence.
`niche_category`	string	Content category value from Niches (e.g. `gaming`).
`primary_niche_only`	boolean	Only creators whose primary niche matches `niche_category`.
`country`	string	Country name or ISO code (e.g. `Netherlands` or `NL`).
`language`	string	Primary language (e.g. `English`).
`min_subscribers`, `max_subscribers`	integer	Subscriber range.
`min_avg_views`	integer	Minimum average views per video.
`min_engagement_rate`	number	Minimum engagement rate as a percent (e.g. `3` for 3%).
`has_sponsors`	boolean	Only creators with detected sponsorships.
`video_format`	string	`short` or `long`.
`sort`	string	`subs_desc`, `subs_asc`, `views_desc`, `avg_views_desc`, or `engagement_desc`. Omit to keep relevance ranking.
`page`	integer	1-based page number. Each page costs 1 credit.

Response

Field	Type	Description
`query`	string	The query you sent.
`page`	integer	Current page.
`totalFound`	integer	Total matching creators.
`returned`	integer	Creators on this page.
`hasMore`	boolean	Whether more pages exist.
`nextPage`	integer or null	Page number to request next.
`creators`	array	Creator summaries.

Each creator summary includes id, name, handle, influesqueUrl, youtubeUrl, country, language, verified, primaryNiche, topSponsors, subscribers, avgViews, totalViews, videoCount, and engagementRate.

Ranking tip

For "top N by a metric in a niche", omit sort (which reorders the whole broad match set) and instead add primary_niche_only=true with a subscriber or engagement floor, then re-rank the returned page yourself. Every result already carries subscribers, avgViews, and engagementRate.

Get a creator

GET /api/v1/creators/{id}

Full profile for one creator: stats, niches, social links, and full sponsor history. {id} can be a YouTube handle (with or without @), a channel id (UC...), or the creator-<id> slug returned by search. Costs 1 credit.

curl -H "Authorization: Bearer ifsk_your_key" \
  "https://platform.influesque.com/api/v1/creators/mrbeast"

{
  "creator": {
    "id": "mrbeast",
    "name": "MrBeast",
    "handle": "@MrBeast",
    "influesqueUrl": "https://platform.influesque.com/creators/42",
    "subscribers": 320000000,
    "primaryNiche": "Entertainment",
    "niches": ["Entertainment", "Gaming"],
    "sponsors": [
      {
        "name": "Honey",
        "website": "https://joinhoney.com",
        "influesqueUrl": "https://platform.influesque.com/sponsors/7",
        "sponsorshipCount": 12,
        "lastSeen": "2026-05-01"
      }
    ],
    "links": { "instagram": "https://instagram.com/mrbeast", "website": "https://mrbeast.store" }
  }
}

A 404 Not Found is returned when no creator matches the id.

Get audience demographics

GET /api/v1/creators/{id}/audience

Estimated audience demographics for a creator: age, gender, geography, language, and interest distributions, plus a confidence score. Costs 1 credit.

curl -H "Authorization: Bearer ifsk_your_key" \
  "https://platform.influesque.com/api/v1/creators/mrbeast/audience"

{
  "id": 42,
  "name": "MrBeast",
  "handle": "@MrBeast",
  "audience": {
    "ageDistribution": { "18-24": 0.41, "25-34": 0.33 },
    "genderDistribution": { "male": 0.68, "female": 0.32 },
    "geoDistribution": { "US": 0.29, "IN": 0.11 },
    "languageDistribution": { "en": 0.82 },
    "interests": ["gaming", "entertainment"],
    "confidence": 0.74,
    "confidenceLabel": "high",
    "estimated": true,
    "computedAt": "2026-06-15T00:00:00Z"
  }
}

When no estimate exists yet, audience is null and a note field explains why.