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 database
• not_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

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)

200

{
  "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": {}
  }
}

{
  "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

Batch lookup profiles request

Batch lookup profiles request

profiles · object[] · required

Profiles to lookup

Required array length: 1 - 100 elements

Show child attributes

Response

200

application/json

Successful response

data · object[] · required

Profiles that were found

Show child attributes

not_found · object[] · required

Profiles that were not found

Show child attributes