Skip to content
Examples

Get Results

Retrieve scraped data from Google Search Scraper

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/results

Retrieve scraped data from your Google Search Scraper runs.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

squidstringqueryrequired

Hash of the squid to get results from

runstringquery

Hash of a specific run (optional)

pageintegerquery

Page number (default: 1). Example: 1

Result Fields

Each result object contains the following fields:

titlestring

Title of the search result page. Example: Coffee

urlstring

URL of the search result. Example: https://en.wikipedia.org/wiki/Coffee

displayed_urlstring

URL as displayed in the Google search result (may differ from actual URL). Example: https://en.wikipedia.org › wiki › Coffee

descriptionstring

Meta description or snippet shown in the Google search result. Example: Coffee is a beverage brewed from roasted, ground coffee beans. Darkly colored, bitter, and slightly acidic, coffee has a stimulating effect on humans, primarily ...

snippet_segmentsjson

Individual text segments of the Google search snippet

questionstring

Question text from a People Also Ask entry. Example: What is the 15-15-15 coffee rule?

answerstring

Answer text from a People Also Ask entry

is_question_answerboolean

Whether this result is a People Also Ask (Q&A) entry. Example: false

is_related_queryboolean

Whether this result is a related search query suggestion. Example: false

is_organicboolean

Whether this is an unpaid organic search result. Example: true

is_paidboolean

Whether this is a paid advertisement in Google search results. Example: false

total_resultsstring

Total number of search results Google reports for the query. Example: 3190000000

datedate

Publication or indexing date shown in the Google search result

emphasized_keywordsstring

Keywords Google highlights in the search snippet. Example: coffee

pageinteger

Search results page number (1 = first page of results). Example: 1

Collect Shopping Results

is_shoppingboolean

true on a shopping row, false on an organic row. Only populated when collect_shopping_results is on.

sellerstring

Shopping seller / merchant name. Only populated on shopping rows. Example: Amazon.com

pricestring

Shopping price as shown by Google (with currency symbol). Only populated on shopping rows. Example: $29.99

price_amountfloat

Shopping price as a number. Only populated on shopping rows. Example: 29.99

currencystring

Shopping price currency code. Only populated on shopping rows. Example: USD

ratingfloat

Shopping product rating out of 5. Only populated on shopping rows when Google shows one. Example: 4.5

rating_countinteger

Shopping product rating count. Only populated on shopping rows when Google shows one. Example: 2314

image_urlstring

Shopping product image URL. Only populated on shopping rows.

product_idstring

Google's own identifier for the shopping product. Only populated on shopping rows.

Response

200
{
  "total_results": 1,
  "limit": 50,
  "page": 1,
  "total_pages": 1,
  "result_from": 1,
  "result_to": 1,
  "data": [
    {
      "id": 77331,
      "object": "result",
      "squid": "f6bcb5d88a53ddd90e0ea0944f0433ae",
      "run": "bbdefdfc8d2f9c05bcbdd805c24c6cf6",
      "title": "Coffee",
      "url": "https://en.wikipedia.org/wiki/Coffee",
      "displayed_url": "https://en.wikipedia.org › wiki › Coffee",
      "description": "Coffee is a beverage brewed from roasted, ground coffee beans. Darkly colored, bitter, and slightly acidic, coffee has a stimulating effect on humans, primarily ...",
      "snippet_segments": null,
      "question": "What is the 15-15-15 coffee rule?",
      "answer": null,
      "is_question_answer": false,
      "is_related_query": false,
      "is_organic": true,
      "is_paid": false,
      "total_results": "3190000000",
      "date": null,
      "emphasized_keywords": "coffee",
      "page": 1,
      "functions": null,
      "native_id": 77331
    }
  ],
  "next": null,
  "previous": null
}