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)

{
  "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",
    "analysis_updated_at": "2026-07-20T12:00:00.000+00:00",
    "analysis_fact_count": 12,
    "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,
        "data_updated_at": "2026-07-20T12:00:00.000+00:00"
      }
    ]
  },
  "warning": "<string>"
}

{
  "error": {
    "code": "validation_error",
    "message": "Invalid value for parameter 'limit': must be between 1 and 100",
    "param": "limit",
    "request_id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "API key missing or invalid",
    "request_id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

{
  "error": {
    "code": "payment_required",
    "message": "Payment authentication is required.",
    "status_code": 402,
    "reason_code": "PAYMENT_ACTION_REQUIRED",
    "next_step": "complete_authentication",
    "request_id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

{
  "error": {
    "code": "forbidden",
    "message": "Your plan does not include access to this endpoint",
    "request_id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

{
  "error": {
    "code": "not_found",
    "message": "Creator with ID '123e4567-e89b-12d3-a456-426614174000' not found",
    "request_id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded (per minute)",
    "request_id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "An unexpected error occurred. Please try again later.",
    "request_id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

{
  "error": {
    "code": "service_unavailable",
    "message": "Live Instagram data is temporarily unavailable. Please retry shortly.",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {
      "retry_after_seconds": 60,
      "upstream_error": "upstream_rate_limited"
    }
  }
}