Skip to main content
POST
/
v1
/
profiles
/
lookup
JavaScript
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' }],
});

console.log(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"
    }
  ]
}

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

Response

Successful response

data
object[]
required

Profiles that were found

not_found
object[]
required

Profiles that were not found