Amazon APIamazon.fr ↗
Access Amazon.fr product data via API: search results, full product details, specifications, seller offers, customer reviews, and live deals.
What is the Amazon API?
The Amazon.fr API covers 7 endpoints for retrieving product and seller data from the French Amazon storefront. Use search_products to query the catalog by keyword with sorting and pagination, get_product_details to pull full listings including bullets, variants, and availability, or get_product_reviews to extract up to ~8 customer reviews per ASIN — all returning structured JSON.
curl -X GET 'https://api.parse.bot/scraper/d8cf7ebc-a067-48a7-88ee-044a72a6a3f6/search_products?page=1&sort=review-rank&query=samsung+galaxy' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace amazon-fr-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Amazon.fr SDK — search products, drill into details, reviews, and offers."""
from parse_apis.Amazon_fr_Scraper_API import AmazonFr, SortOrder, ProductNotFound
client = AmazonFr()
# Search for bluetooth headphones sorted by best reviews
for product in client.products.search(query="casque bluetooth", sort=SortOrder.REVIEW_RANK, limit=5):
print(product.title, product.price, product.rating)
# Drill into the first result for full details
product = client.products.search(query="iphone", limit=1).first()
if product:
detail = product.details.get()
print(detail.title, detail.price, detail.brand, detail.availability)
# Check specifications
specs = product.specifications.get()
print(specs.title, specs.asin)
# List seller offers
for offer in product.offers.list(limit=3):
print(offer.price, offer.seller, offer.condition)
# Read customer reviews
for review in product.reviews.list(limit=3):
print(review.author, review.rating, review.title)
# Typed error handling: catch product-not-found for an invalid ASIN
try:
missing = client.products.get(asin="B000000000")
print(missing.title)
except ProductNotFound as exc:
print(f"Product not found: {exc.asin}")
print("Exercised: products.search / products.get / details.get / specifications.get / offers.list / reviews.list")
Search for products on Amazon.fr. Returns paginated results with product title, price, rating, review count, and image. Paginates via page number. May occasionally be blocked by Amazon's bot protection, in which case proxy rotation resolves the issue.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| sort | string | Sort order. Accepted values: 'price-asc-rank', 'price-desc-rank', 'review-rank', 'date-desc-rank' |
| queryrequired | string | Search keyword (e.g. 'casque bluetooth', 'iphone') |
{
"type": "object",
"fields": {
"page": "string, the current page number",
"items": "array of product objects with asin, title, price, rating, review_count, image, is_prime, url",
"query": "string, the search query used"
},
"sample": {
"data": {
"page": "1",
"items": [
{
"url": "https://www.amazon.fr/dp/B0BYWMLVG1",
"asin": "B0BYWMLVG1",
"image": "https://m.media-amazon.com/images/I/512LuQyL3BL._AC_UL320_.jpg",
"price": "27,88 €",
"title": "JBL Tune 520BT casque audio sans fil",
"rating": "4,5 sur 5 étoiles",
"is_prime": false,
"review_count": "11 210 évaluations"
}
],
"query": "casque bluetooth"
},
"status": "success"
}
}About the Amazon API
Search and Product Lookup
The search_products endpoint accepts a query string (e.g. 'casque bluetooth') and an optional sort parameter supporting four orderings: price-asc-rank, price-desc-rank, review-rank, and date-desc-rank. Results are paginated via the page parameter and each item in the items array includes asin, title, price, rating, review_count, image, is_prime, and url. For a single ASIN, get_product_details returns the full listing: brand, formatted price, images array, bullets array, variants, availability status, and aggregate review_count.
Specifications, Offers, and Reviews
get_product_specifications returns a flat specifications object — key-value pairs of technical attributes found on the product page — useful for structured comparison across ASINs. get_product_offers extracts the buy-box offer and any additional seller options, each with price, seller, condition, and availability. get_product_reviews returns up to approximately 8 top reviews per ASIN, each containing author, rating, title, body, date, and a verified_purchase flag.
Deals and Seller Data
get_deals retrieves current promotions from the Amazon.fr Goldbox page, returning an array of deal objects with title and asin. get_seller_profile looks up a seller by seller_id and returns name, seller_id, and vat_number (TVA) — relevant for VAT compliance or marketplace due diligence. This endpoint is noted to be heavily protected by AWS WAF and may have a lower success rate than the product endpoints.
The Amazon API is a managed, monitored endpoint for amazon.fr — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when amazon.fr changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official amazon.fr API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track competitor pricing on Amazon.fr by polling
get_product_detailsfor target ASINs and storing thepricefield over time. - Build a product comparison tool using
get_product_specificationsto surface technical attribute differences across multiple ASINs. - Monitor deal activity with
get_dealsto alert users when watched categories appear in Goldbox promotions. - Aggregate French-language customer sentiment by collecting
body,rating, andverified_purchasefields fromget_product_reviews. - Verify marketplace seller legitimacy by checking the
vat_numberfield returned byget_seller_profile. - Power a price-comparison widget using
get_product_offersto surface all available seller conditions and prices for a given ASIN. - Populate a product catalog with French locale data — titles, images, and bullet points — sourced from
search_productsquery results.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Amazon.fr have an official developer API?+
How many reviews does `get_product_reviews` return per request?+
author, rating, title, body, date, and verified_purchase. Pagination across all review pages is not currently supported. The API covers the top-reviewed set visible on the product page. You can fork it on Parse and revise it to add offset or page-based review pagination.Does the API return seller inventory counts or fulfillment type (FBA vs. FBM)?+
get_product_offers returns price, seller, condition, and availability text, but does not expose inventory quantities or fulfillment method flags. You can fork it on Parse and revise to add those fields if the source page exposes them for a given ASIN.Can `search_products` be filtered by category or brand in addition to keyword?+
query, sort, and page as inputs. Category-level or brand-level filtering beyond what can be encoded in the query string is not exposed as a dedicated parameter. You can fork it on Parse and revise to add browse-node or brand filter parameters.Is the `get_seller_profile` endpoint reliable for all seller IDs?+
name, seller_id, and vat_number when accessible, but requests may fail more frequently than other endpoints in this API.