Influencer API · Endpoint Endpoint reference

Influencer Subscriptions API

Monitor creators with webhook subscriptions

Is there an API to monitor creators continuously?

Yes. The Influencers.club Subscriptions endpoints let you subscribe to creators and receive their activity by webhook — new posts, profile changes and growth milestones — with full CRUD on subscriptions, per-subscription creator management, stats and CSV export.

Verified against the live API in August 2026 Endpoint reference →

What this endpoint returns

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

Measured August 2026

340M+

Searchable Influencer profiles

40+

Data points returned per creator

Platforms mapped in the social graph

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/subscription/

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/subscription/ \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name": "Launch creators \u2014 new posts", "platform": "instagram", "event_type": "new_post", "handles": ["mrbeast", "khaby00"], "notify_endpoints": [{"destination": "https://example.com/webhooks/influencers-club", "notify_type": "api"}]}'

import requests

res = requests.post(
    "https://api-dashboard.influencers.club/public/v1/social/listening/subscription/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "name": "Launch creators \u2014 new posts",
        "platform": "instagram",
        "event_type": "new_post",
        "handles": [
            "mrbeast",
            "khaby00"
        ],
        "notify_endpoints": [
            {
                "destination": "https://example.com/webhooks/influencers-club",
                "notify_type": "api"
            }
        ]
    }, ) print(res.json())

const res = await fetch("https://api-dashboard.influencers.club/public/v1/social/listening/subscription/", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "name": "Launch creators \u2014 new posts",
    "platform": "instagram",
    "event_type": "new_post",
    "handles": [
      "mrbeast",
      "khaby00"
    ],
    "notify_endpoints": [
      {
        "destination": "https://example.com/webhooks/influencers-club",
        "notify_type": "api"
      }
    ]
  }), }); const data = await res.json();

$ch = curl_init("https://api-dashboard.influencers.club/public/v1/social/listening/subscription/");
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": "Launch creators \u2014 new posts", "platform": "instagram", "event_type": "new_post", "handles": ["mrbeast", "khaby00"], "notify_endpoints": [{"destination": "https://example.com/webhooks/influencers-club", "notify_type": "api"}]}');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

body := strings.NewReader(`{"name": "Launch creators \u2014 new posts", "platform": "instagram", "event_type": "new_post", "handles": ["mrbeast", "khaby00"], "notify_endpoints": [{"destination": "https://example.com/webhooks/influencers-club", "notify_type": "api"}]}`)
req, _ := http.NewRequest("POST", "https://api-dashboard.influencers.club/public/v1/social/listening/subscription/", 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": 1184,
  "name": "Launch creators — new posts",
  "subscription_type": "webhook",
  "platform": "instagram",
  "event_type": "new_post",
  "status": "active",
  "paused_reason": null,
  "filters": {},
  "interval": "hourly",
  "notify_endpoints": [
    {
      "id": 301,
      "destination": "https://example.com/webhooks/influencers-club",
      "notify_type": "api",
      "created_at": "2026-09-17T10:12:04Z"
    }
  ],
  "source_lists": [],
  "sample_creators": "mrbeast, khaby00",
  "creator_count": "2",
  "delivery_health": "healthy",
  "last_event_at": null,
  "credits_spent": "0.00",
  "created_at": "2026-09-17T10:12:04Z",
  "updated_at": "2026-09-17T10:12:04Z" }

Response fields JSON always returned · docs on request

Field	Type	Meaning
Subscription object
id	integer	Subscription ID.
name	string	Your label.
subscription_type	string	webhook, or campaign when a campaign provisioned it.
platform	string	Platform being monitored.
event_type	string	Activity being watched — new posts, bio / link changes, follower milestones.
status · paused_reason	string	active or paused, and why if paused (e.g. out of credits).
filters	object	Optional conditions events must meet.
interval	string	How often creators are checked.
notify_endpoints[]	array	Where events go — id, destination, notify_type, created_at.
source_lists[]	array	Discovery lists the creators came from.
sample_creators	string	A few of the monitored handles.
creator_count	string	Live creator links in the subscription.
delivery_health	string	Rolling webhook delivery health.
last_event_at	string	When the last event was caught.
credits_spent	string	Credits consumed by this subscription so far.
created_at · updated_at	string	Timestamps.
GET …/subscription/ (list)
count · next · previous	integer / string	Pagination.
results[]	array	Your subscriptions.
summary.active_subscriptions	integer	How many are active.
summary.deliveries_24h	object	total · successful · failed webhook deliveries in the last day.
summary.success_rate	number	Delivery success ratio.
summary.avg_detection_latency_seconds	number	Average time from activity to detection.
Errors (400 / 403 / 429)
error_code	string	Machine-readable slug, e.g. insufficient_credits. Always present on errors — branch on this, not on error.
error	string	Human-readable description of what went wrong.
retry_after	integer	Seconds to wait before retrying a 429; mirrored in the Retry-After header.

Campaign-backed subscriptions can’t be paused, resumed or deleted directly — manage them through the campaign. The list endpoint accepts ?type= to filter by subscription_type.

Parameters

The spec

Parameter	Type	Accepted values	Behaviour
/public/v1/social/listening/subscription/	endpoint	name, platform, event_type, handles and/or list_ids, notify_endpoints, filters	A subscription watches a set of creators on one platform for one event_type and delivers matching events to your notify_endpoints. Seed it with handles, Discovery list_ids or both; add more later via …/{id}/creators/ (handles, lists or a CSV). Billed 0.3 credits per creator per day.
platform	string, required	instagram · tiktok · youtube · …	Platform to monitor.
event_type	string, required	new_post · bio_change · follower_threshold · …	Which activity to watch.
handles · list_ids	array	Handles and/or Discovery list IDs	Creators to monitor. At least one of the two.
notify_endpoints	array, required	[{ "destination": url, "notify_type": "api" }]	Where events are delivered.

Billing. 0.3 credits per creator, per day — however you group creators into subscriptions or campaigns. A creator tracked in several places counts once. Webhook deliveries and API calls are included.

Recipes

How teams use this endpoint

Three ways this fits a creator-data workflow.

Watch a few creators

Handles in, webhook events out.

platform: "instagram", "event_type": "new_post", "handles": ["mrbeast", "khaby00"], "notify_endpoints": [{ "destination": "https://example.com/webhooks/influencers-club", "notify_type": "api" }]

Seed from a Discovery list

Monitor everyone in a saved list without pasting handles.

POST /public/v1/social/listening/subscription/ {
  "name": "UK beauty micro-creators",
  "platform": "tiktok",
  "event_type": "new_post",
  "list_ids": [57],
  "notify_endpoints": [{ "destination": "https://example.com/webhooks/influencers-club", "notify_type": "api" }] }

Read what it caught

Events are also queryable, not just pushed.

GET /public/v1/social/listening/events/?subscription_id=1184&event_type=new_post

Other creator data you can access

Influencer API endpoints

Tracking and Posts · 7

Campaigns Creator Posts Events Post Comments Post Details Post Transcripts Subscriptions

Platform coverage

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 data

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. The same creator in several subscriptions or campaigns counts once, and webhook deliveries and API calls are included — 50 creators for 30 days is 450 credits.

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 monitor creators with webhook subscriptions using your API?+

Sign up for free and copy your API key from the dashboard. POST to /public/v1/social/listening/subscription/ with a platform, an event_type (new_post, bio_change, follower_threshold…), the creators to watch (handles and/or Discovery list_ids) and one or more notify_endpoints. You get back the subscription with its status, creator_count and delivery_health; events arrive at your endpoint as they happen and are also listable at /events/. 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.