Sign in

v1

latestOpenAPI 3.0.32026-08-0670174396.8 KB
Batch enrichment

Download Batch Enrichment Results (Direct)

Download the final enriched dataset after processing is complete.

Tip: For CSV downloads, consider using the recommended endpoint GET /public/v1/enrichment/batch/{batch_id}/download/ instead — it returns a presigned URL for faster, more reliable downloads. Use this endpoint if you need JSON output or as a fallback.

Requirements

  • Batch must be in finished status
  • Results file must have been generated

Output formats

  • CSV (default) — omit format or pass ?format=csv
  • JSON — pass ?format=json to receive a JSON array where each object has:   - input_value — the original input (handle or email)   - status — enrichment status for that record   - enrichment_data — the enriched creator data

Error Responses

  • 400 Bad Request — batch not completed yet or no results file available
  • 404 Not Found — invalid batch ID or batch does not belong to client

Credits

  • 0 credits (download only)
<div class="ic-ai-prompt-root" data-endpoint="batch-download"></div>
get/public/v1/enrichment/batch/{batch_id}/

Path parameters

batch_idstring required

Unique batch identifier returned when creating the enrichment batch

Query parameters

format'csv' | 'json'

Output format. Omit or pass csv (default) to receive a CSV file. Pass json to receive a JSON array of objects with input_value, status, and enrichment_data fields.

Response

CSV or JSON file with enriched results depending on the format query parameter.

input_valuestring
statusstring
enrichment_dataobject