# Commerce and prices (/docs/use-cases/commerce-and-prices) Compare products, prices and reviews across retailers, and know which market a price is for. Search a retailer for a product, read its price and reviews, and compare the same product across shops. Every product comes back in one shape, and `country` decides which market's price you get. ## Start with a template - [Compare reviews across retailers](/docs/templates.md#commerce-and-reviews): One product - [Alert when a web page changes](/docs/templates.md#monitoring): Watch a product or pricing page and hear when it changes. ## Run your first request This searches the US Amazon store for espresso machines. **cURL** ```bash title="cURL" curl "https://www.socialcrawl.dev/v1/amazon/product-search?query=espresso+machine&country=US" \ -H "x-api-key: sc_your_key_here" ``` **Python** ```python title="Python" import requests response = requests.get( "https://www.socialcrawl.dev/v1/amazon/product-search", params={"query": "espresso machine", "country": "US"}, headers={"x-api-key": "sc_your_key_here"}, ) for row in response.json()["data"]["items"]: product = row["product"] print(product["title"], product["price"]["current"], product["price"]["currency"]) ``` **TypeScript** ```typescript title="TypeScript" const url = new URL("https://www.socialcrawl.dev/v1/amazon/product-search"); url.searchParams.set("query", "espresso machine"); url.searchParams.set("country", "US"); const response = await fetch(url, { headers: { "x-api-key": "sc_your_key_here" } }); const { data } = await response.json(); for (const { product } of data.items) { console.log(product.title, product.price.current, product.price.currency); } ``` Each row carries the product's title, current and original price, currency, rating and link. Where Amazon shows its monthly purchase badge, `product.ext.bought_past_month` holds the lower bound of that figure as a number. Multiply it by `price.current` for a rough idea of monthly spend in that market. For the next page of results, send the cursor the response gives you, as [Pagination](/docs/pagination.md) explains. This call costs 1 credit. To see what a call costs before you send it, pass the same parameters to `GET /v1/utility/estimate` with `id=amazon/product-search`. That quote is free, and [Endpoint pricing](/docs/endpoint-pricing.md) lists every call. ## How it works 1. **Search** a retailer for the product by keyword, in the market you choose with `country`. 2. **Read** the product and its reviews. The detail call adds features, specifications and other variants. 3. **Compare** the same product across retailers, and watch its page so you hear when the price moves. ## Why teams choose SocialCrawl **One product shape for every shop.** A product from any retailer has the same fields, so one parser reads them all. See the [product schema](/docs/schema/product.md). **The market is explicit.** On Amazon, eBay and the App Store, `country` picks the store, and listings, prices and currency follow it. See [what country and region do](/docs/data-availability.md#country-and-region). **A price change can come to you.** A page watch checks a product page on a schedule and tells you when it changes. The [web page change alert template](/docs/templates.md#monitoring) sets one up. ## Questions ### Why does a price differ by market, unit or variant? Each market is its own catalog, so the same product can carry a different price and currency in each. Send `country` to choose the market, and read `price.currency` on every row before you compare. A different size or color is often a separate listing with its own price, and the detail call lists those under `variations`. The [country and region guide](/docs/data-availability.md#country-and-region) explains which parameter picks a market on each platform. ## Related - [Competitive intelligence](/docs/use-cases/competitive-intelligence.md): Track competitors - [Ad intelligence](/docs/use-cases/ad-intelligence.md): Search advertisers and read their ads across ad libraries. - [Reviews and reputation](/docs/use-cases/reviews-and-reputation.md): Collect reviews from shops, maps and app stores.