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": [
{
"platform": "instagram",
"username": "fitness_coach_jane"
}
]
}
'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 requests
url = "https://api.influship.com/v1/creators/lookalike"
payload = { "seeds": [
{
"platform": "instagram",
"username": "fitness_coach_jane"
}
] }
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"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,
"data_updated_at": "2026-07-20T12:00:00.000+00:00"
},
"similarity": {
"score": 0.78,
"shared_traits": [
"Similar content style",
"Same niche audience"
]
}
}
],
"has_more": true,
"next_cursor": "eyJvZmZzZXQiOjI1fQ=="
}{
"error": {
"code": "validation_error",
"message": "Invalid value for parameter 'limit': must be between 1 and 100",
"param": "limit",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "unauthorized",
"message": "API key missing or invalid",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "payment_required",
"message": "Payment authentication is required.",
"status_code": 402,
"reason_code": "PAYMENT_ACTION_REQUIRED",
"next_step": "complete_authentication",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "forbidden",
"message": "Your plan does not include access to this endpoint",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "not_found",
"message": "Creator with ID '123e4567-e89b-12d3-a456-426614174000' not found",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded (per minute)",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "internal_error",
"message": "An unexpected error occurred. Please try again later.",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "service_unavailable",
"message": "An internal dependency returned an invalid response",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "service_unavailable",
"message": "Live Instagram data is temporarily unavailable. Please retry shortly.",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {
"retry_after_seconds": 60,
"upstream_error": "upstream_rate_limited"
}
}
}Creators
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:
- Provide 1-10 seed creators (by ID or platform/username)
- Optionally weight seeds to prioritize certain creators
- Get ranked results with similarity scores and shared traits
If none of the supplied seeds is available for similarity matching, the endpoint returns 404 seed_not_found. Choose another seed instead of retrying the same request.
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 --request POST \
--url https://api.influship.com/v1/creators/lookalike \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"seeds": [
{
"platform": "instagram",
"username": "fitness_coach_jane"
}
]
}
'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 requests
url = "https://api.influship.com/v1/creators/lookalike"
payload = { "seeds": [
{
"platform": "instagram",
"username": "fitness_coach_jane"
}
] }
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"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,
"data_updated_at": "2026-07-20T12:00:00.000+00:00"
},
"similarity": {
"score": 0.78,
"shared_traits": [
"Similar content style",
"Same niche audience"
]
}
}
],
"has_more": true,
"next_cursor": "eyJvZmZzZXQiOjI1fQ=="
}{
"error": {
"code": "validation_error",
"message": "Invalid value for parameter 'limit': must be between 1 and 100",
"param": "limit",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "unauthorized",
"message": "API key missing or invalid",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "payment_required",
"message": "Payment authentication is required.",
"status_code": 402,
"reason_code": "PAYMENT_ACTION_REQUIRED",
"next_step": "complete_authentication",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "forbidden",
"message": "Your plan does not include access to this endpoint",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "not_found",
"message": "Creator with ID '123e4567-e89b-12d3-a456-426614174000' not found",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded (per minute)",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "internal_error",
"message": "An unexpected error occurred. Please try again later.",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "service_unavailable",
"message": "An internal dependency returned an invalid response",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "service_unavailable",
"message": "Live Instagram data is temporarily unavailable. Please retry shortly.",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {
"retry_after_seconds": 60,
"upstream_error": "upstream_rate_limited"
}
}
}Authorizations
Body
application/json
Find similar creators request
Find similar creators request
Seed creators to find similar creators for
Required array length:
1 - 10 elementsShow child attributes
Show child attributes
Additional filters
Show child attributes
Show child attributes
Maximum results to return
Required range:
1 <= x <= 100Example:
25
Pagination cursor for next page