cURL
curl --request POST \
--url https://api.influship.com/v1/profiles/lookup \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"profiles": [
{
"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
});
const response = await client.profiles.lookup({
profiles: [
{ platform: 'instagram', username: 'fitness_coach_jane' },
{ platform: 'instagram', username: 'wellness_guru' },
{ platform: 'instagram', username: 'healthy_eating_tips' },
],
});
console.log(response.data);import os
from influship import Influship
client = Influship(
api_key=os.environ.get("INFLUSHIP_API_KEY"), # This is the default and can be omitted
)
response = client.profiles.lookup(
profiles=[{
"platform": "instagram",
"username": "fitness_coach_jane",
}, {
"platform": "instagram",
"username": "wellness_guru",
}, {
"platform": "instagram",
"username": "healthy_eating_tips",
}],
)
print(response.data){
"data": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"creator_id": "123e4567-e89b-12d3-a456-426614174001",
"platform": "instagram",
"username": "fitness_coach_jane",
"display_name": "Jane Fitness",
"bio": "Fitness coach & wellness advocate",
"avatar_url": "https://cdn.example.com/avatars/jane.jpg",
"url": "https://www.instagram.com/fitness_coach_jane",
"external_url": "https://janefitness.com",
"is_verified": true,
"is_business": true,
"is_private": false,
"category": "Health/Beauty",
"pronouns": [
"she",
"her"
],
"metrics": {
"followers": 125000,
"following": 1200,
"posts": 450,
"posts_last_30d": 12,
"engagement_rate": 3.5,
"avg_likes_recent": 4500,
"avg_comments_recent": 120,
"avg_views_recent": 15000,
"posts_per_week": 2.5
},
"growth": {
"followers_30d_pct": 2.5
},
"activity": {
"last_post_at": "2024-01-15T14:30:00Z"
},
"data_updated_at": "2024-01-15T14:30:00Z"
}
],
"not_found": [
{
"platform": "instagram",
"username": "unknown_user"
}
]
}{
"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": {}
}
}Profiles
Batch Lookup Profiles
Look up multiple profiles in a single request. Efficiently retrieve data for up to 100 profiles at once.
Response includes:
found: Array of profiles that exist in our databasenot_found: Array of profiles that weren’t found (consider live scraping these)
Also callable as the lookup_profiles MCP tool — see the MCP server guide for setup.
Pricing: 0.1 credits per profile ($0.001)
POST
/
v1
/
profiles
/
lookup
cURL
curl --request POST \
--url https://api.influship.com/v1/profiles/lookup \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"profiles": [
{
"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
});
const response = await client.profiles.lookup({
profiles: [
{ platform: 'instagram', username: 'fitness_coach_jane' },
{ platform: 'instagram', username: 'wellness_guru' },
{ platform: 'instagram', username: 'healthy_eating_tips' },
],
});
console.log(response.data);import os
from influship import Influship
client = Influship(
api_key=os.environ.get("INFLUSHIP_API_KEY"), # This is the default and can be omitted
)
response = client.profiles.lookup(
profiles=[{
"platform": "instagram",
"username": "fitness_coach_jane",
}, {
"platform": "instagram",
"username": "wellness_guru",
}, {
"platform": "instagram",
"username": "healthy_eating_tips",
}],
)
print(response.data){
"data": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"creator_id": "123e4567-e89b-12d3-a456-426614174001",
"platform": "instagram",
"username": "fitness_coach_jane",
"display_name": "Jane Fitness",
"bio": "Fitness coach & wellness advocate",
"avatar_url": "https://cdn.example.com/avatars/jane.jpg",
"url": "https://www.instagram.com/fitness_coach_jane",
"external_url": "https://janefitness.com",
"is_verified": true,
"is_business": true,
"is_private": false,
"category": "Health/Beauty",
"pronouns": [
"she",
"her"
],
"metrics": {
"followers": 125000,
"following": 1200,
"posts": 450,
"posts_last_30d": 12,
"engagement_rate": 3.5,
"avg_likes_recent": 4500,
"avg_comments_recent": 120,
"avg_views_recent": 15000,
"posts_per_week": 2.5
},
"growth": {
"followers_30d_pct": 2.5
},
"activity": {
"last_post_at": "2024-01-15T14:30:00Z"
},
"data_updated_at": "2024-01-15T14:30:00Z"
}
],
"not_found": [
{
"platform": "instagram",
"username": "unknown_user"
}
]
}{
"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
Body
application/json
Batch lookup profiles request
Batch lookup profiles request
Profiles to lookup
Required array length:
1 - 100 elementsShow child attributes
Show child attributes
⌘I