import InflushipAPI from 'influship';

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

const response = await client.profiles.lookup({
  profiles: [
    { platform: 'instagram', username: 'fitness_guru' },
    { platform: 'tiktok', username: 'fitness_guru' },
  ],
});

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

Social Accounts

Get Social Account Data by Username

DISCOVERY ENDPOINT: Look up social account data when you know a username and platform.

🎯 When to use this endpoint:

✅ You have a username and platform (e.g., @fitness_guru on Instagram)
✅ You want to discover who a social account belongs to
✅ You need to look up specific social accounts by username
✅ You want to get social account metrics for known usernames

❌ When NOT to use this endpoint:

❌ You already have a creator UUID (use /v1/creators/{id}/profiles instead)
❌ You want to get all accounts for a creator (use /v1/creators/{id}/profiles instead)

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

🔗 Data Relationships:

Use the creator_profile_id field to fetch creator-level data via /v1/creators
Use the creator_profile_id to get all social accounts via /v1/creators/{id}/profiles
Creator-level data includes: name, bio, avatar, ai_one_line_bio
Social account data includes: follower_count, engagement_rate, verified, platform-specific metrics

🔄 Typical Workflow:

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

⚙️ Parameters:

mode: lite (default) or detailed - controls response detail level
platforms: Array of platform names to filter results (e.g., ["instagram", "tiktok"]) Pricing: 0.01-0.05 credits per profile (lite/detailed mode)

POST

profiles

import InflushipAPI from 'influship';

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

const response = await client.profiles.lookup({
  profiles: [
    { platform: 'instagram', username: 'fitness_guru' },
    { platform: 'tiktok', username: 'fitness_guru' },
  ],
});

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

Body

application/json

profiles

object[]

required

Required array length: 1 - 100 elements

Show child attributes

profiles.platform

enum<string>

required

Social platform where the creator exists

Available options:

instagram,

tiktok

profiles.username

string

required

Username on the platform

Required string length: 1 - 50

Example:

[
  {
    "platform": "instagram",
    "username": "fitness_guru"
  },
  {
    "platform": "tiktok",
    "username": "fitness_guru"
  }
]

mode

enum<string>

default:lite

Response detail level - lite for basic fields, detailed for additional metrics

Available options:

lite,

detailed

platforms

enum<string>[]

Filter results to only include these platforms

Available options:

instagram,

tiktok

Example:

["instagram", "tiktok"]

Response

Profile information with all data and recent posts

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 All Social Accounts for a Creator Find Lookalike Creators

⌘I

Overview

Endpoints

Get Social Account Data by Username

Authorizations

Body

Response