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

## GET /v1/amazon/shop
Get Amazon shop page
Credit cost: 1 (standard)
Parameters:
- url (required) — Full URL of the Amazon shop or storefront page
curl "https://www.socialcrawl.dev/v1/amazon/shop?url=https://www.amazon.com/shop/sydneydelrey" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/amazon/product-search
Search Amazon products by keyword
Credit cost: 1 (standard)
Parameters:
- query (required) — Search keyword or phrase.
- country (optional, enum: US | GB | CA | DE | FR | IT | ES | JP | IN | MX | BR | AU | NL) — Amazon marketplace as an ISO 3166-1 alpha-2 country code (default US). Supported: US, GB, CA, DE, FR, IT, ES, JP, IN, MX, BR, AU, NL. Note: non-US marketplaces (especially EU) are best-effort — the upstream provider is slower and occasionally times out for these; such calls are refunded, and US is the most reliable marketplace.
- depth (optional, integer) — Maximum number of products to return (default 20, max 700). Search is a synchronous live scrape whose latency grows with depth; the 20-row default keeps keyword→ASIN resolution fast and reliable. Higher depth returns more rows at the same flat credit cost but takes longer (a timeout is auto-refunded).
curl "https://www.socialcrawl.dev/v1/amazon/product-search?query=wireless earbuds" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/amazon/product
Get an Amazon product by ASIN
Credit cost: 5 (advanced)
Parameters:
- asin (required) — 10-character Amazon ASIN (the product identifier).
- country (optional, enum: US | GB | CA | DE | FR | IT | ES | JP | IN | MX | BR | AU | NL) — Amazon marketplace as an ISO 3166-1 alpha-2 country code (default US). Supported: US, GB, CA, DE, FR, IT, ES, JP, IN, MX, BR, AU, NL. Note: non-US marketplaces (especially EU) are best-effort — the upstream provider is slower and occasionally times out for these; such calls are refunded, and US is the most reliable marketplace.
curl "https://www.socialcrawl.dev/v1/amazon/product?asin=B0FQFB8FMG" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/amazon/reviews
Get Amazon product reviews
Credit cost: 5 (advanced)
Parameters:
- asin (required) — 10-character Amazon ASIN (the product identifier).
- country (optional, enum: US | GB | CA | DE | FR | IT | ES | JP | IN | MX | BR | AU | NL) — Amazon marketplace as an ISO 3166-1 alpha-2 country code (default US). Supported: US, GB, CA, DE, FR, IT, ES, JP, IN, MX, BR, AU, NL. Note: non-US marketplaces (especially EU) are best-effort — the upstream provider is slower and occasionally times out for these; such calls are refunded, and US is the most reliable marketplace.
curl "https://www.socialcrawl.dev/v1/amazon/reviews?asin=B0DCH8VDXF" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/amazon/sellers
Get Amazon sellers and offers for a product
Credit cost: 1 (standard)
Parameters:
- asin (required) — 10-character Amazon ASIN (the product identifier).
- country (optional, enum: US | GB | CA | DE | FR | IT | ES | JP | IN | MX | BR | AU | NL) — Amazon marketplace as an ISO 3166-1 alpha-2 country code (default US). Supported: US, GB, CA, DE, FR, IT, ES, JP, IN, MX, BR, AU, NL. Note: non-US marketplaces (especially EU) are best-effort — the upstream provider is slower and occasionally times out for these; such calls are refunded, and US is the most reliable marketplace.
curl "https://www.socialcrawl.dev/v1/amazon/sellers?asin=B09SM24S8C" \
  -H "x-api-key: sc_your_api_key_here"