{ "openapi": "3.0.1", "info": { "title": "Mercadona Product and Price Tracker (Spain)", "description": "Mercadona's online supermarket catalogue in Spain: every product with price, previous price, price per kg or litre, VAT, category path, pack size, photo and URL, for any of six regional warehouses - and whether each product is new, cheaper or dearer than on the last run.", "version": "0.1", "x-build-id": "zSv4ozu81NX36pi3Y" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/superslowsloth~mercadona-products/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-superslowsloth-mercadona-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~mercadona-products/runs": { "post": { "operationId": "runs-sync-superslowsloth-mercadona-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~mercadona-products/run-sync": { "post": { "operationId": "run-sync-superslowsloth-mercadona-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": { "categoryIds": { "title": "Category ids", "type": "array", "description": "Mercadona category ids to read, as numbers or numeric text. A top-level id (1 Fruta y verdura, 3 Carne, 12 Aceite, especias y salsas) reads all of its sub-categories; a sub-category id (27 Fruta, 43 Embutido) reads just that one. Every row carries top_category_id and category_id, so a first run shows you which ids to use. Leave empty to read the whole catalogue: 26 top-level categories, 152 sub-categories, about 4,300 products.", "items": { "type": "string" } }, "warehouse": { "title": "Warehouse (region)", "enum": [ "vlc1", "bcn1", "mad1", "mad2", "alc1", "svq1" ], "type": "string", "description": "Which Mercadona warehouse's prices and range to read. Mercadona prices and stocks per warehouse: against Valencia, Barcelona repriced 22 of the 43 products in category 27 and Madrid 24 (measured 2026-10-07). Only these six answered with a catalogue; any other code is silently answered with Valencia's, so this actor refuses it rather than label Valencia prices as another region. City names are inferred from the code prefix.", "default": "vlc1" }, "language": { "title": "Language of names", "enum": [ "es", "en", "ca" ], "type": "string", "description": "Language of product and category names. Spanish is the default; English and Catalan are translated by Mercadona itself. Prices are the same in every language.", "default": "es" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many products. The walk goes through the sub-categories in Mercadona's own order, so the default of 100 returns the first few categories only - raise it to 5000 to cover the whole catalogue.", "default": 100 }, "changesOnly": { "title": "Only new and re-priced products", "type": "boolean", "description": "Return (and charge for) only products that are new to this watch, or whose price changed, since the last run with the same warehouse and category ids; unchanged ones are skipped and cost nothing. The FIRST run has nothing to compare against, so it labels every product new and returns them all. The memory is kept either way, so a normal run's change column is always filled.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify datacenter proxy is the default and is what this actor was probed on: Mercadona's API answered an Apify datacenter exit with the full JSON on 2026-10-06. A proxy is what lets a refused request be retried from a fresh address. The API also answers a plain home connection.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }