Skip to main content
GET
/
v1
/
posts
/
by-creator
import InflushipAPI from 'influship';

const client = new InflushipAPI({
apiKey: 'My API Key',
});

const response = await client.posts.listByCreator();

console.log(response.pagination);
{
"posts": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"platform": "instagram",
"platform_post_id": "3234567890123456789",
"shortcode": "CxABc1234De",
"is_video": false,
"caption": "Morning workout complete! 💪",
"media_url": "https://cdn.influship.com/posts/img_123.jpg",
"media_urls": [
"https://cdn.influship.com/posts/img_123.jpg"
],
"posted_at": "2024-01-15T08:30:00.000Z",
"likes_count": 5420,
"comments_count": 143,
"creator": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"username": "fitness_guru",
"platform": "instagram"
}
}
],
"pagination": {
"cursor": "eyJpZCI6MTIzfQ==",
"has_more": true
}
}

Authorizations

X-API-Key
string
header
required

API key for authentication

Query Parameters

creator_id
string<uuid>

Creator UUID

username
string

Social media username

platform
enum<string>

Social media platform

Available options:
instagram,
tiktok
features
enum<string>[]

Optional analysis features. ai_analysis adds summary/transcript. brand_safety adds rating/flags. Each feature has additional cost.

Available options:
ai_analysis,
brand_safety
cursor
string

Opaque pagination cursor from previous response. Do not construct manually.

Example:

"eyJpZCI6MTIzfQ=="

limit
integer
default:25

Number of posts per page. Min 1, max 100, default 25.

Required range: 1 <= x <= 100
date_from
string<date-time>

Start date for filtering posts (ISO 8601)

date_to
string<date-time>

End date for filtering posts (ISO 8601)

Response

Posts retrieved successfully

Response for getting posts by creator

posts
object[]
required

Array of posts

pagination
object
required

Cursor-based pagination metadata. Use this to navigate through paginated results efficiently.

Example:
{
"cursor": "eyJpZCI6MjUsInNjb3JlIjowLjg1fQ==",
"has_more": true
}