Get Run Stats
Retrieve detailed statistics about a specific run
https://api.lobstr.io/v1/runs/{run_hash}/statsThis endpoint retrieves detailed real-time statistics about a specific run, including progress information, estimated time remaining, and task completion status.
Headers
AuthorizationstringheaderrequiredYour API authentication token. Value: Token YOUR_API_KEY
Path Parameters
run_hashstringpathrequiredThe unique identifier (hash) of the run. Example: 300e9c5c127d421c90f431478d9a2cfb
Response Field Explanations
idstringThe run's unique identifier. Example: "300e9c5c127d421c90f431478d9a2cfb"
objectstringAlways "run". Example: "run"
durationstringHuman-readable duration (HH:MM:SS format). Example: "0:00:15.175532"
started_atstringWhen the run started. Example: "2025-02-10T14:30:55"
ended_atstring | nullWhen the run ended (null if still running). Example: "2025-02-10T14:31:10"
is_donebooleanWhether the run has completed. Example: true
percent_donestringCompletion percentage. Example: "100%"
etastringEstimated time remaining ("∞" if unknown). Example: "∞"
total_tasksintegerTotal number of tasks in the run. Example: 10
total_tasks_doneintegerNumber of tasks completed. Example: 10
total_tasks_leftintegerNumber of tasks remaining. Example: 0
total_resultsintegerTotal results collected in this run. Example: 6
results_totalintegerExpected total results (if known). Example: 138
results_doneintegerResults collected so far. Example: 6
current_taskstringCurrently executing task (empty if none). Example: ""
updated_atstringLast update timestamp. Example: "2025-02-10T14:31:10"
Poll this endpoint periodically to display real-time progress in your application.
The eta field provides an estimate but may show "∞" for runs with unpredictable completion times.
Use percent_done for progress bars and total_tasks_left to show remaining work.
Code Examples
curl -X GET "https://api.lobstr.io/v1/runs/300e9c5c127d421c90f431478d9a2cfb/stats" \ -H "Authorization: Token YOUR_API_KEY"
Response
{ "id": "300e9c5c127d421c90f431478d9a2cfb", "object": "run", "duration": "0:00:15.175532", "ended_at": "2025-02-10T14:31:10", "eta": "∞", "is_done": true, "percent_done": "100%", "started_at": "2025-02-10T14:30:55", "total_requests": null, "total_results": 6, "total_tasks": 10, "total_tasks_done": 10, "total_tasks_left": 0, "current_task": "", "results_total": 138, "results_done": 6, "updated_at": "2025-02-10T14:31:10" }
{ "error": { "message": "Run not found", "type": "not_found_error", "param": "run_hash" } }