---
title: "Bulk ingest creator profiles and videos"
method: POST
path: "/api/creators/bulk-ingest"
tags: ["Creators"]
---

# Bulk ingest creator profiles and videos

`POST /api/creators/bulk-ingest`

## Request

- Base URL: `https://api.kolect.com`
- URL: `https://api.kolect.com/api/creators/bulk-ingest`
- Auth: HTTP bearer

Ingests multiple creators by fetching their profiles and videos from Instagram, TikTok, and YouTube.
- Creates creator_accounts entries for each creator
- Fetches profile data and stores in kols table
- Fetches videos and stores in influencer_videos table
- Uploads avatars and thumbnails to Supabase storage
- Extracts name and email from profile data if not provided
- Supports pagination to fetch more videos per creator

## Request body

- object
  - `creators` object[], required
    - `name` string: Creator's name (optional, extracted from profile if not provided)
    - `email` string, email: Creator's email (optional, extracted from profile if not provided)
    - `instagram_id` string: Instagram username or ID
    - `tiktok_id` string: TikTok username or ID (with or without @)
    - `youtube_id` string: YouTube channel name, handle, or channel ID
    - `max_video_fetch` integer: Maximum number of videos to fetch per creator (default 30)
  - `concurrency` integer: Number of creators to process concurrently (default 3)

## Response `200`

Bulk ingestion completed

- object
  - `success` boolean
  - `processed` integer: Number of creators processed
  - `failed` integer: Number of creators that failed
  - `creators` object[]
    - `creator_id` string: Creator account ID
    - `name` string: Creator name (input or extracted from profile)
    - `email` string: Creator email (input or extracted from profile)
    - `tiktok_kol_id` string: TikTok KOL ID if processed
    - `instagram_kol_id` string: Instagram KOL ID if processed
    - `youtube_kol_id` string: YouTube KOL ID if processed
    - `tiktok_video_ids` string[]: TikTok video IDs
    - `instagram_video_ids` string[]: Instagram video IDs
    - `youtube_video_ids` string[]: YouTube video IDs
    - `platforms` object[]
      - `platform` 'instagram' | 'tiktok' | 'youtube'
      - `kol_id` string
      - `video_ids` string[]
      - `profile_name` string
      - `profile_username` string
      - `followers_count` integer
      - `videos_processed` integer
    - `success` boolean
    - `error` string
  - `stats` object
    - `total` integer
    - `successful` integer
    - `failed` integer
    - `platforms` object: Count of each platform processed
    - `processing_time_ms` integer

## Other responses

- `400`: Invalid request data
- `500`: Internal server error

---

[API](https://skmtc.dev/kolect/apis/kolect-api.md) · [All operations](https://skmtc.dev/kolect/apis/kolect-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kolect/apis/kolect-api/revisions/fe54528e8f54?raw)