Find Similar Creators

Find creators similar to provided seed creators using AI-powered similarity matching. Analyzes content themes, audience overlap, posting style, and engagement patterns.

Use cases:

• Expand campaigns with creators similar to proven performers
• Find alternatives when preferred creators are unavailable
• Discover emerging creators in the same niche

How it works:

1. Provide 1-10 seed creators (by ID or platform/username)
2. Optionally weight seeds to prioritize certain creators
3. Get ranked results with similarity scores and shared traits

Also callable as the find_lookalike_creators MCP tool — see the MCP server guide for setup.

Pricing: 1.5 credits per creator returned ($0.015)

POST /v1/creators/lookalike

cURL

cURL

curl --request POST \
  --url https://api.influship.com/v1/creators/lookalike \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "seeds": [
    {
      "creator_id": "123e4567-e89b-12d3-a456-426614174000",
      "platform": "instagram",
      "username": "fitness_coach_jane",
      "weight": 1
    }
  ]
}
'

import Influship from 'influship';

const client = new Influship({
  apiKey: process.env['INFLUSHIP_API_KEY'], // This is the default and can be omitted
});

// Automatically fetches more pages as needed.
for await (const creatorLookalikeResponse of client.creators.lookalike({ seeds: [{}] })) {
  console.log(creatorLookalikeResponse.creator);
}

import os
from influship import Influship

client = Influship(
    api_key=os.environ.get("INFLUSHIP_API_KEY"),  # This is the default and can be omitted
)
page = client.creators.lookalike(
    seeds=[{}],
)
page = page.data[0]
print(page.creator)

200

{
  "data": [
    {
      "creator": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "Jane Fitness",
        "bio": "Fitness coach & wellness advocate",
        "avatar_url": "https://cdn.example.com/avatars/jane.jpg"
      },
      "primary_profile": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "platform": "instagram",
        "username": "fitness_coach_jane",
        "url": "https://www.instagram.com/fitness_coach_jane",
        "followers": 125000,
        "engagement_rate": 3.5,
        "is_verified": true
      },
      "similarity": {
        "score": 0.78,
        "shared_traits": [
          "Similar content style",
          "Same niche audience"
        ]
      }
    }
  ],
  "has_more": true,
  "next_cursor": "eyJvZmZzZXQiOjI1fQ=="
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

Authorizations

X-API-Key · string · header · required

Body

application/json

Find similar creators request

Find similar creators request

seeds · object[] · required

Seed creators to find similar creators for

Required array length: 1 - 10 elements

Show child attributes

filters · object

Additional filters

Show child attributes

limit · integer · default: 25

Maximum results to return

Required range: 1 <= x <= 100

Example:

25

cursor · string

Pagination cursor for next page

Response

200

application/json

Successful response

data · object[] · required

Show child attributes

has_more · boolean · required

Whether more results are available

Example:

true

next_cursor · string | null · required

Cursor for the next page

Example:

"eyJvZmZzZXQiOjI1fQ=="