---
title: "Search products on Google"
method: POST
path: "/google/search-products"
tags: ["Google"]
---

# Search products on Google

`POST /google/search-products`

Search products on Google for a given query

## Request body

- object
  - `query` string, required — The search query for products
  - `country_code` string — The country code for filtering products
  - `page` integer — Page number for pagination (default is 1)
  - `per_page` integer — Number of products to return per page (default is 10)
  - `sort_by` 'best_match' | 'top_rated' | 'lowest_price' | 'highest_price' — Sort the results by a specific field
  - `product_condition` 'any' | 'new' | 'used' | 'refurbished' — Filter products by condition

## Response `200`

SearchProducts API successful response

- object
  - `products` GoogleProduct[]
    - `product_id` string — The unique identifier for the product
    - `title` string — The title of the product
    - `description` string, nullable — A detailed description of the product
    - `photos` string[] — An array of URLs for the product photos
    - `attributes` object, nullable — A set of attributes for the product, represented as key-value pairs
    - `rating` number, float, nullable — The average rating of the product
    - `page_url` string, uri — The URL link to the product page
    - `num_reviews` integer, nullable — The total number of reviews for the product
    - `reviews_per_rating` object — The number of reviews for each rating level
    - `product_details` object — Detailed information about the product
    - `product_specs` object — Technical specifications of the product

## Other responses

- `400` — User error response
- `500` — Server error response

---

[API](https://skmtc.net/carvedai/apis/exfunc-apis.md) · [All operations](https://skmtc.net/carvedai/apis/exfunc-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carvedai/exfunc-apis/revisions/22587fdf9a5e/schema)