Skip to main content
GET
/
v1
/
runs
/
{run_hash}
/
stats
Get Run Stats
curl --request GET \
  --url https://api.lobstr.io/v1/runs/{run_hash}/stats \
  --header 'Authorization: <authorization>'
{
  "id": "<string>",
  "object": "<string>",
  "duration": "<string>",
  "started_at": "<string>",
  "ended_at": {},
  "is_done": true,
  "percent_done": "<string>",
  "eta": "<string>",
  "total_tasks": 123,
  "total_tasks_done": 123,
  "total_tasks_left": 123,
  "total_results": 123,
  "results_total": 123,
  "results_done": 123,
  "current_task": "<string>",
  "updated_at": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.lobstr.io/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint retrieves detailed real-time statistics about a specific run, including progress information, estimated time remaining, and task completion status.

​
Headers

​
Authorization
string
required
Your API authentication token. Value: Token YOUR_API_KEY

​
Query Parameters

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

​
Response Field Explanations

​
id
string
The run’s unique identifier. Example: "300e9c5c127d421c90f431478d9a2cfb"
​
object
string
Always “run”. Example: "run"
​
duration
string
Human-readable duration (HH:MM:SS format). Example: "0:00:15.175532"
​
started_at
string
When the run started. Example: "2025-02-10T14:30:55"
​
ended_at
string | null
When the run ended (null if still running). Example: "2025-02-10T14:31:10"
​
is_done
boolean
Whether the run has completed. Example: true
​
percent_done
string
Completion percentage. Example: "100%"
​
eta
string
Estimated time remaining (”∞” if unknown). Example: "∞"
​
total_tasks
integer
Total number of tasks in the run. Example: 10
​
total_tasks_done
integer
Number of tasks completed. Example: 10
​
total_tasks_left
integer
Number of tasks remaining. Example: 0
​
total_results
integer
Total results collected in this run. Example: 6
​
results_total
integer
Expected total results (if known). Example: 138
​
results_done
integer
Results collected so far. Example: 6
​
current_task
string
Currently executing task (empty if none). Example: ""
​
updated_at
string
Last 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

200
{
  "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"
}
404
{
  "error": {
    "message": "Run not found",
    "type": "not_found_error",
    "param": "run_hash"
  }
}