Skip to main content
GET
/
v1
/
creators
import InflushipAPI from 'influship';

const client = new InflushipAPI({
  apiKey: 'My API Key',
});

const creator = await client.creators.retrieve({ creator_ids: 'creator_ids' });

console.log(creator.creators);
{
  "creators": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "Sarah Fitness",
      "bio": "Certified personal trainer and wellness coach",
      "avatar": "https://cdn.influship.com/avatars/sarah.jpg",
      "profiles": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "creator_profile_id": "123e4567-e89b-12d3-a456-426614174000",
          "platform": "instagram",
          "username": "sarah_fitness",
          "display_name": "Sarah | Fitness Coach",
          "bio": "Transform your body in 12 weeks 💪",
          "follower_count": 125000,
          "engagement_rate": 4.2,
          "verified": true,
          "avatar_url": "https://cdn.influship.com/avatars/sarah_ig.jpg",
          "external_url": "https://sarahfitness.com"
        },
        {
          "id": "987fcdeb-51a2-43d1-9f12-345678901234",
          "creator_profile_id": "123e4567-e89b-12d3-a456-426614174000",
          "platform": "tiktok",
          "username": "sarahfitness",
          "display_name": "Sarah Fitness",
          "bio": "Fitness tips & workouts 🔥",
          "follower_count": 89000,
          "engagement_rate": 6.8,
          "verified": false,
          "avatar_url": "https://cdn.influship.com/avatars/sarah_tt.jpg",
          "external_url": null
        }
      ]
    }
  ]
}

Authorizations

​
X-API-Key
string
header
required

API key for authentication

Query Parameters

​
creator_ids
string
required

Comma-separated list of creator UUIDs

​
include_profiles
boolean
default:false

Whether to include social account profiles for each creator

​
profile_mode
enum<string>
default:lite

Detail level for included profiles (only used when include_profiles=true)

Available options:
lite,
detailed
​
profile_platforms
string

Comma-separated list of platforms to include (instagram, tiktok). Only used when include_profiles=true

Response

Creator profile information

​
creators
object[]

Creator with embedded social account profiles Basic creator information

  • Option 1
  • Option 2