Skip to main content
GET
/
v1
/
creators
/
{id}
JavaScript
import Influship from 'influship';

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

const creator = await client.creators.retrieve('123e4567-e89b-12d3-a456-426614174000', {
  include: ['profiles'],
});

console.log(creator.data);
{
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Jane Fitness",
    "bio": "Fitness coach & wellness advocate",
    "avatar_url": "https://cdn.example.com/avatars/jane.jpg",
    "ai_summary": "A fitness influencer focused on home workouts and healthy eating",
    "content_themes": [
      "fitness",
      "nutrition",
      "wellness"
    ],
    "profiles": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "platform": "instagram",
        "username": "fitness_coach_jane",
        "url": "https://www.instagram.com/fitness_coach_jane",
        "followers": 125000,
        "engagement_rate": 3.5,
        "is_verified": true
      }
    ]
  },
  "warning": "<string>"
}

Authorizations

X-API-Key
string
header
required

Path Parameters

id
string<uuid>
required

Creator unique identifier

Example:

"123e4567-e89b-12d3-a456-426614174000"

Query Parameters

include
enum<string>[]
required

Additional data to include in response

Available options:
profiles
Example:
["profiles"]

Response

Successful response

data
object
required

Full creator details

warning
string

Present when partial results were returned because one or more linked profiles were skipped for data integrity reasons.