import InflushipAPI from 'influship';

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

const response = await client.lookalike.findSimilarCreators({
  seeds: [{ id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e' }],
});

console.log(response.billing_plan);

{
  "items": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "Sarah Fitness",
      "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>"
        }
      ],
      "ai_recommendation": {
        "score": 0.92,
        "explanation": "Strong match for fitness content with high engagement and authentic wellness focus",
        "evidence": [
          {
            "fact": "Partnered with Nike for Q4 2024 fitness campaign",
            "score": 0.87,
            "factId": "fact_9a8b7c6d5e4f3g2h",
            "source_post_id": [
              "post_abc123",
              "post_def456"
            ],
            "created_at": "2024-10-15T14:30:00Z"
          }
        ]
      },
      "avatar_url": "https://cdn.influship.com/avatars/sarah.jpg",
      "bio": "Certified personal trainer and wellness coach"
    }
  ],
  "filtered_total": 123,
  "has_more": true,
  "next_cursor": "<string>",
  "credits_charged": 123,
  "features": [
    "<string>"
  ],
  "billing_plan": "<string>",
  "rate_limit": {
    "limit": 123,
    "remaining": 123,
    "reset": 123
  }
}

Lookalike

Find Lookalike Creators

Find creators similar to your seed creators using AI-powered similarity analysis.

This endpoint analyzes your seed creators and finds similar influencers based on audience demographics, content style, and engagement patterns.

Pricing:

Base: 1.0 credit per creator returned
Detailed mode: Additional 0.05 credits per social account profile
Example: 25 lookalike creators in lite mode = 25 credits
Example: 25 creators with avg 3 profiles each in detailed mode = 25 + (25 × 3 × 0.05) = 28.75 credits

POST

lookalike

import InflushipAPI from 'influship';

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

const response = await client.lookalike.findSimilarCreators({
  seeds: [{ id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e' }],
});

console.log(response.billing_plan);

{
  "items": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "Sarah Fitness",
      "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>"
        }
      ],
      "ai_recommendation": {
        "score": 0.92,
        "explanation": "Strong match for fitness content with high engagement and authentic wellness focus",
        "evidence": [
          {
            "fact": "Partnered with Nike for Q4 2024 fitness campaign",
            "score": 0.87,
            "factId": "fact_9a8b7c6d5e4f3g2h",
            "source_post_id": [
              "post_abc123",
              "post_def456"
            ],
            "created_at": "2024-10-15T14:30:00Z"
          }
        ]
      },
      "avatar_url": "https://cdn.influship.com/avatars/sarah.jpg",
      "bio": "Certified personal trainer and wellness coach"
    }
  ],
  "filtered_total": 123,
  "has_more": true,
  "next_cursor": "<string>",
  "credits_charged": 123,
  "features": [
    "<string>"
  ],
  "billing_plan": "<string>",
  "rate_limit": {
    "limit": 123,
    "remaining": 123,
    "reset": 123
  }
}

Authorizations

X-API-Key

string

header

required

API key for authentication

Query Parameters

limit

integer

default:25

Maximum number of results to return

Required range: 1 <= x <= 100

cursor

string

Opaque pagination cursor from previous response's next_cursor. Do not construct manually.

Example:

"eyJpZCI6MjUsInNjb3JlIjowLjg1fQ=="

Body

application/json

seeds

object[]

required

Seed creators to find lookalikes for. Max 10 seeds, each with optional weight (0-10, default 1).

Required array length: 1 - 10 elements

Seed creator provided for lookalike discovery

Option 1
Option 2

Show child attributes

seeds.id

string<uuid>

required

Unique creator identifier

Required string length: 1 - 100

seeds.weight

number

default:1

Weight for this seed in similarity calculation

Required range: 0 <= x <= 10

seeds.platform

enum<string>

Platform name (optional when using the ID)

Available options:

instagram

filters

object

Show child attributes

filters.platform

string[]

Filter by platforms

filters.audience_size

object

Show child attributes

filters.audience_size.min

number

Required range: x >= 0

filters.audience_size.max

number

Required range: x >= 0

filters.engagement_rate

object

Show child attributes

filters.engagement_rate.min

number

Required range: 0 <= x <= 1

filters.engagement_rate.max

number

Required range: 0 <= x <= 1

filters.verified

boolean

mode

enum<string>

default:lite

Response detail level

Available options:

lite,

detailed

profile_platforms

enum<string>[]

Filter which social media profiles to include in the response for each creator.

If not specified, all profiles for each creator are returned
If specified, only profiles from these platforms are included
This allows you to control which platforms you want to see results from
Independent of your seed creators' platforms - you can mix seed types freely Example: ["instagram"] to only see instagram profiles, ["instagram", "tiktok"] for both
This allows you to get cross-platform creators but only show specific platform profiles

Available options:

instagram,

tiktok

Response

Lookalike results

items

object[]

Show child attributes

items.id

string<uuid>

required

Unique creator identifier (UUID v4)

Example:

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

items.name

string

required

Creator's display name or full name

Example:

"Sarah Fitness"

items.profiles

object[]

required

Array of ALL social media profiles for this creator

Basic social account information returned in lite mode

Option 1
Option 2

Show child attributes

items.profiles.id

string<uuid>

required

Unique social account identifier

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

items.profiles.platform

enum<string>

required

Social media platform

Available options:

instagram,

tiktok

items.profiles.username

string

required

Username on the platform

items.profiles.display_name

string

required

Display name on the platform

items.profiles.bio

string | null

required

Account bio

items.profiles.verified

boolean

required

Whether the account has platform verification (blue checkmark).

Example:

true

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

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

items.profiles.avatar_url

string<uri> | null

Profile picture URL

items.profiles.external_url

string<uri> | null

External website URL

items.ai_recommendation

object

required

AI-powered recommendation analysis explaining why this creator matches your query

Show child attributes

items.ai_recommendation.score

number

required

Relevance score from 0 to 1, where 1 is a perfect match. Scores above 0.7 indicate strong relevance.

Required range: 0 <= x <= 1

Example:

0.92

items.ai_recommendation.explanation

string

required

Human-readable explanation of why this creator was recommended. Highlights key matching factors from the query.

Example:

"Strong match for fitness content with high engagement and authentic wellness focus"

items.ai_recommendation.evidence

object[]

Fact-level evidence from hybrid search explaining why this creator matched. Each fact represents specific, verifiable information about the creator.

Show child attributes

items.ai_recommendation.evidence.fact

string

required

The actual fact text describing specific information about the creator

Example:

"Partnered with Nike for Q4 2024 fitness campaign"

items.ai_recommendation.evidence.score

number

required

Combined relevance score (similarity × confidence × temporal decay). Higher scores indicate stronger evidence for the match.

Required range: 0 <= x <= 1

Example:

0.87

items.ai_recommendation.evidence.factId

string

required

Unique identifier for this fact

Example:

"fact_9a8b7c6d5e4f3g2h"

items.ai_recommendation.evidence.source_post_id

string[]

Array of source post IDs where this fact originated. A single fact may come from multiple posts.

Example:

["post_abc123", "post_def456"]

items.ai_recommendation.evidence.created_at

string<date-time>

When this fact was created or observed (ISO 8601 format)

Example:

"2024-10-15T14:30:00Z"

items.avatar_url

string<uri> | null

Profile picture URL. null if no avatar is available. URLs are typically valid for 24 hours.

Example:

"https://cdn.influship.com/avatars/sarah.jpg"

items.bio

string | null

Creator's biography or description text. May be aggregated from multiple platforms. null if unavailable.

Example:

"Certified personal trainer and wellness coach"

filtered_total

integer

Total number of results after filtering

has_more

boolean

Whether there are more results available

next_cursor

string

Cursor for next page of results

credits_charged

number

Credits consumed for this request

features

string[]

Features used in this request

billing_plan

string

Current billing plan

rate_limit

object

Show child attributes

rate_limit.limit

integer

Rate limit for this endpoint

rate_limit.remaining

integer

Remaining requests in current window

rate_limit.reset

integer

Unix timestamp when rate limit resets

Get Social Account Data by Username Analyze a single post

⌘I

Overview

Endpoints

Find Lookalike Creators

Authorizations

Query Parameters

Body

Response