# 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[​](https://serp-api.netnut.io/docs/SERP/Getting%20Started#authentication) <a href="#authentication" id="authentication"></a>

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[​](https://serp-api.netnut.io/docs/SERP/Getting%20Started#environments) <a href="#environments" id="environments"></a>

* Base URL: `https://serp-api.netnut.io`
* Endpoint: `/search&udm=28`

### API Parameters & Specifications[​](https://serp-api.netnut.io/docs/SERP/Getting%20Started#api-parameters--specifications) <a href="#api-parameters--specifications" id="api-parameters--specifications"></a>

#### &#x20;Search Query[​](https://serp-api.netnut.io/docs/SERP/Getting%20Started#----search-query-) <a href="#search-query" id="search-query"></a>

| 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:`). |

#### &#x20;Pagination[​](https://serp-api.netnut.io/docs/SERP/Getting%20Started#--pagination-) <a href="#pagination" id="pagination"></a>

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

#### &#x20;Geographic Location[​](https://serp-api.netnut.io/docs/SERP/Getting%20Started#--geographic-location--) <a href="#geographic-location" id="geographic-location"></a>

| Name   | Status   | Description                                                                                                                                                                     |
| ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `uule` | Optional | The 'uule' parameter is the Google encoded location you want to use for performing the Google search. [**Click here** ](https://indexguru.com/uule-generator)to generate a UULE |

#### &#x20;Localization[​](https://serp-api.netnut.io/docs/SERP/Getting%20Started#--localization--) <a href="#localization" id="localization"></a>

| Name           | Status   | Description                                                                                                                                                                                                                                                                                                |
| -------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `googleDomain` | Optional | <p>The <code>googleDomain</code> parameter defines the Google domain to use for the Google search. The default is <code>[www.google.com](http://www.google.com)</code>. <br>Please ensure you add "www" before the domain name.</p>                                                                        |
| `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** ](https://cloud.google.com/translate/docs/languages)the Google languages page for a full list of supported Google languages. |
| `location`     | Optional | <p>Similarly to the  <code>gl</code> parameter it is another parameter  that defines the country to use for the Google search. <br>It is a two-letter country code. For example - use <code>us</code> for the United States, <code>uk</code> for United Kingdom, etc.</p>                                  |

#### &#x20;Advanced Filters[​](https://serp-api.netnut.io/docs/SERP/Getting%20Started#--advanced-filters--) <a href="#advanced-filters" id="advanced-filters"></a>

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

### Google Shopping Specific Filters <a href="#api-results-http-response" id="api-results-http-response"></a>

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

### API Results structure[​](https://serp-api.netnut.io/docs/SERP/Getting%20Started#api-results-http-response) <a href="#api-results-http-response" id="api-results-http-response"></a>

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

```