{ "openapi": "3.0.1", "info": { "title": "Fnac Scraper 💰 From $0.9/1K | Products, Prices & EAN", "description": "Scrape fnac.com products, prices, EAN codes, specs, ratings, reviews and marketplace offers. Monitor French retail prices, track competitor sellers and build product databases, fast or full detail.", "version": "0.1", "x-build-id": "cp5nfbnzSIS2V9jXh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ahmed_jasarevic~fnac-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ahmed_jasarevic-fnac-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/ahmed_jasarevic~fnac-scraper/runs": { "post": { "operationId": "runs-sync-ahmed_jasarevic-fnac-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/ahmed_jasarevic~fnac-scraper/run-sync": { "post": { "operationId": "run-sync-ahmed_jasarevic-fnac-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords to search on fnac.com (e.g. \"iphone 15\", \"lego technic\"). Each term opens a search listing and products are extracted from it.", "items": { "type": "string" } }, "productUrls": { "title": "Product URLs", "type": "array", "description": "Direct fnac.com product URLs (containing /a123... or /mp123...) to scrape in full detail.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Any fnac.com search, category or product URLs to start from. Product pages are auto-detected by URL.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "fields": { "title": "Extraction depth", "enum": [ "listing", "full" ], "type": "string", "description": "Where product data comes from. \"listing\" (default): parsed directly from the search/category result cards — title, brand, price, crossed-out price, availability, in-stock flag, condition, seller, rating, review count, the card's main specs, image and the lowest marketplace offer. Only the listing pages are fetched: a 40-item run is a handful of requests, finishes in seconds and costs roughly $0.01 of proxy. ean, sku, mpn, description, the full spec table and review texts stay null (direct productUrls are still parsed in full). \"full\": also fetches every product page for complete data — EAN/GTIN, description, full spec table, marketplace offer list, review sample — about 50 requests, ~$0.15, 60-110 seconds. Each saved full item is billed as the premium `full-result` pay-per-event charge (see README, Pricing).", "default": "listing" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of products to save. Free users are capped at 10 items regardless.", "default": 100 }, "maxPagesPerQuery": { "title": "Max pages per search/category", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many listing pages to follow per search term or category (pagination cap).", "default": 3 }, "maxRequestsPerCrawl": { "title": "Max requests per crawl", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Hard cap on total HTTP requests for the whole run (protects your compute budget).", "default": 300 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many pages to fetch in parallel. All search-term listings start at once and product pages join at this full concurrency (autoscaler floor: min(15, value)). The HTTP tier through Unblocker is light, so 25-40 is the sweet spot: a 40-product run finishes in roughly one minute at 30.", "default": 30 }, "fetchOffers": { "title": "Fetch marketplace offers", "type": "boolean", "description": "Include the marketplace offer list (seller, price, condition, shipping) in each product.", "default": true }, "fetchReviews": { "title": "Fetch on-page reviews", "type": "boolean", "description": "Include the customer reviews shown on the product page (rating summary always included).", "default": true }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Select the FAST proxy tier. Runs are tiered: your group here (default RESIDENTIAL, France) is tried first because it is fast and cheap, and when fnac's edge blocks it the crawler automatically shifts to Apify's Unblocker bypass tier (France) and probes back when the block lifts. The group you pick only changes the fast tier; Unblocker always stays as the fallback. Turn Apify proxy off only if you supply your own proxy URLs." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }