# Google Shopping

> Search for products across Google Shopping and get detailed product information including prices, ratings, reviews, and store offers.

Source: https://cotera.co/docs/reference/tools/individual-tools/google-shopping

---

**Authentication Type:** API Key

**Description:** Search for products across Google Shopping and get detailed product information including prices, ratings, reviews, and store offers.

***

## Authentication

To authenticate, you'll need a RapidAPI key for the [Real-Time Product Search API](https://rapidapi.com/letscrape-6bRBa3QguO5/api/real-time-product-search).

***

## Product Search

Search for products on Google Shopping with sorting and filtering options.

### Search Products

Search for products across Google Shopping. Returns product listings with prices, ratings, store information, and available filters.

**Operation Type:** Query (Read)

**Parameters:**

* **q** `string` (required): Search query for products (e.g., "Nike shoes")
* **country** `string` (default: us): Country code for search results (e.g., us, uk, de)
* **language** `string` (default: en): Language code for results (e.g., en, es, fr)
* **page** `number` (default: 1): Page number for pagination
* **limit** `number` (default: 10): Number of results per page (max 100)
* **sort\_by** `string` (default: BEST\_MATCH): Sort order for results (BEST\_MATCH, LOWEST\_PRICE, HIGHEST\_PRICE, TOP\_RATED)
* **product\_condition** `string` (default: ANY): Filter by product condition (ANY, NEW, USED, REFURBISHED)
* **return\_filters** `boolean` (default: true): Whether to return available filters

**Returns:**

* **products** `array of objects`: Array of product search results
  * **product\_id** `string`: Unique product identifier (use for Product Details)
  * **product\_title** `string`: Product name
  * **product\_description** `string` (nullable): Product description
  * **product\_photos** `array of strings` (nullable): Product image URLs
  * **price** `string` (nullable): Product price
  * **store\_name** `string` (nullable): Seller/store name
  * **product\_rating** `number` (nullable): Average product rating
  * **product\_num\_reviews** `number` (nullable): Number of reviews
  * **product\_page\_url** `string` (nullable): URL to product page
* **sponsored\_products** `array`: Sponsored product listings
* **filters** `array of objects`: Available filter options
  * **title** `string`: Filter category name
  * **multivalue** `boolean`: Whether multiple values can be selected
  * **values** `array of objects`: Available filter values
    * **title** `string`: Filter value display name
    * **q** `string`: Query parameter for this filter
    * **shoprs** `string`: Filter identifier

**Example Usage:**

```json
{
  "q": "wireless headphones",
  "country": "us",
  "language": "en",
  "page": 1,
  "limit": 20,
  "sort_by": "TOP_RATED",
  "product_condition": "NEW",
  "return_filters": true
}
```

***

## Product Details

Get comprehensive information about a specific product.

### Get Product Details

Get detailed information about a specific product including photos, ratings, reviews, pricing, variants, and available offers from different stores.

**Operation Type:** Query (Read)

**Parameters:**

* **product\_id** `string` (required): The product ID from a previous search result
* **country** `string` (default: us): Country code for product details (e.g., us, uk, de)
* **language** `string` (default: en): Language code for results (e.g., en, es, fr)

**Returns:**

* **product** `object`: Detailed product information
  * **product\_id** `string`: Unique product identifier
  * **product\_title** `string`: Product name
  * **product\_description** `string`: Full product description
  * **product\_photos** `array of strings`: Product image URLs
  * **product\_videos** `array`: Product video content
  * **product\_attributes** `object`: Product specifications and attributes
  * **product\_rating** `number`: Average product rating
  * **product\_page\_url** `string`: URL to product page
  * **product\_num\_reviews** `number`: Total number of reviews
  * **product\_num\_offers** `number`: Number of available offers
  * **typical\_price\_range** `array of strings`: Typical price range for this product
  * **current\_product\_variant\_properties** `object`: Current variant selections
  * **product\_variants** `object`: Available product variants (colors, sizes, etc.)
  * **reviews\_insights** `object`: Aggregated review insights
  * **offer** `object`: Best available offer
    * **offer\_id** `string`: Unique offer identifier
    * **offer\_title** `string`: Offer title
    * **offer\_page\_url** `string`: URL to purchase
    * **price** `string`: Current price
    * **original\_price** `string` (nullable): Original price before discount
    * **on\_sale** `boolean`: Whether the product is on sale
    * **shipping** `string`: Shipping information
    * **returns** `string`: Return policy
    * **product\_condition** `string`: Product condition
    * **store\_name** `string`: Store/seller name
    * **store\_rating** `string`: Store rating
    * **store\_review\_count** `number`: Number of store reviews
    * **store\_reviews\_page\_url** `string`: URL to store reviews
    * **store\_favicon** `string`: Store favicon URL
    * **special\_offer** `string`: Special offer details
    * **special\_offer\_expiration** `string`: When special offer expires
    * **payment\_methods** `string`: Accepted payment methods

**Example Usage:**

```json
{
  "product_id": "11577822405123972122",
  "country": "us",
  "language": "en"
}
```

***

## Product Reviews

Get reviews for a specific product with pagination and filtering options.

### Get Product Reviews

Get reviews for a specific product including ratings, review text, author information, and pagination support.

**Operation Type:** Query (Read)

**Parameters:**

* **product\_id** `string` (required): The product ID from a previous search result
* **limit** `number` (default: 50): Maximum number of reviews to return (1-100)
* **cursor** `string` (default: null): Cursor for pagination to get the next set of results
* **sort\_by** `string` (default: MOST\_RELEVANT): Sort order for reviews (MOST\_RELEVANT, MOST\_RECENT)
* **rating** `number` (default: null): Only return reviews with rating greater than this value (1-5)
* **country** `string` (default: us): Country code for results (e.g., us, uk, de)
* **language** `string` (default: en): Language code for results (e.g., en, es, fr)

**Returns:**

* **reviews** `array of objects`: Array of product reviews
  * **review\_id** `string`: Unique review identifier
  * **review\_title** `string`: Review title/headline
  * **rating** `number`: Review rating (1-5)
  * **review\_text** `string`: Full review text content
  * **review\_date** `string`: Human-readable review date
  * **review\_datetime\_utc** `string`: Review timestamp in UTC
  * **review\_author** `string`: Name of the reviewer
  * **review\_author\_photo** `string`: URL to reviewer's profile photo
  * **review\_source** `string`: Source of the review (e.g., store name)
  * **review\_source\_url** `string`: URL to the original review
* **product\_rating** `number`: Overall product rating
* **product\_num\_reviews** `number`: Total number of reviews for this product
* **reviews\_per\_rating** `object`: Breakdown of reviews by rating
  * **1** `number`: Count of 1-star reviews
  * **2** `number`: Count of 2-star reviews
  * **3** `number`: Count of 3-star reviews
  * **4** `number`: Count of 4-star reviews
  * **5** `number`: Count of 5-star reviews
* **cursor** `string` (nullable): Cursor for fetching the next page of results

**Example Usage:**

```json
{
  "product_id": "11577822405123972122",
  "limit": 50,
  "cursor": null,
  "sort_by": "MOST_RECENT",
  "rating": null,
  "country": "us",
  "language": "en"
}
```

***

## Common Use Cases

**Price Comparison:**

* Search for products and compare prices across different stores
* Find the best deals by sorting results by lowest price
* Track price changes by monitoring typical price ranges

**Product Research:**

* Get detailed product specifications and attributes
* Read aggregated review insights before purchasing
* Compare product variants like colors, sizes, and configurations

**Review Analysis:**

* Analyze customer sentiment by fetching product reviews
* Filter reviews by rating to identify common complaints or praise
* Track review trends over time with pagination and sorting options

**E-commerce Integration:**

* Build product recommendation systems with real-time pricing
* Create price monitoring and alerting workflows
* Enrich product catalogs with Google Shopping data

**Competitive Analysis:**

* Monitor competitor product pricing and availability
* Track store ratings and review counts
* Analyze market positioning across different product categories