Get posts by creator

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

Show child attributes

posts.id

string<uuid>

required

Internal post ID

posts.platform

enum<string>

required

Social media platform

Available options:

instagram,

tiktok

posts.platform_post_id

string

required

Platform-specific unique identifier for this post. Format varies by platform (Instagram: numeric ID, TikTok: alphanumeric).

Example:

"3234567890123456789"

posts.is_video

boolean

required

Whether this post contains video content. true for video posts and reels, false for photo posts.

Example:

false

posts.media_url

string<uri>

required

URL of the primary media file (image or video). For carousel posts, this is the first item.

Example:

"https://cdn.influship.com/posts/img_123.jpg"

posts.posted_at

string<date-time>

required

ISO 8601 timestamp when the post was originally published.

Example:

"2024-01-15T08:30:00.000Z"

posts.creator

object

required

Creator information for a post

Show child attributes

posts.creator.id

string<uuid>

required

Creator UUID

posts.creator.username

string

required

Social media username

posts.creator.platform

enum<string>

required

Social media platform

Available options:

instagram,

tiktok

posts.shortcode

string | null

Instagram shortcode used in post URLs (instagram.com/p/{shortcode}). Only present for Instagram posts, null for other platforms.

Example:

"CxABc1234De"

posts.caption

string | null

Post caption text written by the creator. null if no caption was provided.

Example:

"Morning workout complete! 💪 Ready to take on the day. #fitness #wellness"

posts.accessibility_caption

string | null

Alt text or accessibility caption describing the media. Useful for understanding image content. null if unavailable.

Example:

"Person doing yoga pose on beach at sunrise"

posts.media_urls

string<uri>[]

Array of all media URLs in this post. Contains multiple items for carousel posts, single item for regular posts.

Example:

[
  "https://cdn.influship.com/posts/img_123.jpg"
]

posts.thumbnail_url

string<uri> | null

Thumbnail image URL for video posts. Only present when is_video is true, null for photo posts.

Example:

"https://cdn.influship.com/posts/thumb_123.jpg"

posts.scraped_at

string<date-time>

ISO 8601 timestamp when we last scraped/updated this post's data. Metrics are accurate as of this time.

Example:

"2024-01-15T10:00:00.000Z"

posts.likes_count

integer | null

Total likes on post. null if platform hides like counts or data unavailable.

Required range: x >= 0

Example:

5420

posts.comments_count

integer | null

Total comments on post. null if unavailable.

Required range: x >= 0

Example:

143

posts.video_view_count

integer | null

Video view count. null for photo posts or if unavailable.

Required range: x >= 0

Example:

28500

posts.video_duration_seconds

number | null

Video length in seconds. null for photo posts.

Required range: x >= 0

Example:

45.5

posts.ai_analysis

object

AI-powered content analysis. Only present when ai_analysis feature is requested.

Show child attributes

posts.ai_analysis.summary

string

required

AI-generated summary describing key themes, topics, and messaging.

Example:

"Post showcases a morning workout routine featuring yoga and strength training. Promotes healthy lifestyle and wellness practices with motivational messaging."

posts.ai_analysis.transcript

string | null

Transcription of spoken words in video. null for photo posts or videos without speech.

Example:

"Good morning everyone! Today we're doing a 20-minute full body workout..."

posts.brand_safety

object

Brand safety analysis results

Show child attributes

posts.brand_safety.ok

boolean

required

Whether the analysis completed successfully

Example:

true

posts.brand_safety.rating

enum<string>

required

Brand safety rating. A = safe (no risks), B = moderate concerns, C = significant risks.

Available options:

A,

B,

C

Example:

"A"

posts.brand_safety.overall_confidence

number

required

Confidence score (0-1) for the rating. >0.8 = high confidence.

Required range: 0 <= x <= 1

Example:

0.92

posts.brand_safety.summary

string

required

Human-readable summary of the assessment.

Example:

"Content is family-friendly and aligns with positive brand values"

posts.brand_safety.flags

object[]

required

Specific safety concerns detected. Empty array = no issues found.

Show child attributes

posts.brand_safety.flags.type

enum<string>

required

Category of brand safety concern detected:

adult_sexual_content: Sexually explicit or suggestive content
profanity_strong_language: Profanity or offensive language
drugs_alcohol_tobacco: Drug, alcohol, or tobacco-related content
violence_weapons: Violent content or weapon references
hate_discrimination: Hate speech or discriminatory content
political_social_issues: Politically divisive or controversial topics
misinformation_conspiracy: Misinformation or conspiracy theories
misc: Other brand safety concerns

Available options:

adult_sexual_content,

profanity_strong_language,

drugs_alcohol_tobacco,

violence_weapons,

hate_discrimination,

political_social_issues,

misinformation_conspiracy,

misc

Example:

"profanity_strong_language"

posts.brand_safety.flags.severity

enum<string>

required

Severity level of the concern:

low: Minor issue, may be acceptable for some brands
medium: Moderate concern, evaluate based on brand guidelines
high: Significant risk, likely unsuitable for most brands

Available options:

low,

medium,

high

Example:

"low"

posts.brand_safety.flags.confidence

number

required

Confidence score for this specific flag (0-1). Higher values indicate greater certainty about this concern.

Required range: 0 <= x <= 1

Example:

0.75

posts.brand_safety.flags.description

string

required

Human-readable description explaining the concern. Provides context about what was detected.

Example:

"Occasional use of mild profanity in captions"

posts.brand_safety.flags.evidence

string[]

Specific examples or evidence that triggered this flag. May include post excerpts or contextual information.

Example:

[
  "Post on 2024-01-10: 'This is damn good'",
  "Post on 2024-01-08: Caption contains mild language"
]

Example:

[]

posts.brand_safety.reasoning

string

required

Detailed reasoning explaining the analysis result. Includes context about content analyzed and decision factors.

Example:

"Analysis of 20 recent posts shows consistent positive messaging focused on health and wellness with no controversial content"

posts.brand_safety.metadata

object

required

Show child attributes

posts.brand_safety.metadata.model_version

string

required

Version of the AI model used for analysis

posts.brand_safety.metadata.analysis_date

string<date-time>

required

When the analysis was performed

posts.brand_safety.metadata.processing_time_ms

number

required

Processing time in milliseconds

posts.brand_safety.metadata.content_analyzed

object

required

Information about the content that was analyzed

Show child attributes

posts.brand_safety.metadata.content_analyzed.text_length

number

Length of text content analyzed

posts.brand_safety.metadata.content_analyzed.posts_count

number

Number of posts analyzed (for profile/creator analysis)

pagination

object

required

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

Show child attributes

pagination.has_more

boolean

required

Indicates whether more results are available.

true: Additional pages exist, use the cursor to fetch them
false: This is the last page of results

Example:

true

pagination.cursor

string | null

Opaque base64-encoded cursor string for fetching the next page. Pass this value as the cursor query parameter in your next request. null when has_more is false (no more pages available). Do not attempt to decode or construct cursor values manually.

Example:

"eyJpZCI6MjUsInNjb3JlIjowLjg1LCJ0aW1lc3RhbXAiOjE3MDQxMjQ4MDB9"

Example:

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

Overview

Endpoints

Authorizations

Query Parameters

Response