Get Creator by ID

Retrieve a creator’s profile including AI-generated summary, content themes, and optionally their linked social profiles.

What is a Creator? A creator is a cross-platform entity representing a person or brand. They may have profiles on multiple social networks (Instagram, YouTube, TikTok, etc.) that are linked together.

Include options:

• profiles: Include all linked social profiles with metrics

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

Pricing: 0.1 credits per request ($0.001)

GET /v1/creators/{id}

cURL

cURL

curl --request GET \
  --url https://api.influship.com/v1/creators/{id} \
  --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 creator = await client.creators.retrieve('123e4567-e89b-12d3-a456-426614174000');

console.log(creator.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
)
creator = client.creators.retrieve(
    id="123e4567-e89b-12d3-a456-426614174000",
)
print(creator.data)

200

{
  "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",
    "audience_demographics": "Young adults interested in practical wellness routines and meal prep",
    "brand_alignment": [
      "fitness apparel",
      "nutrition",
      "wellness apps"
    ],
    "content_themes": [
      "fitness",
      "nutrition",
      "wellness"
    ],
    "key_facts": [
      "Runs weekly workout challenges",
      "Often features meal prep content"
    ],
    "vibe_and_aesthetics": "Bright, practical, and encouraging with clean gym and kitchen visuals",
    "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>"
}

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

id · string<uuid> · required

Creator unique identifier

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Example:

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

Query Parameters

include · enum<string>[]

Additional data to include in response

Available options: profiles

Example:

["profiles"]

Response

200

application/json

Successful response

data · object · required

Full creator details

Show child attributes

warning · string

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