Skip to content
Task

List Tasks

Retrieve a paginated list of tasks for a specific squid

The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
GEThttps://api.lobstr.io/v1/tasks

This 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

Authorizationstringheaderrequired

Your 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_resultsinteger

Total number of tasks. Example: 2

limitinteger

Maximum results per page. Example: 50

pageinteger

Current page number. Example: 1

total_pagesinteger

Total number of pages. Example: 1

dataarray

Array of task objects. Example: [...]

data[].idstring

Unique task identifier. Example: "6b9d3afdf4e76df374915a50d7a495c4"

data[].created_atstring

Task creation timestamp. Example: "2025-03-05T09:24:49.581177"

data[].is_activeboolean

Whether the task is active. Example: true

data[].paramsobject

Task parameters. Example: {"url": "..."}

nextstring | null

URL for next page (null if last page). Example: null

previousstring | null

URL 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

200
{
  "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
}