Skip to main content
GET
Download Run
This endpoint generates a temporary download URL for the results of a specific run. The URL provides direct access to the exported data file.

Headers

string
required
Your API authentication token. Value: Token YOUR_API_KEY

Path Parameters

string
required
The unique identifier (hash) of the run to download. Example: 300e9c5c127d421c90f431478d9a2cfb

Query Parameters

string
Export file format. One of csv, xlsx, json, jsonl. Defaults to csv — omit this parameter to get CSV.
string
Comma-separated list of result columns to include, e.g. fields=name,url,email. Omit to include all columns.
string
Comma-separated list of result columns to exclude, e.g. omit=raw_html. Ignored if fields is also set.

Response Field Explanations

string
Temporary signed URL to download the results file, in the requested file_format. Example: "https://s3.eu-west-1.amazonaws.com/api.lobstr.io/temporary/..."
Download URLs are temporary and expire after a short period. Generate a new URL if the link expires.
The run must have export_done: true before a download URL can be generated.
For automated workflows, consider using delivery configurations (Email, S3, SFTP, Webhook) instead of manual downloads.
Results are exported in CSV format by default. Pass file_format to get XLSX, JSON, or JSONL (newline-delimited JSON) instead.

Code Examples

Response

200
404