fnac.com APIfnac.com ↗
Access Fnac product search, detailed specs, customer reviews, and current deals via a structured JSON API. Covers prices, ratings, and availability.
curl -X GET 'https://api.parse.bot/scraper/efa820ea-431a-4db6-abb1-c3914cea097b/search_products?page=2&query=samsung' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on Fnac using a keyword query. Returns a paginated list of products with prices, ratings, and availability.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (1-based) |
| sort | integer | Sort order: 0=relevance, 1=price ascending, 2=price descending |
| queryrequired | string | Search keyword (e.g. 'iphone', 'ordinateur portable') |
{
"type": "object",
"fields": {
"page": "integer page number",
"products": "array of product objects with name, url, price, image_url, rating, review_count, availability, and optional old_price, brand, promo fields",
"total_results": "string with total result count (e.g. '28 876 résultats')"
},
"sample": {
"data": {
"page": 1,
"products": [
{
"url": "https://www.fnac.com/Apple-iPhone-Air-6-5-5G-e-SIM-256-Go-Or-clair/a21960880/w-4",
"name": "Apple iPhone Air 6,5\" 5G e-SIM 256 Go Or clair",
"price": "969 €",
"promo": "Offre FNAC -21%",
"rating": "5/5",
"image_url": null,
"old_price": "1 229 €",
"availability": "En stock en ligne",
"review_count": "8 avis"
}
],
"total_results": "28 876 résultats"
},
"status": "success"
}
}About the fnac.com API
The Fnac.com API exposes 4 endpoints covering product search, full product details, customer reviews, and curated deals from France's major electronics and cultural goods retailer. The search_products endpoint returns paginated results with prices, ratings, and availability across Fnac's catalog, while get_product_details delivers structured specifications, descriptions, and review counts for any individual product URL.
Product Search and Details
The search_products endpoint accepts a query string (e.g. 'iphone' or 'ordinateur portable'), an optional page integer for pagination, and an optional sort parameter (0 = relevance, 1 = price ascending, 2 = price descending). Each result object includes name, url, price, image_url, rating, review_count, availability, and optionally old_price, brand, and prom (promotional flag). The total_results field returns the raw French count string such as '28 876 résultats'.
get_product_details takes a full Fnac product URL and returns a structured object with price in euros, a specs key-value object covering technical specifications, an HTML-encoded description, rating, review_count, image_url, and a schema.org availability URL. This endpoint is the primary source for machine-readable product specifications.
Reviews and Deals
get_product_reviews accepts the same product URL format and retrieves data from the product's /avis page. Each review object contains author, rating, title, text, origin, and a verified boolean. The endpoint also returns total_reviews as a French-language string (e.g. '382 avis'), aggregate_rating as a decimal string (e.g. '4,5'), and the prid product ID extracted from the URL.
get_bons_plans takes no inputs and returns the current "Bons Plans" listing — discounted products across tech categories including smartphones, headphones, and tablets. Each object in the products array shares the same schema as search results, including old_price where applicable to calculate the markdown.
- Track price changes on specific Fnac products by polling
get_product_detailsand comparing thepriceandold_pricefields over time. - Build a deal aggregator that surfaces discounted French tech products using
get_bons_plansand filters byold_pricepresence. - Aggregate customer sentiment for a product category by collecting
ratingandreview_countacrosssearch_productsresult pages. - Populate a product comparison table with structured
specsandpricedata fromget_product_detailsfor multiple Fnac URLs. - Conduct review analysis by pulling
text,rating, andverifiedfields fromget_product_reviewsacross a set of competitor products. - Monitor Fnac catalog breadth for a specific brand by querying
search_productswith a brand name and readingtotal_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 | 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 Fnac offer an official developer API?+
What does the `get_product_reviews` endpoint return beyond review text?+
author, rating (numeric), title, text, origin (the platform or region associated with the reviewer), and a verified boolean indicating whether the purchase was confirmed. The endpoint also returns the aggregate_rating string and total_reviews count from the product's review page.Does the `search_products` endpoint support filtering by category or price range?+
query, page for pagination, and sort (relevance, price ascending, or price descending). Category filters and price-range parameters are not exposed. You can fork the API on Parse and revise it to add those filtering inputs.Are flash sales or time-limited promotions covered separately from Bons Plans?+
get_bons_plans for general deals with discount data via old_price. Dedicated flash-sale or countdown-timer listings are not currently a separate endpoint. You can fork the API on Parse and revise it to add an endpoint targeting Fnac's flash-sale pages.Is pagination supported across all endpoints?+
search_products accepts a page integer for paginating through results. get_product_reviews, get_product_details, and get_bons_plans return a single page of data per call — multi-page review pagination is not currently exposed. You can fork the API on Parse and revise it to iterate through additional review pages.