List Tasks
Retrieve a paginated list of tasks for a specific squid
https://api.lobstr.io/v1/tasksThis endpoint retrieves a paginated list of tasks for a specific squid. You can choose between two query types to get different levels of detail.
Headers
AuthorizationstringheaderrequiredYour API authentication token. Value: Token YOUR_API_KEY
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| squid | string | Yes | The squid hash ID to list tasks for |
| type | string | No | Filters by how the task was submitted, not a detail level: 'url' returns only tasks created with a url field; 'params' returns only tasks created with structured parameters instead (e.g. Google Maps Leads Scraper's city/category/country mode). These are mutually exclusive result sets. Omit type to get all tasks regardless of shape. For crawlers that only ever accept a url (most of them), type=params will always return an empty list — that's expected, not a bug. |
| page | integer | No | Page number for pagination. Default: 1 |
| limit | integer | No | Results per page. Default: 50, Max: 100 |
Response Field Explanations
total_resultsintegerTotal number of tasks. Example: 2
limitintegerMaximum results per page. Example: 50
pageintegerCurrent page number. Example: 1
total_pagesintegerTotal number of pages. Example: 1
dataarrayArray of task objects. Example: [...]
data[].idstringUnique task identifier. Example: "6b9d3afdf4e76df374915a50d7a495c4"
data[].created_atstringTask creation timestamp. Example: "2025-03-05T09:24:49.581177"
data[].is_activebooleanWhether the task is active. Example: true
data[].paramsobjectTask parameters. Example: {"url": "..."}
nextstring | nullURL for next page (null if last page). Example: null
previousstring | nullURL for previous page (null if first page). Example: null
Omit type unless you specifically need to isolate one task shape — most squids only ever use one or the other, so filtering by type on a URL-only crawler will just return nothing.
Results are paginated. Use the next and previous URLs to navigate through large task lists.
Check is_active to identify tasks that are ready to run vs. disabled tasks.
Code Examples
curl -X GET "https://api.lobstr.io/v1/tasks?squid=a1b2c3d4e5f6g7h8i9j0&type=params&page=1&limit=50" \ -H "Authorization: Token YOUR_API_KEY"
Response
{ "total_results": 2, "limit": 50, "page": 1, "total_pages": 1, "data": [ { "id": "6b9d3afdf4e76df374915a50d7a495c4", "created_at": "2025-03-05T09:24:49.581177", "is_active": true, "params": { "url": "https://www.linkedin.com/in/johndoe" } }, { "id": "c5e29d2aba8b77cdc56391e7405302de", "created_at": "2025-03-05T09:24:49.581177", "is_active": true, "params": { "url": "https://www.linkedin.com/in/janedoe" } } ], "next": null, "previous": null }