Amazon Product API for Price, Review, and Offer Data
The SurfSense Amazon Product API scrapes public Amazon listings as structured JSON: price and list price, rating and review breakdown, availability, marketplace offers, sellers, best-seller ranks, and on-page reviews. Point your AI agents at a search term or product URL and track prices across US, UK, German, Italian, and Spanish marketplaces — no login, only public data.
$
amazon.scrape({ search_terms: ["mechanical keyboard"],
max_items: 5, max_offers: 3 })- Keychron K8 Pro — $89.99 (was $99.99)4.7 stars · 12,431 ratings · In Stock-10%
- 3 marketplace offers, cheapest $84.50 usedsold by 2 third-party sellersoffers
- #2 in Computer Keyboards best-sellersElectronics › Accessories › Keyboardsrank
5 products · 14 offers · 5 best-seller ranks · surfaced in 3.1s
What you can extract from Amazon
Give the API a list of product/search/category/best-seller URLs or search terms and a domain. Marketplace is inferred from each Amazon URL, or from the domain used with search terms. Supported marketplaces include US, UK, Germany, Italy, and Spain; France is best-effort because Amazon France is more WAF-sensitive.
Product core
Title, ASIN, brand, price, list price, availability, condition, and canonical URL for every product.
Ratings & reviews
Star rating, review count, the 5-to-1-star histogram, and on-page customer reviews with text, author, and date.
Marketplace offers
Additional buy-box offers with price, condition, delivery, and the third-party seller behind each.
Sellers
Public seller profile summaries — name, rating, and feedback count — for the featured and offer sellers.
Best-seller ranks
Category rank positions and best-seller list placements, for demand and category monitoring.
Variants & media
Variant ASINs and attributes (color, size), per-variant prices, gallery and high-resolution images.
What teams do with the Amazon Product API
Price and buy-box tracking
Watch your own and competitors' prices, list prices, and marketplace offers across US, UK, German, Italian, and Spanish marketplaces. Feed each run to an agent that diffs prices and alerts you when a competitor undercuts or the buy box changes hands.
Review mining and product research
Pull ratings, the star histogram, and on-page reviews to understand what customers love and complain about, then brief an agent to summarize themes and inform your roadmap or listing copy.
Best-seller and category monitoring
Track best-seller ranks in the categories you care about to spot rising products and demand shifts before they show up anywhere else.
Catalog and seller intelligence
Enrich a catalog by ASIN with structured attributes, variants, and images, and see which third-party sellers are winning offers on the products that matter to you.
Call it from your code or your agent
One typed endpoint, one API key. Or add the SurfSense MCP server and let your agent call amazon.scrape as a native tool.
curl -X POST "$SURFSENSE_API_URL/workspaces/$WORKSPACE_ID/scrapers/amazon/scrape" \
-H "Authorization: Bearer $SURFSENSE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"search_terms": [
"mechanical keyboard"
],
"max_items": 5,
"max_offers": 3
}'Amazon API request and response schema
The exact contract behind POST /workspaces/{workspace_id}/scrapers/amazon/scrape. The same fields power the amazon.scrape MCP tool.
Request parameters
Provide urls or search_terms (at least one). Marketplace is inferred from Amazon URLs, or from domain for search terms. Up to 20 combined sources per call.
| Field | Type | Description |
|---|---|---|
urls | string[] | Amazon product, search, category, best-seller, or short (a.co / amzn.to) URLs. Supports amazon.com, amazon.co.uk, amazon.de, amazon.it, and amazon.es; amazon.fr is best-effort. Provide urls or search_terms. |
search_terms | string[] | Search phrases run on the Amazon domain, e.g. 'wireless earbuds'. Provide search_terms or urls. |
max_items | integerdefault 10 | Max products per search term or category/best-seller URL, 1 to 100. |
domain | stringdefault "www.amazon.com" | Amazon marketplace domain for search_terms, e.g. 'www.amazon.co.uk', 'www.amazon.de', 'www.amazon.it', or 'www.amazon.es'. 'www.amazon.fr' is best-effort due to WAF sensitivity. |
include_details | booleandefault true | Fetch full product detail pages. false returns faster card-only results. |
max_offers | integerdefault 0 | Extra marketplace offers to fetch per product, 0 to 100. 0 returns the featured offer only. |
include_sellers | booleandefault false | Enrich the product and each offer with the seller's public profile. |
max_variants | integerdefault 0 | Product variants to return as separate results, 0 to 100. |
include_variant_prices | booleandefault false | Attach per-variant prices (one extra request per variant). |
country_code | string | Two-letter delivery country for localized pricing, e.g. 'us'. |
zip_code | string | Delivery ZIP/postal code for localized availability, e.g. '10001'. |
language | string | Content language for the domain, e.g. 'en'. |
Response fields
The response is { items: [...] } with one item per product. One returned product is one billable unit; error items are never billed.
| Field | Type | Description |
|---|---|---|
title / asin / brand | string | Product identity: display title, ASIN, and brand. |
price / listPrice | object | Current price and strike-through list price, each with value and currency. |
stars / reviewsCount / starsBreakdown | object | Average rating, total review count, and the 5-to-1-star distribution as fractions. |
offers | object[] | Marketplace offers with price, condition, delivery, seller, and pinned-offer flag. |
seller | object | Featured seller profile: id, name, url, rating, and feedback count. |
bestsellerRanks | object[] | Category rank positions and best-seller list placements. |
variantAsins / variantDetails / variantAttributes | object[] | Related variant ASINs and their attributes and per-variant prices. |
productPageReviews | object[] | On-page customer reviews with text, author, rating, and date. |
An Amazon scraper API built for agents
Most Amazon data APIs bill per request, meter add-ons separately, and leave the discovery-to-detail logic to you. Here is how SurfSense compares.
| Feature | Typical Amazon data API | SurfSense |
|---|---|---|
| Pricing | Per-request pricing that climbs fast at scale | Pay per product returned, with a free tier to start |
| Discovery | Separate search and detail endpoints you stitch together | One verb takes search terms, product, category, or best-seller URLs |
| Offers & sellers | Often separate paid endpoints | Offers and seller profiles enriched inline on the product |
| Data access | Requires accounts, keys, or approval for many providers | Public, anonymous data only — no login or seller account |
| Agent-ready | No; you wire the harness yourself | MCP server exposes amazon.scrape as a native tool |
Amazon Product API: frequently asked questions
Point your agents at Amazon
The Amazon connector is one of many in the SurfSense open web research platform. Start free, no credit card required.
SurfSenseSurfSense