Analyze a single post

import InflushipAPI from 'influship';

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

const postAnalysis = await client.posts.analyze({ url: 'https://example.com' });

console.log(postAnalysis.id);

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "platform": "instagram",
  "platform_post_id": "3234567890123456789",
  "is_video": false,
  "media_url": "https://cdn.influship.com/posts/img_123.jpg",
  "posted_at": "2024-01-15T08:30:00.000Z",
  "creator": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "username": "<string>",
    "platform": "instagram"
  },
  "shortcode": "CxABc1234De",
  "caption": "Morning workout complete! 💪 Ready to take on the day. #fitness #wellness",
  "accessibility_caption": "Person doing yoga pose on beach at sunrise",
  "media_urls": [
    "https://cdn.influship.com/posts/img_123.jpg"
  ],
  "thumbnail_url": "https://cdn.influship.com/posts/thumb_123.jpg",
  "scraped_at": "2024-01-15T10:00:00.000Z",
  "likes_count": 5420,
  "comments_count": 143,
  "video_view_count": 28500,
  "video_duration_seconds": 45.5,
  "ai_analysis": {
    "summary": "Post showcases a morning workout routine featuring yoga and strength training. Promotes healthy lifestyle and wellness practices with motivational messaging.",
    "transcript": "Good morning everyone! Today we're doing a 20-minute full body workout..."
  },
  "brand_safety": {
    "ok": true,
    "rating": "A",
    "overall_confidence": 0.92,
    "summary": "Content is family-friendly and aligns with positive brand values",
    "flags": [],
    "reasoning": "Analysis of 20 recent posts shows consistent positive messaging focused on health and wellness with no controversial content",
    "metadata": {
      "model_version": "<string>",
      "analysis_date": "2023-11-07T05:31:56Z",
      "processing_time_ms": 123,
      "content_analyzed": {
        "text_length": 123,
        "posts_count": 123
      }
    }
  }
}

POST

posts

analyze

import InflushipAPI from 'influship';

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

const postAnalysis = await client.posts.analyze({ url: 'https://example.com' });

console.log(postAnalysis.id);

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "platform": "instagram",
  "platform_post_id": "3234567890123456789",
  "is_video": false,
  "media_url": "https://cdn.influship.com/posts/img_123.jpg",
  "posted_at": "2024-01-15T08:30:00.000Z",
  "creator": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "username": "<string>",
    "platform": "instagram"
  },
  "shortcode": "CxABc1234De",
  "caption": "Morning workout complete! 💪 Ready to take on the day. #fitness #wellness",
  "accessibility_caption": "Person doing yoga pose on beach at sunrise",
  "media_urls": [
    "https://cdn.influship.com/posts/img_123.jpg"
  ],
  "thumbnail_url": "https://cdn.influship.com/posts/thumb_123.jpg",
  "scraped_at": "2024-01-15T10:00:00.000Z",
  "likes_count": 5420,
  "comments_count": 143,
  "video_view_count": 28500,
  "video_duration_seconds": 45.5,
  "ai_analysis": {
    "summary": "Post showcases a morning workout routine featuring yoga and strength training. Promotes healthy lifestyle and wellness practices with motivational messaging.",
    "transcript": "Good morning everyone! Today we're doing a 20-minute full body workout..."
  },
  "brand_safety": {
    "ok": true,
    "rating": "A",
    "overall_confidence": 0.92,
    "summary": "Content is family-friendly and aligns with positive brand values",
    "flags": [],
    "reasoning": "Analysis of 20 recent posts shows consistent positive messaging focused on health and wellness with no controversial content",
    "metadata": {
      "model_version": "<string>",
      "analysis_date": "2023-11-07T05:31:56Z",
      "processing_time_ms": 123,
      "content_analyzed": {
        "text_length": 123,
        "posts_count": 123
      }
    }
  }
}

Authorizations

X-API-Key

string

header

required

API key for authentication

Body

application/json

Option 1
Option 2

Request payload for analyzing a single social media post

url

string<uri>

required

Public URL of the post to analyze Public URL of the post to analyze

post_id

string

Platform-specific post ID

platform

enum<string>

Social media platform (required when using post_id)

Available options:

instagram,

tiktok

features

enum<string>[]

Analysis features to include

Available options:

ai_analysis,

brand_safety

Response

Post analysis results

Analysis result for a single social media post

string<uuid>

required

Internal post ID

platform

enum<string>

required

Social media platform

Available options:

instagram,

tiktok

platform_post_id

string

required

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

Example:

"3234567890123456789"

is_video

boolean

required

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

Example:

false

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"

posted_at

string<date-time>

required

ISO 8601 timestamp when the post was originally published.

Example:

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

creator

object

required

Creator information for a post

Show child attributes

creator.id

string<uuid>

required

Creator UUID

creator.username

string

required

Social media username

creator.platform

enum<string>

required

Social media platform

Available options:

instagram,

tiktok

shortcode

string | null

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

Example:

"CxABc1234De"

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"

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"

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"
]

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"

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"

likes_count

integer | null

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

Required range: x >= 0

Example:

5420

comments_count

integer | null

Total comments on post. null if unavailable.

Required range: x >= 0

Example:

143

video_view_count

integer | null

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

Required range: x >= 0

Example:

28500

video_duration_seconds

number | null

Video length in seconds. null for photo posts.

Required range: x >= 0

Example:

45.5

ai_analysis

object

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

Show child attributes

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."

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..."

brand_safety

object

Brand safety analysis results

Show child attributes

brand_safety.ok

boolean

required

Whether the analysis completed successfully

Example:

true

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"

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

brand_safety.summary

string

required

Human-readable summary of the assessment.

Example:

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

brand_safety.flags

object[]

required

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

Show child attributes

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"

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"

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

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"

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:

[]

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"

brand_safety.metadata

object

required

Show child attributes

brand_safety.metadata.model_version

string

required

Version of the AI model used for analysis

brand_safety.metadata.analysis_date

string<date-time>

required

When the analysis was performed

brand_safety.metadata.processing_time_ms

number

required

Processing time in milliseconds

brand_safety.metadata.content_analyzed

object

required

Information about the content that was analyzed

Show child attributes

brand_safety.metadata.content_analyzed.text_length

number

Length of text content analyzed

brand_safety.metadata.content_analyzed.posts_count

number

Number of posts analyzed (for profile/creator analysis)

Find Lookalike Creators Get posts by creator

⌘I

Overview

Endpoints

Authorizations

Body

Response