{ "openapi": "3.0.1", "info": { "title": "Monoprix Grocery Price & Promotion Scraper (France)", "description": "Scrape Monoprix groceries (courses.monoprix.fr) by category URL or keyword: one row per product with price in EUR, unit price per kg or litre, offer wording parsed into percent and amount, brand, pack size, rayon path, image and URL. For French grocery price and promotion watching.", "version": "0.1", "x-build-id": "XsTfBw4mIyVZ0zRgd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/superslowsloth~monoprix-products/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-superslowsloth-monoprix-products", "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/superslowsloth~monoprix-products/runs": { "post": { "operationId": "runs-sync-superslowsloth-monoprix-products", "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/superslowsloth~monoprix-products/run-sync": { "post": { "operationId": "run-sync-superslowsloth-monoprix-products", "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": { "categoryUrls": { "title": "Category (rayon) URLs", "type": "array", "description": "Monoprix rayon pages from courses.monoprix.fr, one per line, for example https://courses.monoprix.fr/categories/bio/5b5c3312-5e79-47bf-b4ea-89a285e58d5c. The category id on its own also works. A rayon includes everything under it (Bio lists all 1,462 products of its 14 sub-rayons). The Promotions rayon lists every product currently on offer (1,326 on 2026-10-27). www.monoprix.fr is a different, non-grocery site and is not accepted.", "items": { "type": "string" } }, "searchTerms": { "title": "Search terms", "type": "array", "description": "What you would type into the Monoprix search box, one term per line (for example lait, café moulu or Bonne Maman). Each term is searched separately and cut to 50 characters, as the site does. Used together with or instead of category URLs.", "items": { "type": "string" } }, "maxItems": { "title": "Max products per category or search term", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Read at most this many products for each category URL and each search term. Monoprix serves up to 1,000 per page for a category and 300 for a search. Up to 10,000 accepted; the largest rayon measured (Hygiène & Beauté) has 5,267.", "default": 200 }, "sort": { "title": "Sort order", "enum": [ "relevance", "price-asc", "price-desc", "unit-price-asc", "unit-price-desc" ], "type": "string", "description": "The order Monoprix lists the products in. 'Relevance' is its own default. Monoprix sorts within groups: a sponsored product (flagged is_sponsored) comes first, then products on offer, then the rest, so a price sort is ordered inside each group, not across the whole list.", "default": "relevance" }, "onlyOnPromotion": { "title": "Only products on offer", "type": "boolean", "description": "Return only products that carry an offer (remise immédiate, 2ème à -50%, cagnotté and so on). Products without one are skipped and not charged. maxItems then counts offer rows only.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Residential is what works. Monoprix sits behind AWS WAF: measured 2026-10-27 on its product-list API, Apify residential exits passed 10 of 10 and datacenter exits 4 of 10 (the rest HTTP 403). A refused request (202 challenge, 403, 429) is retried from a fresh address.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }