Skip to main content
GET
/
v1
/
results
Get Results
curl --request GET \
  --url https://api.lobstr.io/v1/results \
  --header 'Authorization: <authorization>'
{
  "total_results": 123,
  "limit": 123,
  "page": 123,
  "total_pages": 123,
  "result_from": 123,
  "result_to": 123,
  "next": {},
  "previous": {},
  "data": [
    {}
  ],
  "data[].id": "<string>",
  "data[].object": "<string>",
  "data[].squid": "<string>",
  "data[].run": "<string>",
  "data[].scraping_time": "<string>"
}
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

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

​
Query Parameters

ParameterTypeRequiredDescription
squidstringOne of*Hash of the squid. Returns all results across all runs if run is omitted
runstringOne of*Hash of the run. Returns results from that single execution only
taskstringNoHash of a specific task. Filters results to just that task
pageintegerNoPage number to fetch (1-indexed). Default: 1
limitintegerNoNumber of results per page. Default: 50, Max: 100

​
Response Field Explanations

​
total_results
integer
Total number of result records available. Example: 156
​
limit
integer
Number of results per page (matches the limit param). 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
string | null
Full URL to fetch the next page (null if last page). Example: "https://api.lobstr.io/v1/results?squid=...&page=2"
​
previous
string | null
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"

​
Result Data Schema

The fields within each result object depend on the crawler used. For example, a Google Maps crawler returns fields like name, address, phone, website, ratings, score, etc., while a LinkedIn crawler returns different fields. Use the Get Crawler Details endpoint to understand what fields your specific crawler returns.
Use the next URL to automatically paginate through all results until it returns null.
Result schemas vary by crawler. The fields returned depend on what data the crawler extracts.
You must provide either squid OR run — providing both or neither will result in an error.
For large result sets, increase limit to 100 to reduce the number of API calls needed.

​
Code Examples

curl -X GET "https://api.lobstr.io/v1/results?squid=b6c56d18cb0046949461ba9ca278e8ad&page=1&limit=50" \
  -H "Authorization: Token YOUR_API_KEY"

​
Response

200
{
  "total_results": 156,
  "limit": 50,
  "page": 1,
  "total_pages": 4,
  "result_from": 1,
  "result_to": 50,
  "data": [
    {
      "id": "b4af52b85c45661828d61980c167054b",
      "object": "result",
      "squid": "b6c56d18cb0046949461ba9ca278e8ad",
      "run": "300e9c5c127d421c90f431478d9a2cfb",
      "name": "1860 Le Palais",
      "address": "9 La Canebière Vieux Port, 13001 Marseille, France",
      "phone": "+33491995484",
      "website": "https://www.1860lepalais.fr/",
      "category": "French restaurant, Brunch restaurant, Mediterranean restaurant",
      "score": 4.4,
      "ratings": 1220,
      "lat": 43.2960548,
      "lng": 5.3751573,
      "city": "Marseille",
      "country": "France",
      "zip_code": "13001",
      "opening_hours": "Monday 9 AM–10:30 PM, Tuesday 9 AM–10:30 PM...",
      "scraping_time": "2025-02-10T14:31:05.487Z"
    },
    {
      "id": "ec2348622e01fa0ed43e7c73b43665a1",
      "object": "result",
      "squid": "b6c56d18cb0046949461ba9ca278e8ad",
      "run": "300e9c5c127d421c90f431478d9a2cfb",
      "name": "Wood la cantine gourmande",
      "address": "8 Rue de la Guirlande, 13002 Marseille, France",
      "phone": "+33491919342",
      "website": "https://woodlacantinegourmande.fr/",
      "category": "French restaurant, Mediterranean restaurant",
      "score": 4.7,
      "ratings": 726,
      "lat": 43.296790699999995,
      "lng": 5.3704969,
      "city": "Marseille",
      "country": "France",
      "zip_code": "13002",
      "scraping_time": "2025-02-10T14:31:06.104Z"
    }
  ],
  "next": "https://api.lobstr.io/v1/results?squid=b6c56d18cb0046949461ba9ca278e8ad&page=2&limit=50",
  "previous": null
}
400
{
  "error": {
    "message": "You must provide either 'squid' or 'run' parameter, not both or neither",
    "type": "validation_error",
    "param": "squid,run"
  }
}