backmarket.fr APIbackmarket.fr ↗
Search refurbished electronics on Back Market France, retrieve product details with variants and pricing, and fetch customer reviews via 3 structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/25ea2afe-3b30-4695-b04b-83a719b17b4d/get_product_details?product_id=%3Cproduct_uuid%3E&product_url=https%3A%2F%2Fwww.backmarket.fr%2Ffr-fr%2Fp%2Fiphone-15%2F%3Cproduct_uuid%3E' \ -H 'X-API-Key: $PARSE_API_KEY'
Extract detailed product information from a Back Market product UUID. Returns pricing, brand, model, images, available variants (condition, storage, battery), and availability status.
| Param | Type | Description |
|---|---|---|
| product_id | string | Product UUID (e.g. 'a8517119-6ed0-4c6f-8799-22f95658bc19'). Either product_id or product_url must be provided. |
| product_url | string | Full Back Market product URL containing a UUID in the path (e.g. 'https://www.backmarket.fr/fr-fr/p/iphone-15/a8517119-6ed0-4c6f-8799-22f95658bc19'). Either product_id or product_url must be provided. |
{
"type": "object",
"fields": {
"uuid": "string product UUID",
"brand": "string brand name",
"model": "string model name",
"title": "string product title",
"images": "array of image URLs",
"rating": "number average customer rating",
"variants": "array of picker groups (condition, battery, storage options)",
"availability": "object with in_stock and can_add_to_cart booleans",
"review_count": "integer total number of reviews",
"original_price": "number or null original retail price",
"starting_price": "string or number lowest available price"
},
"sample": {
"data": {
"uuid": "a8517119-6ed0-4c6f-8799-22f95658bc19",
"brand": "Apple",
"model": "iPhone 15",
"title": "iPhone 15Bleu • 128 Go • SIM physique + eSIM",
"images": [
"https://d2e6ccujb3mkqf.cloudfront.net/a8517119-6ed0-4c6f-8799-22f95658bc19-1_4afffbc4-dcec-45c2-a6ab-fb0b22f2d9b4.jpg"
],
"rating": 4.58,
"variants": [
{
"id": "grades",
"items": [
{
"label": "Très bon état",
"price": {
"amount": "396.00",
"currency": "EUR"
}
}
],
"label": "État"
}
],
"availability": {
"in_stock": false,
"can_add_to_cart": false
},
"review_count": 29889,
"original_price": null,
"starting_price": "396.00"
},
"status": "success"
}
}About the backmarket.fr API
The Back Market France API covers 3 endpoints for querying the Back Market France catalog: search by keyword, fetch full product details by UUID or URL, and retrieve customer reviews. The search_products endpoint returns paginated results with price, rating, and direct product links. get_product_details exposes condition, storage, and battery variants alongside availability status and original retail price for any listed product.
Product Search
The search_products endpoint accepts a required query string (e.g. 'iPhone 15', 'MacBook Pro') and returns paginated results. Each product object in the products array includes name, uuid, brand, model, price, original_price, rating, review_count, image, and url. Pagination is 0-indexed via the page parameter, and nbPages plus total_hits let you iterate the full result set.
Product Details
get_product_details accepts either a product_id (UUID string) or a full product_url containing a UUID in the path — at least one must be provided. The response includes the product title, brand, model, an images array, aggregate rating, review_count, and original_price when available. The variants field returns an array of picker groups covering condition (e.g. Fair/Good/Excellent), storage capacity, and battery health options. The availability object exposes in_stock and can_add_to_cart booleans for the current listing state.
Customer Reviews
get_product_reviews accepts the same product_id or product_url inputs as the detail endpoint. It returns up to 7 top reviews, each with an integer rating, author name, and comment text. Alongside the review array, the response includes average_rating (out of 5) and review_count for the full aggregate totals, even though the reviews array itself is capped at 7 entries per call.
- Track refurbished iPhone prices across condition variants (Fair/Good/Excellent) using
variantsfromget_product_details. - Build a price-comparison tool that pulls
original_pricevs.priceto show savings on refurbished electronics. - Monitor
availability.in_stockstatus for specific product UUIDs to alert users when a listing comes back in stock. - Aggregate
average_ratingandreview_countdata across search results to rank the best-reviewed refurbished laptops. - Extract customer sentiment from
commentfields inget_product_reviewsfor a specific product. - Paginate through
search_productsresults to build a full catalog snapshot of Back Market France's refurbished inventory. - Compare
batteryvariants for refurbished phones to surface listings with the best battery condition at a given price point.
| 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 | 250 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 Back Market have an official public developer API?+
What does `get_product_details` return beyond basic pricing?+
price and original_price, the endpoint returns a variants array that breaks down available picker options for condition (e.g. Fair, Good, Excellent), storage capacity, and battery health. It also returns an availability object with in_stock and can_add_to_cart booleans, plus an images array and aggregate rating and review_count.How many reviews does `get_product_reviews` return per call?+
review_count and average_rating fields reflect the full aggregate totals for the product, but paginating through all reviews beyond those 7 is not currently supported. You can fork this API on Parse and revise it to add deeper review pagination.