Skip to main content
POST
/
v1
/
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
filters
object
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[]
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