Skip to main content
GET
/
v1
/
profiles
/
{platform}
/
{username}
JavaScript
import Influship from 'influship';

const client = new Influship({
  apiKey: process.env['INFLUSHIP_API_KEY'], // This is the default and can be omitted
});

const profile = await client.profiles.get('fitness_coach_jane', { platform: 'instagram' });

console.log(profile.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"
  },
  "warning": "<string>"
}

Authorizations

X-API-Key
string
header
required

Path Parameters

platform
string
required

Platform name

Minimum string length: 1
Example:

"instagram"

username
string
required

Username on the platform

Required string length: 1 - 50
Example:

"fitness_coach_jane"

Response

Successful response

data
object
required

Full profile details

warning
string

Present when partial results were returned because profile metrics/data were skipped due to integrity issues.