Creator Discovery Workflow

// Fetch a Twitch creator profile
const profile = await fetch(
  '/platforms/twitch/profiles/484563826',
  {
    headers: { 'x-api-key': 'YOUR_API_KEY' }
  }
).then(r => r.json());

console.log(profile.payload.display_name); // "Streamer 123"
console.log(profile.payload.statistics.followers); // 120000

{
  "payload": {
    "platform_id": "twitch",
    "id": "484563826",
    "name": "streamer123",
    "display_name": "Streamer 123",
    "url": "https://twitch.tv/streamer123",
    "description": "Twitch streamer",
    "profile_image": "https://...",
    "banner_image": "https://...",
    "language": "en",
    "statistics": {
      "followers": 120000,
      "views_estimated": 4500000
    },
    "is_partner": false,
    "is_affiliate": true,
    "is_mature": false,
    "updated_at": "2024-07-04T12:00:00.000Z",
    "last_active_at": "2024-07-04T10:00:00.000Z"
  }
}

// List content by creator
const content = await fetch(
  '/platforms/twitch/profiles/484563826/content?limit=10',
  {
    headers: { 'x-api-key': 'YOUR_API_KEY' }
  }
).then(r => r.json());

content.payload.forEach(item => {
  console.log(`${item.title}: ${item.statistics.views?.sum || 0} views`);
});

{
  "id": "987654321",
  "title": "Awesome Stream",
  "type": "stream",
  "statistics": {
    "viewers": {
      "avg": 2345.6,
      "max": 6789
    },
    "watched_minutes": {
      "sum": 123456
    },
    "views": {
      "sum": 45678
    },
    "comments": {
      "sum": 900
    }
  }
}

const analysis = await fetch(
  '/platforms/twitch/profiles/484563826/analysis',
  {
    headers: { 'x-api-key': 'YOUR_API_KEY' }
  }
).then(r => r.json());

// AI-enriched data
console.log(analysis.payload.age_range); // "25-34"
console.log(analysis.payload.primary_language); // "es"
console.log(analysis.payload.interests); // Array of interests

const audience = await fetch(
  '/platforms/twitch/profiles/484563826/audience',
  {
    headers: { 'x-api-key': 'YOUR_API_KEY' }
  }
).then(r => r.json());

// Demographics
console.log(audience.payload.gender_distribution);
console.log(audience.payload.age_ranges);
console.log(audience.payload.countries);

// Brand safety
console.log(audience.payload.brand_safety.overall_risk_level);
console.log(audience.payload.community_health);

const socials = await fetch(
  '/platforms/twitch/profiles/484563826/socials',
  {
    headers: { 'x-api-key': 'YOUR_API_KEY' }
  }
).then(r => r.json());

// Find creator on other platforms
const socialProfiles = socials.payload;
socialProfiles.forEach(profile => {
  console.log(`${profile.platform_id}: ${profile.id} (${profile.followers} followers)`);
});

async function analyzeCreator(platform, profileId) {
  // 1. Get profile
  const profile = await fetchProfile(platform, profileId);

  // 2. Get recent content
  const content = await fetchContent(platform, profileId, 10);

  // 3. Calculate content metrics
  const totalViews = content.payload.reduce(
    (sum, item) => sum + (item.statistics?.views?.sum || 0),
    0
  );

  // 4. Get advanced insights (if needed)
  const advanced = await fetchAdvanced(platform, profileId);

  // 5. Get audience analysis (if needed)
  const audience = await fetchAudience(platform, profileId);

  return {
    profile: profile.payload,
    contentStats: {
      totalItems: content.payload.length,
      totalViews
    },
    insights: advanced.payload.analysis,
    audience: audience.payload
  };
}

// Find creators matching brand criteria
async function findBrandPartners(criteria) {
  // 1. Search or filter creators
  // 2. Fetch profiles
  // 3. Get audience analysis
  // 4. Check brand safety metrics
  // 5. Evaluate community health
}

// Analyze creator's content performance
async function analyzeContentPerformance(platform, profileId) {
  // 1. Fetch all content (paginate)
  // 2. Calculate average views
  // 3. Identify top-performing content
  // 4. Analyze trends over time
}

// Find creators with presence on multiple platforms
async function findMultiPlatformCreators(twitchProfileId) {
  // 1. Get advanced insights
  // 2. Extract social profiles
  // 3. Fetch profiles from other platforms
  // 4. Compare metrics across platforms
}