# Create Batch Enrichment

Create a batch enrichment job by uploading a CSV.

How it works
1. Upload a .csv file (one column: handle or email)
2. Choose the enrichment mode (handle: raw/full, email: basic/advanced)
3. Use the returned batch_id to check status and download results

Request
- multipart/form-data
- file: CSV (max 10MB)
- Mode fields depend on whether you’re enriching by handle or email

Credits
- Credits are deducted per successfully enriched record
- The credit rate follows the corresponding single-enrichment mode (raw/full/basic/advanced)
- If no data is returned for a record, 0 credits are deducted for that record

Checking completion
Poll GET /public/v1/enrichment/batch/{batch_id}/status/ every 30–60 seconds until the job finishes. Status values:
- queued — waiting to start
- processing — actively enriching records
- finished — all records done; download results via GET /public/v1/enrichment/batch/{batch_id}/
- failed — job failed
- paused_insufficient_credits — top up credits and call the resume endpoint

This API is polling-based. There are no webhooks or push notifications.

Endpoint: POST /public/v1/enrichment/batch/
Version: 1.0.0
Security: Bearer

## Request fields (multipart/form-data):

  - `file` (string, required)
    CSV file containing creators to enrich (max 10MB, single column: handle or email)

  - `platform` (string)
    Enum: "instagram", "youtube", "tiktok", "twitter", "twitch", "onlyfans"

  - `enrichment_mode` (string, required)
    Enum: "raw", "full", "basic", "advanced"

  - `metadata` (object,null)
    Optional metadata as JSON object (e.g., {"campaign": "Q4 Outreach"})

  - `email_required` (string)
    Enum: "must_have", "preferred"

  - `include_lookalikes` (boolean)
    Include lookalike creators for handle-based full enrichment. Default: false

  - `include_audience_data` (boolean)
    Include audience data for handle-based full enrichment. Default: true

  - `exclude_platforms` (string)
    Enum: "instagram", "youtube", "tiktok", "twitter", "twitch", "onlyfans"

  - `min_followers` (integer)

## Response 200 fields (application/json):

  - `batch_id` (string, required)
    Unique identifier for the batch enrichment job

  - `status` (string, required)
    Current status of the batch job (processing, finished, failed, validating)

  - `created_at` (string, required)
    Timestamp when the batch was created

  - `platform` (string,null)
    Platform used for enrichment (for handle-based enrichment)

  - `metadata` (object,null)
    Metadata provided with the batch

  - `og_input_number` (integer, required)
    Total number of records in the input file

  - `type_report` (string, required)
    Type of enrichment: ENRICH_BY_HANDLE or ENRICH_BY_EMAIL

  - `enrichment_mode` (string,null)
    Enrichment mode: raw, full, basic, or advanced

  - `message` (string, required)
    Human-readable message about the batch status


## Response 400 fields

## Response 401 fields

## Response 422 fields