Influencer API · Endpoint Endpoint reference

Influencer Campaigns API

Track campaigns and creator content via API

Is there an API to track influencer campaigns?

Yes. The Influencers.club Campaigns endpoints group your monitored creators into campaigns and return overview metrics and a content feed per campaign — posts, engagement and deliverables in one place, over the API instead of a dashboard.

Verified against the live API in Endpoint reference →

What this endpoint returns

Counted on the live search index, not modelled or rounded.

Measured
340M+
Searchable Influencer profiles
40+
Data points returned per creator
47
Platforms mapped in the social graph
6
Platforms with full discovery support
Request

Make the call

Both samples below are complete. Paste one in, swap the key, get a 200.

POST https://api-dashboard.influencers.club/public/v1/social/listening/campaign/
Auth Authorization: Bearer <API_KEY> Content type application/json Rate 0.3 credits per creator per day Full reference →
curl -X POST https://api-dashboard.influencers.club/public/v1/social/listening/campaign/ \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name": "Autumn drop", "platforms": ["instagram", "tiktok"], "content_types": ["post", "reel", "video"], "tracking_keywords": ["#autumndrop", "@ourbrand"], "brief": "Launch of the autumn collection", "start_date": "2026-10-01", "end_date": "2026-10-31", "budget": "25000"}'
import requests

res = requests.post(
    "https://api-dashboard.influencers.club/public/v1/social/listening/campaign/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "name": "Autumn drop",
        "platforms": [
            "instagram",
            "tiktok"
        ],
        "content_types": [
            "post",
            "reel",
            "video"
        ],
        "tracking_keywords": [
            "#autumndrop",
            "@ourbrand"
        ],
        "brief": "Launch of the autumn collection",
        "start_date": "2026-10-01",
        "end_date": "2026-10-31",
        "budget": "25000"
    }, ) print(res.json())
const res = await fetch("https://api-dashboard.influencers.club/public/v1/social/listening/campaign/", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "name": "Autumn drop",
    "platforms": [
      "instagram",
      "tiktok"
    ],
    "content_types": [
      "post",
      "reel",
      "video"
    ],
    "tracking_keywords": [
      "#autumndrop",
      "@ourbrand"
    ],
    "brief": "Launch of the autumn collection",
    "start_date": "2026-10-01",
    "end_date": "2026-10-31",
    "budget": "25000"
  }), }); const data = await res.json();
$ch = curl_init("https://api-dashboard.influencers.club/public/v1/social/listening/campaign/");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "Authorization: Bearer YOUR_API_KEY",
  "Content-Type: application/json", ]);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"name": "Autumn drop", "platforms": ["instagram", "tiktok"], "content_types": ["post", "reel", "video"], "tracking_keywords": ["#autumndrop", "@ourbrand"], "brief": "Launch of the autumn collection", "start_date": "2026-10-01", "end_date": "2026-10-31", "budget": "25000"}');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
body := strings.NewReader(`{"name": "Autumn drop", "platforms": ["instagram", "tiktok"], "content_types": ["post", "reel", "video"], "tracking_keywords": ["#autumndrop", "@ourbrand"], "brief": "Launch of the autumn collection", "start_date": "2026-10-01", "end_date": "2026-10-31", "budget": "25000"}`)
req, _ := http.NewRequest("POST", "https://api-dashboard.influencers.club/public/v1/social/listening/campaign/", body)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
Response

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.

200 OKJSON
{
  "id": 318,
  "name": "Autumn drop",
  "platforms": {
    "instagram": true,
    "tiktok": true
  },
  "status": "draft",
  "brief": "Launch of the autumn collection",
  "content_types": {
    "post": true,
    "reel": true,
    "video": true
  },
  "tracking_keywords": {
    "hashtags": [
      "#autumndrop"
    ],
    "mentions": [
      "@ourbrand"
    ]
  },
  "start_date": "2026-10-01",
  "end_date": "2026-10-31",
  "budget": "25000",
  "creator_count": "0",
  "created_at": "2026-09-17T10:12:04Z",
  "updated_at": "2026-09-17T10:12:04Z" }
Response fields JSON always returned · docs on request
FieldTypeMeaning
Campaign object
idintegerCampaign ID.
namestringYour label.
platformsobjectPlatforms the campaign monitors.
statusstringdraft · active · paused · completed.
briefstringFree-text description.
content_typesobjectWhich post types count toward the campaign.
tracking_keywordsobjectHashtags and mentions that flag a post as campaign content.
start_date · end_datestringCampaign window.
budgetstringDecimal budget, used for EMV comparison.
creator_countstringLive creator links across the campaign’s subscriptions.
created_at · updated_atstringTimestamps.
GET …/{id}/overview/
posts · views · engagement · engagement_rate · emvnumberAggregate metrics for the campaign.
trend_7dobjectWeek-over-week movement.
Errors (400 / 403 / 429)
error_codestringMachine-readable slug, e.g. insufficient_credits. Always present on errors — branch on this, not on error.
errorstringHuman-readable description of what went wrong.
retry_afterintegerSeconds to wait before retrying a 429; mirrored in the Retry-After header.

Overview, content list, AI report and CSV export each have their own GET under /campaign/{id}/. platforms, content_types and tracking_keywords are sent as arrays and come back as objects.

Parameters

The spec

Parameter Type Accepted values Behaviour
/public/v1/social/listening/campaign/ endpoint name, platforms, content_types, tracking_keywords, brief, start_date, end_date, budget A campaign provisions the per-platform subscriptions for you and layers analytics on top: per-post metrics, engagement rate, estimated reach, EMV, 7-day trends, an AI report and CSV export. Add creators via …/{id}/creators/. Billed 0.3 credits per creator per day.
name string, required Any label Campaign name.
platforms array, required instagram · tiktok · youtube · … Platforms to monitor.
content_types · tracking_keywords array post types per platform · hashtags and @mentions Which posts count, and what marks a post as campaign content.
brief · budget string free text · decimal as a string Description, and the spend to measure EMV against.

Billing. 0.3 credits per creator, per day — estimate a campaign as creators × days × 0.3. A creator tracked in several campaigns counts once. Overview metrics, AI reports, CSV exports and API calls are included.

Recipes

How teams use this endpoint

Three ways this fits a creator-data workflow.

Create the campaign

Dates, platforms and keywords in one POST.

name: "Autumn drop", "platforms": ["instagram", "tiktok"], "content_types": ["post", "reel", "video"], "tracking_keywords": ["#autumndrop", "@ourbrand"], "start_date": "2026-10-01", "end_date": "2026-10-31"

Add the creators

From handles, a Discovery list or a CSV.

POST /public/v1/social/listening/campaign/318/creators/ { "platform": "instagram", "handles": ["mrbeast", "khaby00"] }

Read the numbers

Overview metrics, content list, AI report, CSV.

GET /public/v1/social/listening/campaign/318/overview/ GET /public/v1/social/listening/campaign/318/content/ POST /public/v1/social/listening/campaign/318/report/

Other creator data you can access

Influencer API endpoints

Platform coverage

Six platforms with full data, 40+ more in the social graph

Plus Facebook, Pinterest, Reddit, LinkedIn, Discord, Snapchat,
Linktree and 40+ more via connected socials.

FAQ

Frequently asked questions

What does this endpoint cost?+

0.3 credits per creator, per day — estimate a campaign as creators × days × 0.3, so 25 creators for a 7-day launch is 52.5 credits. Overview metrics, AI reports, CSV exports and API calls are all included.

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 track campaigns and creator content via API using your API?+

Sign up for free and copy your API key from the dashboard. POST to /public/v1/social/listening/campaign/ with a name, platforms, content_types, the hashtags or mentions that identify campaign content (tracking_keywords), start and end dates and optionally a brief and budget, then add creators via /campaign/{id}/creators/ from handles, a Discovery list or a CSV. Every new post triggers a webhook, and /campaign/{id}/overview/ returns posts, views, engagement, engagement rate and EMV with 7-day trends; /report/ generates an AI summary and /report/export/ a CSV. 0.3 credits per creator per day.

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.