Trawl API reference

Trawl API · Stats

get/v1/workspaces/{workspace_id}/statsAuth

Trawl stats for a workspace

Total jobs, jobs created / succeeded / failed and steps used in the window, the credit balance, when the latest job was created and a daily jobs series. **Active** means a job was created. Days are UTC. Counts only: no target URLs, descriptions or job results. Cached for up to 60 seconds (`generated_at`).

Path parameters

workspace_id*string · uuid

Workspace id.

Query parameters

windowenum (3)

Window for `in_window` and the length of `series`, in UTC days ending today.

Response · 200 Trawl stats.

window*object

Window the counts cover.

Example: "30d"

generated_at*string · date-time

When these numbers were computed. Responses are cached for up to 60 seconds.

Example: "2026-10-07T09:00:00.000Z"

last_activity_at*string · date-time

When the workspace's most recent job was created. Null when there has never been one.

Example: "2026-10-07T08:41:12.000Z"

totals*object

All-time counts and the credit balance.

in_window*object

Counts for the window.

series*object

Daily jobs.

Example

Request

GET https://api.trawl.productcraft.co/v1/workspaces/{workspace_id}/stats
Authorization: Bearer YOUR_TOKEN

Response

{
  "window": "30d",
  "generated_at": "2026-10-07T09:00:00.000Z",
  "last_activity_at": "2026-10-07T08:41:12.000Z",
  "totals": {},
  "in_window": {},
  "series": {}
}