import InflushipAPI from 'influship';

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

const response = await client.creators.listProfiles('123e4567-e89b-12d3-a456-426614174000');

console.log(response.profiles);

{
  "profiles": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "creator_profile_id": "123e4567-e89b-12d3-a456-426614174000",
      "platform": "instagram",
      "username": "<string>",
      "display_name": "<string>",
      "bio": "<string>",
      "verified": true,
      "follower_count": 125000,
      "engagement_rate": 4.2,
      "avatar_url": "<string>",
      "external_url": "<string>"
    }
  ]
}

Creators

Get All Social Accounts for a Creator

EXPLORATION ENDPOINT: Get all social account data when you know a creator UUID.

🎯 When to use this endpoint:

✅ You have a creator UUID (from /v1/creators or /v1/profiles response)
✅ You want to see all social accounts for a creator (Instagram, TikTok, etc.)
✅ You need comprehensive social account data for a creator
✅ You want to explore all platforms a creator is on

❌ When NOT to use this endpoint:

❌ You only have a username and platform (use /v1/profiles instead)
❌ You don’t have a creator UUID (use /v1/profiles to discover first)

📊 Response Format: Returns SocialAccountLite or SocialAccountDetailed objects with identical structure to /v1/profiles. Both endpoints return the same data structure for consistency.

🔗 Data Relationships:

This endpoint requires a creator UUID (not a social account ID)
Use creator_profile_id from /v1/profiles response as the {id} parameter
Returns all social accounts associated with that creator
Filter by platform using the platforms query parameter

🔄 Typical Workflow:

Discovery: Call /v1/profiles with username+platform → get social account data + creator_profile_id
All Accounts: Call /v1/creators/{creator_profile_id}/profiles → get all social accounts for that creator
Creator Data: Call /v1/creators with creator_profile_id → get creator-level data

⚙️ Parameters:

mode: lite (default) or detailed - controls response detail level
platforms: Comma-separated list of platforms to filter (e.g., instagram,tiktok) Pricing: 0.01-0.05 credits per social account (lite/detailed mode)

GET

creators

{id}

profiles

import InflushipAPI from 'influship';

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

const response = await client.creators.listProfiles('123e4567-e89b-12d3-a456-426614174000');

console.log(response.profiles);

{
  "profiles": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "creator_profile_id": "123e4567-e89b-12d3-a456-426614174000",
      "platform": "instagram",
      "username": "<string>",
      "display_name": "<string>",
      "bio": "<string>",
      "verified": true,
      "follower_count": 125000,
      "engagement_rate": 4.2,
      "avatar_url": "<string>",
      "external_url": "<string>"
    }
  ]
}

Authorizations

X-API-Key

string

header

required

API key for authentication

Path Parameters

string<uuid>

required

Creator UUID

Query Parameters

mode

enum<string>

default:lite

Response detail level

Available options:

lite,

detailed

platforms

string

Comma-separated list of platforms to include (instagram, tiktok)

Response

Social account data for the creator

profiles

object[]

Array of social account objects. The structure depends on the mode parameter:

If mode: "lite": Returns SocialAccountLite objects
If mode: "detailed": Returns SocialAccountDetailed objects with additional fields

Basic social account information returned in lite mode

Option 1
Option 2

Show child attributes

profiles.id

string<uuid>

required

Unique social account identifier

profiles.creator_profile_id

string<uuid>

required

Creator UUID this social account belongs to. Use with /v1/creators for person-level data (name, bio, avatar) or /v1/creators/{id}/profiles for all social accounts.

Example:

"123e4567-e89b-12d3-a456-426614174000"

profiles.platform

enum<string>

required

Social media platform

Available options:

instagram,

tiktok

profiles.username

string

required

Username on the platform

profiles.display_name

string

required

Display name on the platform

profiles.bio

string | null

required

Account bio

profiles.verified

boolean

required

Whether the account has platform verification (blue checkmark).

Example:

true

profiles.follower_count

number | null

Total number of followers on this platform. null if data is unavailable or account is private.

Required range: x >= 0

Example:

125000

profiles.engagement_rate

number | null

Engagement rate percentage (0-100). Formula: (avg_likes + avg_comments) / follower_count × 100. Based on last 12 posts. null if account is private or has <3 posts.

Required range: 0 <= x <= 100

Example:

4.2

profiles.avatar_url

string<uri> | null

Profile picture URL

profiles.external_url

string<uri> | null

External website URL

Get Creator Profile Information Get Social Account Data by Username

⌘I

Overview

Endpoints

Get All Social Accounts for a Creator

Authorizations

Path Parameters

Query Parameters

Response