# SocialCrawl API — google_shopping endpoints
# Base URL: https://www.socialcrawl.dev
# Auth: x-api-key header
# Full docs: https://www.socialcrawl.dev/docs/google_shopping

## GET /v1/google_shopping/product-search
Search Google Shopping products
Credit cost: 5 (advanced)
Parameters:
- query (required) — Product search keyword (e.g. 'wireless earbuds').
- country (optional, string) — DataForSEO location name (e.g. 'United States', 'United Kingdom'). Defaults to United States.
- language (optional, string) — Language code (e.g. 'en'). Defaults to en.
- depth (optional, integer) — Number of product results to retrieve (default 40, max 120). More results = longer task time.
- price_min (optional, string) — Minimum product price filter.
- price_max (optional, string) — Maximum product price filter.
- sort_by (optional, enum: review_score | price_low_to_high | price_high_to_low) — Result ordering: review_score, price_low_to_high, or price_high_to_low.
curl "https://www.socialcrawl.dev/v1/google_shopping/product-search?query=wireless earbuds" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/google_shopping/product
Get Google Shopping product detail
Credit cost: 1 (standard)
Parameters:
- product_id (optional, string) — Google Shopping product_id (from product-search).
- gid (optional, string) — Google Shopping gid (from product-search).
- data_docid (optional, string) — Google Shopping data_docid (from product-search).
- country (optional, string) — DataForSEO location name. Defaults to United States.
- language (optional, string) — Language code. Defaults to en.
- Constraint: one of product_id, gid, data_docid (at least one required)
curl "https://www.socialcrawl.dev/v1/google_shopping/product" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/google_shopping/reviews
Get Google Shopping product reviews
Credit cost: 1 (standard)
Parameters:
- gid (required) — Google Shopping gid of the product (from product-search). Required.
- product_id (optional, string) — Google Shopping product_id (recommended for accuracy).
- data_docid (optional, string) — Google Shopping data_docid (recommended for accuracy).
- depth (optional, integer) — Number of reviews to retrieve (default 10, multiples of 10, max 8000).
- country (optional, string) — DataForSEO location name. Defaults to United States.
- language (optional, string) — Language code. Defaults to en.
curl "https://www.socialcrawl.dev/v1/google_shopping/reviews?gid=3591805395819257241" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/google_shopping/sellers
Get Google Shopping sellers for a product
Credit cost: 1 (standard)
Parameters:
- product_id (optional, string) — Google Shopping product_id (from product-search).
- gid (optional, string) — Google Shopping gid (from product-search).
- data_docid (optional, string) — Google Shopping data_docid (from product-search).
- country (optional, string) — DataForSEO location name. Defaults to United States.
- language (optional, string) — Language code. Defaults to en.
- Constraint: one of product_id, gid, data_docid (at least one required)
curl "https://www.socialcrawl.dev/v1/google_shopping/sellers" \
  -H "x-api-key: sc_your_api_key_here"