GET/v1/results

Get Results

Retrieve scraped data from a squid or specific run

This endpoint retrieves a paginated list of results (scraped data) produced by a squid. You can query results for an entire squid or filter to a specific run and/or task.

Important: You must supply either the squid hash OR a specific run hash — not both.

Headers

KeyValueRequired
AuthorizationToken YOUR_API_KEYYes

Query Parameters

squid
Type:
string
Required:
One of*
Description:
Hash of the squid. Returns all results across all runs if `run` is omitted
run
Type:
string
Required:
One of*
Description:
Hash of the run. Returns results from that single execution only
task
Type:
string
Required:
No
Description:
Hash of a specific task. Filters results to just that task
page
Type:
integer
Required:
No
Description:
Page number to fetch (1-indexed). Default: 1
page_size
Type:
integer
Required:
No
Description:
Number of results per page. Default: 50, Max: 100

Response Field Explanations

total_results
integer
Total number of result records available
Example: 156
limit
integer
The page_size requested (or default)
Example: 50
page
integer
Current page number
Example: 1
total_pages
integer
Total number of pages available
Example: 4
result_from
integer
1-based index of the first record in this page
Example: 1
result_to
integer
1-based index of the last record in this page
Example: 50
next
stringnull
Full URL to fetch the next page (null if last page)
Example: https://api.lobstr.io/v1/results?squid=...&page=2
previous
stringnull
Full URL to fetch the previous page (null if first page)
Example: null
data
array
Array of result objects. Schema varies by crawler type
Example: [...]
data[].id
string
Unique result identifier
Example: b4af52b85c45661828d61980c167054b
data[].object
string
Always "result"
Example: result
data[].squid
string
Squid that produced this result
Example: b6c56d18cb0046949461ba9ca278e8ad
data[].run
string
Run that produced this result
Example: 300e9c5c127d421c90f431478d9a2cfb
data[].scraping_time
string
When this result was scraped (ISO 8601)
Example: 2025-02-10T14:31:05.487Z
Pro Tip

Pro Tip

Use the `next` URL to automatically paginate through all results until it returns null.
Note

Note

Result schemas vary by crawler. The fields returned depend on what data the crawler extracts.
Warning

Warning

You must provide either `squid` OR `run` — providing both or neither will result in an error.
Pro Tip

Pro Tip

For large result sets, increase page_size to 100 to reduce the number of API calls needed.