Skip to content
/
Download Batch Enrichment...

Download Batch Enrichment CSV (Recommended)

Request

Download the enriched CSV dataset via a temporary presigned URL. This is the recommended endpoint for downloading CSV results.

Compared to the direct download endpoint, this returns a short-lived URL that lets you download the file directly from storage — faster and more reliable for large files.

Requirements

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

Output format

  • CSV only — for JSON output, use the direct download endpoint (GET /public/v1/enrichment/batch/{batch_id}/) with ?format=json

Response

  • download_url — temporary URL (valid for a limited time)
  • expires_in — seconds until the URL expires
  • expires_at — expiration timestamp

Error Responses

Every error response shares the canonical shape {"error": <message>, "error_code": <slug>, ...}. Branch programmatically on error_code rather than parsing error.

  • 400 Bad Request (error_code: "batch_not_ready") — batch not completed yet; current_status is included in the body
  • 400 Bad Request (error_code: "no_results") — batch finished but produced no rows
  • 400 Bad Request (error_code: "results_not_ready") — batch finished but the results file is still being assembled
  • 404 Not Found (error_code: "batch_not_found") — invalid batch ID or batch does not belong to client
  • 503 Service Unavailable (error_code: "feature_disabled") — presigned-URL downloads are currently disabled; use the direct download endpoint

Credits

  • 0 credits (download only)
Security
Bearer
Path
batch_idstringrequired

Unique batch identifier returned when creating the enrichment batch

GET
/public/v1/enrichment/batch/{batch_id}/download/
curl -i -X GET \
  'https://api-dashboard.influencers.club/public/v1/enrichment/batch/{batch_id}/download/' \
  -H 'Authorization: Bearer <YOUR_API_KEY_HERE>'

Responses

Bodyapplication/json
download_urlstring, (uri)required

Temporary presigned S3 download URL

filenamestringrequired

Suggested filename for the download

expires_inintegerrequired

URL expiration time in seconds

expires_atstringrequired

ISO 8601 timestamp when the URL expires

batch_idstringrequired

Unique identifier for the batch enrichment job

total_resultsintegerrequired

Number of enriched results in the file

invalid_recordsintegerrequired

Number of invalid records in the batch

Response
{
  "download_url": "http://example.com",
  "filename": "string",
  "expires_in": 0,
  "expires_at": "string",
  "batch_id": "string",
  "total_results": 0,
  "invalid_records": 0
}