canonical: https://jentic.com/apis/influencers.club/influencers

# Influencers Club Core API Concepts

The Influencers.club API finds and enriches social media creators across platforms such as Instagram, YouTube, TikTok, Twitch, and X (Twitter). It enriches a creator from a handle or an email address, returning profile, analytics, audience, and contact data, and runs batch enrichment jobs from an uploaded file for larger lists. Its discovery operations search for creators by structured criteria, find similar creators, and measure audience overlap, while social listening campaigns and subscriptions track what a set of creators posts and report on it.

## For AI agents

Enrich social media creators by handle or email, discover and compare creators, run batch enrichment jobs, and track creator content with social listening campaigns.

## Scope

Does not handle publishing posts, paying creators, or managing ad spend on social platforms. Use for creator discovery, enrichment, and campaign content tracking only.

## Capabilities

- Enrich a creator by handle and platform with full, profile, analytics, or raw data, optionally with include_audience_data and include_lookalikes
- Look up creator profiles from an email address via `/public/v1/creators/enrich/email`/
- Submit a batch enrichment file in raw, full, or basic enrichment_mode, then poll its status and download the results as CSV
- Search for creators with the discovery endpoint and find similar creators to a known profile
- Measure audience overlap between several creators on the same platform
- Track creator posts in a social listening campaign with tracking_keywords, start_date, and end_date, then generate an AI report
- Keep exclusion lists of handles so discovery skips creators you have already contacted

## Use cases

### Creator research agent through Jentic

An AI agent connected through Jentic builds a shortlist of creators for a brand. It searches the discovery endpoint for candidates, enriches the promising ones by handle to read profile and audience data, and checks audience overlap so the brand does not pay twice to reach the same followers. The Influencers.club key stays in your own Jentic One instance rather than in the agent's context.

Example prompt: Call POST `/public/v1/creators/enrich/handle/full`/ with handle 'natgeo', platform 'instagram', and include_audience_data true, then summarise the follower count and top audience locations

### Bulk creator list enrichment

Enrich a spreadsheet of creator handles without calling the API row by row. Upload the file to the batch enrichment endpoint with an enrichment_mode of raw, full, or basic, poll the batch status until it completes, then download the results as CSV. A stopped batch can be resumed by its batch_id.

Example prompt: Call POST `/public/v1/enrichment/batch`/ with the handles file, platform 'tiktok', and enrichment_mode 'basic', then poll GET `/public/v1/enrichment/batch/{batch_id}/status`/ and fetch GET `/public/v1/enrichment/batch/{batch_id}/download`/ when it finishes

### Campaign content tracking

Follow what hired creators actually publish during a sponsorship. Create a social listening campaign with a name, platforms, content_types, start_date, and end_date, add the creators, then list the campaign content and overview as posts come in. The AI report operation summarises the campaign once it has run.

Example prompt: Call POST `/public/v1/social/listening/campaign`/ with name 'Spring launch', platforms ['instagram'], content_types ['post'], start_date '2026-03-01', and end_date '2026-03-31', then add creators via POST `/public/v1/social/listening/campaign/{campaign_id}/creators`/

### Lookalike creator discovery

Expand a roster from creators that already perform well. The similar creators operation returns lookalike profiles, and exclusion lists keep handles you have already contacted out of discovery results so outreach does not repeat.

Example prompt: Call POST `/public/v1/discovery/creators/similar`/ for a known creator, then add the handles already contacted to the default exclusion list via POST `/public/v1/discovery/exclusion-lists/default/{platform}/entries`/

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/public/v1/creators/enrich/handle/full/` | Enrich a creator by handle with full data |
| POST | `/public/v1/creators/enrich/email/` | Enrich creators by email |
| POST | `/public/v1/discovery/` | Search for creators |
| POST | `/public/v1/discovery/creators/similar/` | Find similar creators |
| POST | `/public/v1/creators/audience/overlap/` | Measure audience overlap |
| POST | `/public/v1/enrichment/batch/` | Create a batch enrichment job |
| GET | `/public/v1/enrichment/batch/{batch_id}/download/` | Download batch results as CSV |
| POST | `/public/v1/social/listening/campaign/` | Create a social listening campaign |

## Key resources

- **Creator enrichment** — Full, profile, analytics, and raw enrichment by handle, plus lookup by email, connected socials, and post data
- **Discovery** — Creator search, similar creators, audience overlap, and classifier lists for languages, locations, brands, and interests
- **Batch enrichment** — Upload, check status, resume, and download batch enrichment jobs
- **Exclusion lists** — Lists of handles to exclude from discovery, per platform or named list
- **Social listening** — Campaigns, subscriptions, events, content, overviews, and AI reports for tracked creators
- **Account** — Credit usage, API keys, and connected OAuth apps

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 64 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 62 / 100
  - Developer Experience & Jentic Compatibility: 61 / 100
  - AI-Readiness & Agent Experience: 50 / 100
  - Agent Usability: 90 / 100
  - Security: 60 / 100
  - AI Discoverability: 88 / 100
- **View full report:** https://jentic.com/apis/influencers.club/influencers/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring Influencers.club by hand means handling its bearer key, polling and resuming asynchronous batch jobs, and keeping platform enums straight across many enrichment operations. Through Jentic you install once, import Influencers.club from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** Influencers.club puts campaign, subscription, and exclusion list ids in the URL path (`/public/v1/social/listening/campaign/{campaign_id}/...`), so a rule can pin your agent to one campaign and the operations you pick. Creator enrichment carries the handle in the request body, so there rules bound which operations the agent may call, not which creator.
- **Credential handling:** Your Influencers.club API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'enrich an Instagram creator' or 'find similar creators', and Jentic returns the matching Influencers.club operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Modash API** — Influencer discovery and creator audience data for marketing teams
- **Phyllo API** — Creator data through creator-authorised connections to social platforms
- **Hunter API** — Email finding and verification for business domains
- **Google YouTube Data API** — First-party YouTube channel, video, and playlist data

## FAQ

### Is there an Influencers.club MCP server?

You don't need an MCP server to give your agent Influencers.club. Jentic connects it directly from the API Directory: import it, store your API key once, and your agent calls it. The agent finds the enrichment, discovery, or campaign operation it needs on demand instead of loading every tool definition into its context.

### Can I limit what my agent is allowed to do with the Influencers.club API?

Yes. The spec notes that every Influencers.club credential is currently issued with full access, so the limit has to come from somewhere else. Write a Jentic rule that allows only GET `/public/v1/social/listening/campaign/{campaign_id}/content`/ and GET `/public/v1/social/listening/campaign/{campaign_id}/overview`/ for one campaign id: a reporting agent can read that campaign and nothing more, it cannot create or delete API keys, and every call it makes is logged.

### What authentication does the Influencers.club API use?

Per its OpenAPI spec, the Influencers.club API uses HTTP bearer authentication: send an API key in the `Authorization` header as `Bearer <key>`. The OAuth client registration, authorization, and token operations are the exception: they are called without a bearer credential and identify the app by its client_id. Through Jentic, your key is stored encrypted by your own Jentic One instance and injected into the operations that need it.

### Can I find a creator's contact email with the Influencers.club API?

The handle enrichment operations accept an email_required field set to must_have or preferred, which controls whether results must include an email. You can also go the other way: POST `/public/v1/creators/enrich/email`/ takes an email address and returns the matching creator data.

### What are the rate limits for the Influencers.club API?

The OpenAPI spec does not specify request rate limits; check https://docs.influencers.club for current limits. Usage is metered in credits, and GET `/public/v1/accounts/credits`/ returns your current credit balance and usage.

### How do I enrich a list of creators with the Influencers.club API through Jentic?

Install Jentic One with `curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh`, import Influencers.club from the API Directory, and store your API key. Your agent searches for 'batch enrich creator handles', gets POST `/public/v1/enrichment/batch`/ with its input schema, uploads the file with an enrichment_mode, then polls the status and downloads the CSV. To run it on your own infrastructure, install Jentic One from its GitHub repo.

### Which platforms does the Influencers.club API cover?

Platform support varies by operation. Handle enrichment accepts platforms including instagram, youtube, tiktok, twitter, snapchat, discord, and pinterest, while analytics enrichment and exclusion lists include twitch. Check the platform enum on the specific operation before calling it.