Get Profile by Platform and Username

Retrieve detailed profile data including metrics, growth statistics, and activity information from our database.

Response includes:

• Basic info (bio, avatar, verification status)
• Performance metrics (followers, engagement rate, avg likes/comments)
• Growth data (30-day follower growth, monthly rate)
• Activity data (last post date, posting frequency)

Also callable as the get_profile MCP tool — see the MCP server guide for setup.

Pricing: 0.1 credits per request ($0.001)

GET /v1/profiles/{platform}/{username}

cURL

cURL

curl --request GET \
  --url https://api.influship.com/v1/profiles/{platform}/{username} \
  --header 'X-API-Key: <api-key>'

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);

import os
from influship import Influship

client = Influship(
    api_key=os.environ.get("INFLUSHIP_API_KEY"),  # This is the default and can be omitted
)
profile = client.profiles.get(
    username="fitness_coach_jane",
    platform="instagram",
)
print(profile.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"
  },
  "warning": "<string>"
}

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

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

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

200

application/json

Successful response

data · object · required

Full profile details

Show child attributes

warning · string

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