Influencer API · Endpoint Endpoint reference

Influencer Creator Posts API

Get creator posts with engagement metrics

Is there an API to get a creator’s posts?

Yes. The Influencers.club Creator Posts endpoint returns a creator’s recent posts with engagement metrics — Instagram (12 per page), TikTok (up to 35) and YouTube (up to 50), with cursor-based pagination.

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
3
Platforms supported: Instagram, TikTok, YouTube
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/creators/content/posts/
Auth Authorization: Bearer <API_KEY> Content type application/json Rate 0.03 credits per successful request Full reference →
curl -X POST https://api-dashboard.influencers.club/public/v1/creators/content/posts/ \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"platform": "instagram", "handle": "mrbeast", "count": 12}'
import requests

res = requests.post(
    "https://api-dashboard.influencers.club/public/v1/creators/content/posts/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "platform": "instagram",
        "handle": "mrbeast",
        "count": 12,
    }, ) print(res.json())
const res = await fetch("https://api-dashboard.influencers.club/public/v1/creators/content/posts/", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    platform: "instagram",
    handle: "mrbeast",
    count: 12,
  }), }); const data = await res.json();
$ch = curl_init("https://api-dashboard.influencers.club/public/v1/creators/content/posts/");
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, '{"platform": "instagram", "handle": "mrbeast", "count": 12}');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
body := strings.NewReader(`{"platform": "instagram", "handle": "mrbeast", "count": 12}`)
req, _ := http.NewRequest("POST", "https://api-dashboard.influencers.club/public/v1/creators/content/posts/", 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
{
  "result": {
    "items": [
      {
        "pk": "3702042988674165349_1541770582",
        "taken_at": 1757523600,
        "media_type": 2,
        "media_url": "https://www.instagram.com/p/DGxk2L1S8fQ/",
        "caption": "Spring drop is live — link in bio",
        "engagement": { "likes": 18420, "comments": 312, "views": 241900 },
        "user": { "pk": "1541770582", "username": "mrbeast", "full_name": "MrBeast" }
      }
    ],
    "num_results": 12,
    "more_available": true,
    "next_token": "QVFCUmxfNU9..."
  },
  "credits_cost": 0.03 }
Response fields JSON always returned · docs on request
FieldTypeMeaning
Envelope
resultobjectContainer for the page of posts.
result.itemsarrayPosts on this page — 12 for Instagram, up to 35 for TikTok, up to 50 for YouTube.
result.num_resultsintegerNumber of posts in this page.
result.more_availablebooleanWhether another page exists.
result.next_tokenstringCursor to pass as pagination_token for the next page.
credits_costnumberCredits charged for this request (0.03).
Each post
pkstringPost ID — pass it to Post Details for comments, transcript or audio.
taken_atintegerUnix timestamp of when the post was published.
media_typeintegerMedia type of the post.
media_urlstringURL of the post media.
image_versions.candidates[]arrayThumbnail candidates with url, width and height.
captionstringPost caption or title.
engagement.likesintegerLike count.
engagement.commentsintegerComment count.
engagement.viewsintegerView count (video posts).
user.usernamestringCreator username on the platform.
user.full_namestringCreator display name.
user.profile_pic_urlstringProfile picture URL — temporary, expires after 24 hours.
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.

engagement.views is only populated for video posts; profile_pic_url expires after 24 hours, so download it if you need to keep it. Full schema in the endpoint reference.

Parameters

The spec

Parameter Type Accepted values Behaviour
/public/v1/creators/content/posts/ endpoint platform, handle, count, pagination_token One POST per page. Instagram returns 12 posts per page, TikTok up to 35, YouTube up to 50; pass next_token as pagination_token to page further.
platform string, required instagram · tiktok · youtube Platform the creator is on.
handle string, required username, profile URL or YouTube channel ID (UC…) Which creator to fetch posts for.
count integer Instagram: fixed at 12 · TikTok: default 30, max 35 · YouTube: default 30, max 50 Posts per page. Clamped to the platform limit.
pagination_token string next_token from the previous response Cursor for the next page. Omit for the first page.

Billing. 0.03 credits per successful request. If no data is returned, no credits are deducted.

Recipes

How teams use this endpoint

Three ways this fits a creator-data workflow.

One call to try it

Pull the 12 latest Instagram posts for a handle, with engagement.

curl -X POST https://api-dashboard.influencers.club/public/v1/creators/content/posts/ \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"platform": "instagram", "handle": "mrbeast", "count": 12}'

Page through a creator’s feed

Pass next_token back as pagination_token until more_available is false.

POST https://api-dashboard.influencers.club/public/v1/creators/content/posts/ {
  "platform": "tiktok",
  "handle": "khaby.lame",
  "count": 35,
  "pagination_token": "QVFCUmxfNU9..." }

Chain into Post Details

Take a post’s pk and fetch its comments, transcript or audio.

POST https://api-dashboard.influencers.club/public/v1/creators/content/details/ {
  "platform": "instagram",
  "post_id": "3702042988674165349_1541770582",
  "content_type": "comments" }

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.03 credits per successful request. If no data is returned, no credits are deducted.

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 get creator posts with engagement metrics using your API?+

Sign up for free and copy your API key from the dashboard. POST to /public/v1/creators/content/posts/ with a platform (instagram, tiktok or youtube) and the creator’s handle, profile URL or YouTube channel ID. You get back a page of recent posts with likes, comments and views, plus a next_token — send it back as pagination_token to fetch the next page. Each request costs 0.03 credits.

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.