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
One product's reviews from two retailers, side by side, as a ready program.
Alert when a web page changes
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 "https://www.socialcrawl.dev/v1/amazon/product-search?query=espresso+machine&country=US" \
-H "x-api-key: sc_your_key_here"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"])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 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 lists every call.
How it works
- Search a retailer for the product by keyword, in the market you choose with
country. - Read the product and its reviews. The detail call adds features, specifications and other variants.
- 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.
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.
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 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 explains which parameter picks a market on each platform.
