Introduction to Google Shopping Scraper

The Google Shopping API provides programmatic access to Google Shopping search results through a unified endpoint. It enables you to retrieve structured product listings, pricing, merchants, filters, and pagination data using our SERP-API.

This API is designed for ecommerce intelligence, price comparison, product discovery, and market research, supporting advanced filtering, sorting, localization, and merchant-level data retrieval.

Authentication​

To access the SERP API, you must provide basic authentication credentials using the username and password provided by NetNut. Include these credentials in the HTTP request headers as follows:

Authorization: Basic base64(username:password)

Where base64(username:password) is the Base64-encoded string of your username and password concatenated with a colon (:) separator.

Environments​

• Base URL: https://serp-api.netnut.io

• Endpoint: /search&udm=28

API Parameters & Specifications​

Search Query​

Name	Status	Description
q	Required	The 'q' parameter defines the query you want to search for. You can use any string that you would use in a regular Google search (e.g., inurl:, site:, intitle:).

Pagination​

Name	Status	Description
start	Optional	The start parameter controls the result offset used for pagination. It specifies how many results to skip before returning data. For example, start=0 (default) returns the first page, start=10 returns the second page, start=20 returns the third page, and so on. The parameter supports increments of 10 only.

Geographic Location​

Name	Status	Description
uule	Optional	The 'uule' parameter is the Google encoded location you want to use for performing the Google search. Click here to generate a UULE

Localization​

Name	Status	Description
googleDomain	Optional	The googleDomain parameter defines the Google domain to use for the Google search. The default is www.google.com. Please ensure you add "www" before the domain name.
gl	Optional	The gl parameter defines the country to use for the Google search. It is a two-letter country code. For example - use us for the United States, uk for United Kingdom, etc.
hl	Optional	The hl parameter defines the language to use for the Google search. It is a two-letter language code. For example - use en for English, de for German, etc. Access the Google languages page for a full list of supported Google languages.
location	Optional	Similarly to the gl parameter it is another parameter that defines the country to use for the Google search. It is a two-letter country code. For example - use us for the United States, uk for United Kingdom, etc.

Advanced Filters​

Name	Status	Description
rawHtml	Optional	The 'rawHtml' parameter defines the final output you want. It can be set to 1 (true) or 0 (false) to get the raw html response. for receiving html only (without parsing) set it to 2 (only)
shoprs	Optional	This parameter specifies a token containing metadata about the query and applied search filters. When the token is provided, the q parameter may be omitted. This parameter overrides the
safe	Optional	The 'safe' parameter defines the level of filtering for adult content. It can be set to active or off, by default Google blurs explicit content.
filter	Optional	The 'filter' parameter allows defining whether the filters for 'Omitted Results' and 'Similar Results' are enabled or disabled. Setting the parameter to 1 (default) enables these filters, and setting the parameter to 0 disables these filters.
nfpr	Optional	Parameter defines the exclusion of results from an auto-corrected query that is spelled wrong. It can be set to 1 to exclude these results, or 0 to include them (default).
device	Optional	The 'device' parameter defines the device to use to get the Google search results. The parameter can be set to desktop (default) to use a regular browser, tablet to use a tablet browser (currently using iPads), or mobile to use a mobile browser (currently using iPhones).

Google Shopping Specific Filters

Name	Status	Description
shoprs	Optional	This parameter defines a token that encapsulates the query context and applied search filters. When provided, the q parameter may be omitted. The token takes precedence and overrides all other filters listed in this table.
sortBy	Optional	This parameter controls the sorting order of the results. Available values: 1: Price, low to high 2: Price, high to low 3: Ranking, high to low
minPrice	Optional	Specifies the minimum value for the price range filter
maxPrice	Optional	Specifies the maximum value for the price range filter
freeShipping	Optional	Boolean parameter (0/1 Or true/false) that limits the results to products that offer free shipping.
onSale	Optional	Boolean parameter (0/1 Or true/false) that limits the results to products that are on sale.
smallBusiness	Optional	Boolean parameter (0/1 Or true/false) that limits the results to products that are from small businesses.

API Results structure​

{
  "url": "string",
  "general": {
    "searchEngine": "google_shopping",
    "language": "string",
    "device": "string",
    "searchType": "string",
    "pageTitle": "string",
    "timestamp": "string"
  },
  "input": {
    "originalUrl": "string",
    "jobId": "string"
  },
  "shoppingResults": [
    {
      "title": "string",
      "price": "string",
      "rawPrice": 0.0,
      "previousPrice": "string",
      "rawPreviousPrice": 0.0,
      "source": "string",
      "rating": 0.0,
      "reviews": 0,
      "tag": "string",
      "rank": 0
    }
  ],
  "pagination": {
    "currentPage": 0,
    "nextPage": 0,
    "nextPageLink": "string",
    "nextPageStart": 0
  }
}