# Google Shopping Product Search API (https://www.socialcrawl.dev/platforms/google_shopping/product-search)

> Searches Google Shopping for products matching a keyword. Returns a unified ProductList with title, seller, price (current/original/currency), rating, image URLs, and the opaque product identifiers (id, ext.gid, ext.data_docid) required to fetch product detail, reviews, or sellers. Sourced from DataForSEO's task-based Merchant/Google API; the async lifecycle is handled server-side, so this is an ordinary synchronous request. First calls take ~20-30s, then serve from cache.

TL;DR: `GET /v1/google_shopping/product-search` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Product search keyword (e.g. 'wireless earbuds'). |
| `country` | no | DataForSEO location name (e.g. 'United States', 'United Kingdom'). Defaults to United States. |
| `language` | no | Language code (e.g. 'en'). Defaults to en. |
| `depth` | no | Number of product results to retrieve (default 40, max 120). More results = longer task time. |
| `price_min` | no | Minimum product price filter. |
| `price_max` | no | Maximum product price filter. |
| `sort_by` | no | Result ordering: review_score, price_low_to_high, or price_high_to_low. (review_score \| price_low_to_high \| price_high_to_low) |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/google_shopping/product-search?query=wireless%20earbuds" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I search Google Shopping products with an API?

Send a GET request to /v1/google_shopping/product-search with a query parameter (e.g. query=wireless earbuds). The response is a unified ProductList — each item has the title, seller, price, rating, image URLs, and the ids you need to fetch detail.

### What fields does Google Shopping product search return?

Each product includes id, title, seller, brand, price (current, original, currency), rating (average and count), image URLs, availability, and an ext object holding the gid and data_docid used by the product, reviews, and sellers endpoints.

### How do I narrow Google Shopping search results?

Optional parameters let you set country and language, cap result depth, filter by price_min and price_max, and sort by review_score, price_low_to_high, or price_high_to_low. Defaults are the United States and English.

### How much does a product search cost?

Product search runs on the advanced tier at 5 credits per call — it fetches a fresh ranked product list from Google Shopping. New accounts get 100 free credits, and an empty result is refunded automatically.

### How long does a Google Shopping search take?

Results are fetched live from Google Shopping, so the first call for a query typically returns within about 30 seconds. Identical queries are then served from cache, so repeat lookups come back quickly.

See the full Google Shopping API: https://www.socialcrawl.dev/platforms/google_shopping

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to search Google Shopping products with an API
- What does the SocialCrawl Google Shopping search API return?