{
  "openapi": "3.0.1",
  "info": {
    "title": "Fnac Scraper - Products, Prices, Variants & Reviews",
    "description": "Scrape Fnac (fnac.com) products: current price plus strike-through discount, colour/model variant matrix, brand, breadcrumb category, and the site's own reviews with rating. Search by keyword/category or paste product and search-result links.",
    "version": "1.2",
    "x-build-id": "Hq73UwEldOgxGYFHN"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/abotapi~fnac-com-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-abotapi-fnac-com-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/abotapi~fnac-com-scraper/runs": {
      "post": {
        "operationId": "runs-sync-abotapi-fnac-com-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/abotapi~fnac-com-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-abotapi-fnac-com-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",
        "required": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "🎯 Mode",
            "enum": [
              "search",
              "url"
            ],
            "type": "string",
            "description": "'search' finds products by keyword and/or category using fnac.com's own search. 'url' scrapes any product or search-result-listing page URL you paste, walking pagination forward automatically.",
            "default": "search"
          },
          "searchTerm": {
            "title": "🔎 Search keyword",
            "type": "string",
            "description": "Free-text keyword, e.g. 'iphone 14' or 'ps5'. Uses fnac.com's own product search."
          },
          "category": {
            "title": "🗂 Category",
            "type": "string",
            "description": "A category/rayon name, e.g. 'smartphones', 'livres', 'console ps5'. Combined with Search keyword above into fnac.com's own free-text search (fnac.com does not expose a separate path-based category browse the way some catalog sites do). Search mode only: it is written into fnac.com's own search URL, so a pasted URL keeps whatever it already carries."
          },
          "sortBy": {
            "title": "↕️ Sort order",
            "enum": [
              "RELEVANCE",
              "PRICE_ASC",
              "PRICE_DESC",
              "BEST_SELLERS",
              "TOP_RATED"
            ],
            "type": "string",
            "description": "fnac.com's own sort order, verified live to reorder the full server-side result set. Search mode only: it is written into fnac.com's own search URL, so a pasted URL keeps whatever it already carries.",
            "default": "RELEVANCE"
          },
          "urls": {
            "title": "🔗 URLs to scrape",
            "uniqueItems": true,
            "type": "array",
            "description": "Paste one or more fnac.com product pages (including a bare /a<id> link), category pages or search-result-listing pages. Left unedited, this field scrapes one example of each link shape. Pagination continues forward automatically from any PageIndex= already in the URL. Search-mode fields are ignored here. The fields in the Filters section still apply, including to a pasted product URL.",
            "default": [
              "https://www.fnac.com/SearchResult/ResultList.aspx?Search=iphone",
              "https://www.fnac.com/SearchResult/ResultList.aspx?Search=iphone&PageIndex=2",
              "https://www.fnac.com/SearchResult/ResultList.aspx?Search=casque&f=attributes.brand__Marque-Apple&SortTypes=LowestPrice",
              "https://www.fnac.com/Apple-iPhone-15-6-1-5G-Double-SIM-128-Go-Noir/a18573408/w-4",
              "https://www.fnac.com/mp54113208/Apple-iPhone-16-6-1-5G-128-Go-e-SIM-Rose/w-4",
              "https://www.fnac.com/Apple-iMac-Mac-Mac-Mini-Mac-Pro/shi352415/w-4",
              "https://www.fnac.com/Accessoires-Apple-Watch/Apple-Watch/nsh558378/w-4",
              "https://www.fnac.com/a21960704"
            ],
            "items": {
              "type": "string"
            }
          },
          "brands": {
            "title": "🏷 Brands",
            "uniqueItems": true,
            "type": "array",
            "description": "Only return products from these brands, e.g. 'Apple'. Search mode runs one pass per brand through fnac.com's own brand filter; every brand is also re-checked on the product page value when known. Leave empty for all brands. Applies in BOTH search mode and URL mode.",
            "items": {
              "type": "string"
            }
          },
          "searchTerms": {
            "title": "🔎 Search terms (several)",
            "type": "array",
            "description": "Extra keywords for search mode, each searched in turn alongside 'searchTerm'. Duplicates are skipped.",
            "items": {
              "type": "string"
            }
          },
          "soldByFnac": {
            "title": "🏬 Sold by Fnac only",
            "type": "boolean",
            "description": "Keep only offers sold by Fnac itself, using the seller type the site shows on every listing card and product page; offers whose seller is not known yet are kept. Applies in BOTH search mode and URL mode.",
            "default": false
          },
          "condition": {
            "title": "🆕 Condition",
            "enum": [
              "any",
              "new",
              "refurbished"
            ],
            "type": "string",
            "description": "any, new, or refurbished. 'refurbished' means any second-hand or refurbished offer: a graded used offer (like-new, very-good, good, acceptable) or a product labelled 'Reconditionné'; 'new' drops all of those. Applies in BOTH search mode and URL mode.",
            "default": "any"
          },
          "inStockOnly": {
            "title": "📦 In stock only",
            "type": "boolean",
            "description": "Drop products the listing card or product page marks as unavailable (for example 'Ce produit n'est plus en vente'). Applies in BOTH search mode and URL mode.",
            "default": false
          },
          "minPrice": {
            "title": "💶 Minimum price (EUR)",
            "type": "number",
            "description": "Only return products priced at or above this amount, in euros. Applies in BOTH search mode and URL mode, including a pasted product URL."
          },
          "maxPrice": {
            "title": "💶 Maximum price (EUR)",
            "type": "number",
            "description": "Only return products priced at or below this amount, in euros. Applies in BOTH search mode and URL mode, including a pasted product URL."
          },
          "specialsOnly": {
            "title": "🔥 Discounted items only",
            "type": "boolean",
            "description": "Only return products currently showing a genuine strike-through discount against fnac.com's own reference price (verified live against real price data -- never a guess). Combines with the keyword/category above. Applies in BOTH search mode and URL mode, including a pasted product URL.",
            "default": false
          },
          "fetchDetails": {
            "title": "📄 Fetch full product detail",
            "type": "boolean",
            "description": "Adds full description (text and HTML), EAN/MPN/SKU, breadcrumb category path, complete flattened characteristics (spec sheet -- every field the product page shows, not a fixed list), image gallery, the colour/model variant matrix, seller identity and rating, the other sellers' offers (price, condition grade, delivery), delivery, warranty options, energy label, repairability and durability scores, eco-participation taxes and included accessories from the product page. Current price, was-price/discount, rating and card image are already included without this toggle.",
            "default": false
          },
          "fetchReviews": {
            "title": "⭐ Fetch reviews",
            "type": "boolean",
            "description": "Fetch the product's own reviews (not a third-party vendor): overall rating, total rating count, and the page's own recent individual written reviews (rating, title, body, author, date, verified-purchase). fnac.com only ever surfaces its most recent reviews per product page; products with no reviews simply return an empty list.",
            "default": true
          },
          "maxReviewsPerProduct": {
            "title": "⭐ Max reviews per product",
            "minimum": 0,
            "type": "integer",
            "description": "Cap on written reviews fetched per product when 'Fetch reviews' is on, up to the site's own per-page limit (fnac.com serves at most 10 written reviews on a product page, so the real count is often lower). Values above 100 are treated as 100.",
            "default": 20
          },
          "maxPages": {
            "title": "📑 Max pages per search",
            "minimum": 0,
            "type": "integer",
            "description": "Stop after this many result pages per search/URL entry. Leave empty for no page limit -- the run stops at Max products total."
          },
          "maxItems": {
            "title": "🔢 Max products total",
            "minimum": 0,
            "type": "integer",
            "description": "Hard cap on total products returned across every search/URL entry. 0 = unlimited (still bounded by Max pages per search).",
            "default": 20
          },
          "proxy": {
            "title": "🌐 Proxy configuration",
            "type": "object",
            "description": "Proxy configuration. The default works on every Apify plan, including the free tier. Change it only if you need a specific country or are running very large jobs.",
            "default": {
              "useApifyProxy": true
            }
          },
          "resumeFromRunId": {
            "title": "🔁 Resume from a previous run",
            "type": "string",
            "description": "Paste a previous run ID or dataset ID to continue a large crawl of products without returning or charging for products already collected there. Use this after an interrupted run, or when continuing a product pull in another run. For recurring monitoring of the same search, use Incremental mode below instead."
          },
          "incrementalMode": {
            "title": "🔁 Incremental changes for scheduled runs",
            "type": "boolean",
            "description": "Turn this on for daily or recurring monitoring. The first run returns all matching products as NEW. Later runs normally return only NEW, UPDATED, and REAPPEARED products. Turn on \"Emit unchanged\" or \"Emit expired\" only when you also want those products returned (and billed). State is kept separately for each mode/search-or-URL/filter setup; use State key when you want to name or deliberately share a monitoring campaign. To continue one specific interrupted run instead, use Resume from a previous run above.",
            "default": false
          },
          "stateKey": {
            "title": "🔑 State key (optional, incremental mode only)",
            "type": "string",
            "description": "Optional. Name this monitoring campaign to keep its state stable, or to deliberately share state across differently-configured runs. Leave empty to let the actor derive a key automatically from the mode, search/URL and filter settings -- different searches then never mix state with each other."
          },
          "emitUnchanged": {
            "title": "♻️ Emit unchanged products (incremental mode only)",
            "type": "boolean",
            "description": "Off by default. Turn on to also return products that have not changed since the last run, marked UNCHANGED. This returns -- and bills -- extra rows you already have, so leave it off unless you specifically want the full snapshot every run.",
            "default": false
          },
          "emitExpired": {
            "title": "⌛ Emit expired products (incremental mode only)",
            "type": "boolean",
            "description": "Off by default. Turn on to also return products that were present in a previous run but are no longer found, marked EXPIRED. Only produced once a run has fully scanned every tracked search/URL -- not when Max products capped it or when Resume was used. This returns -- and bills -- extra synthetic rows, so leave it off unless you need expiry tracking.",
            "default": false
          },
          "ignoreFieldsForChanges": {
            "title": "🙈 Ignore fields when detecting changes (incremental mode only)",
            "type": "array",
            "description": "Optional. Field names that must NOT count as a change in incremental mode, for example \"price\" or \"availability\". A product whose only differences are in these fields is treated as UNCHANGED, so it is not returned or billed as UPDATED. Names match at any nesting depth. The fields still appear in the output of rows that are returned.",
            "items": {
              "type": "string"
            }
          },
          "mcpConnectors": {
            "title": "🔌 Pipe results into your apps (optional)",
            "type": "array",
            "description": "Optionally send the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify -> Settings -> Integrations, then select it here. The connector receives a condensed, human-readable summary per item (title + key fields), not the full JSON; the complete record stays in the dataset. Leave empty to skip. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com)."
          },
          "notionParentPageUrl": {
            "title": "📝 Notion parent page (Notion connector only)",
            "type": "string",
            "description": "URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors."
          },
          "maxNotifyListings": {
            "title": "🔢 Max items to export per connector",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Cap on items written to each connector per run. Does not affect the dataset.",
            "default": 50
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}