Influencer Batch enrichment API
Enrich up to 10,000 creators in one batch
Is there an API to enrich thousands of creators at once?
Yes. The Influencers.club Batch enrichment endpoints run asynchronous jobs of up to 10,000 creators: create the batch, poll status, resume if needed, and download results as CSV or JSON via a presigned URL. Billing is per enriched record at the mode’s normal rate — records that can’t be enriched aren’t billed.
Make the call
Both samples below are complete. Paste one in, swap the key, get a 200.
https://api-dashboard.influencers.club/public/v1/enrichment/batch/
Authorization: Bearer <API_KEY>
Content type application/json
Rate Per enriched record, at the mode’s rate
Full reference →
What comes back
A 200 with the page of creators and your remaining credit balance. Creator values below are elided — field names and types are exactly as published in the API schema.
The spec
| Parameter | Type | Accepted values | Behaviour |
|---|---|---|---|
| POST /public/v1/enrichment/batch/ | endpoint | file, platform, enrichment_mode, metadata, email_required, include_audience_data, include_lookalikes, exclude_platforms, min_followers | Asynchronous: upload a CSV to create the job, poll …/{batch_id}/status/ every 30–60 seconds, then GET …/{batch_id}/download/ for a presigned link to the enriched CSV. …/{batch_id}/resume/ restarts a paused or failed job for free. |
| file | file, required | CSV with one column: handle or email | Up to 10,000 rows. |
| platform | string | instagram · youtube · tiktok · twitch · twitter · onlyfans | Required for handle batches. |
| enrichment_mode | string, required | raw · full (handles) · basic (emails) | Which enrichment to run on every row. |
| email_required · include_audience_data · include_lookalikes · exclude_platforms · min_followers | optional | preferred / must_have · booleans · platform list · integer | Same options as single Full enrichment, plus a follower floor and platforms to skip. |
Billing. Per enriched record, at the rate of the mode you choose — 0.03 (raw) or 1 (full) per handle, 0.05 per email. Records that can’t be enriched aren’t billed. Creating, polling, resuming and downloading a batch is free.
How teams use this endpoint
Three ways this fits a creator-data workflow.
Create the job
Upload a CSV and get a batch_id back.
curl -X POST https://api-dashboard.influencers.club/public/v1/enrichment/batch/ \ -H 'Authorization: Bearer YOUR_API_KEY' \ -F 'file=@handles.csv' -F platform=instagram -F enrichment_mode=full \ -F email_required=must_have -F min_followers=1000
Poll until done
Check status every 30–60 seconds.
GET https://api-dashboard.influencers.club/public/v1/enrichment/batch/b_7f3e2a91c04d/status/
Download the results
A presigned URL for the enriched CSV.
GET https://api-dashboard.influencers.club/public/v1/enrichment/batch/b_7f3e2a91c04d/download/
Other creator data you can access
Influencer API endpoints
Six platforms with full data, 40+ more in the social graph
Instagramdiscovery · full data
TikTokdiscovery · full data
YouTubediscovery · full data
X / Twitterdiscovery · full data
Twitchdiscovery · full data
OnlyFansdiscovery · full dataPlus Facebook, Pinterest, Reddit, LinkedIn, Discord, Snapchat,
Linktree and 40+ more via connected socials.
Frequently asked questions
What does this endpoint cost?+
You pay per enriched record at the mode’s normal rate — 0.03 credits per handle in raw mode, 1 credit per handle in full mode, 0.05 per email. Records that can’t be enriched aren’t billed, and creating, polling, resuming or downloading the batch costs nothing.
Where can I find my API key?+
Create a free account. You will find your API key through the API side menu.
How do I enrich up to 10,000 creators in one batch using your API?+
Sign up for free and copy your API key from the dashboard. POST a CSV (one column: handle or email) to /public/v1/enrichment/batch/ as multipart form data with platform and enrichment_mode — raw or full for handles, basic for emails — plus any of the Full enrichment options (email_required, include_audience_data, include_lookalikes, exclude_platforms, min_followers) and an optional metadata JSON. You get a batch_id; poll /batch/{id}/status/ every 30–60 seconds, then GET /batch/{id}/download/ for a presigned link to the enriched CSV. You pay per enriched record at the mode’s rate; the job itself is free.
What are your pricing plans and what do they include?+
Paid plans start at $249/month and use a flexible credit-based model.
Each API call consumes a specific number of credits depending on the endpoint and data depth. You can compare all tiers, credit amounts, and per-endpoint costs in the Pricing section of our API docs.
How can I get in touch with your team?+
Book a time on our calendar to talk to someone from our team and learn about the full capabilities of our API.