{ "openapi": "3.0.1", "info": { "title": "Mercadona ES - Product prices", "description": "Scrapes products and prices from the Mercadona online supermarket by search term, brand or category, for any Spanish postal code or warehouse.", "version": "0.0", "x-build-id": "S5O4BcFrghZdGg8Nb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapingbuddy~mercadona-es-products/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapingbuddy-mercadona-es-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/scrapingbuddy~mercadona-es-products/runs": { "post": { "operationId": "runs-sync-scrapingbuddy-mercadona-es-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/scrapingbuddy~mercadona-es-products/run-sync": { "post": { "operationId": "run-sync-scrapingbuddy-mercadona-es-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": { "searchTerm": { "title": "Search for a product", "type": "string", "description": "One search, like the search box on the Mercadona website. A phrase like \"leche condensada\" is searched as a whole. Returns the same products, in the same order, as the website, up to 100. Combine with categories to keep only results in those categories." }, "brands": { "title": "Keep only these brands", "description": "Only keep search results of these brands, e.g. \"Hacendado\" or [\"Hacendado\", \"Campina\"]; capitalisation is ignored. Filtered like the Mercadona website, from the at most 100 products a search returns. Needs a search term.", "default": [] }, "categories": { "title": "Choose categories to scrape", "type": "array", "description": "Only scrape these categories. Picking a top-level category includes all its subcategories. Leave empty to scrape the whole catalogue.", "items": { "type": "string", "enum": [ "12", "112", "115", "116", "117", "18", "156", "163", "158", "159", "161", "162", "15", "135", "133", "132", "13", "118", "121", "120", "9", "89", "95", "92", "97", "90", "833", "24", "216", "219", "218", "217", "19", "164", "166", "181", "174", "168", "170", "173", "171", "169", "8", "86", "81", "83", "84", "88", "3", "46", "38", "47", "37", "42", "43", "44", "40", "45", "7", "78", "80", "79", "4", "48", "52", "49", "51", "50", "58", "54", "56", "53", "17", "147", "148", "145", "154", "155", "150", "149", "151", "884", "152", "14", "122", "123", "127", "130", "129", "126", "21", "201", "199", "203", "202", "20", "192", "189", "185", "191", "188", "187", "186", "190", "194", "196", "198", "23", "213", "214", "1", "27", "28", "29", "6", "77", "72", "75", "26", "226", "237", "241", "234", "235", "233", "231", "230", "232", "229", "243", "238", "239", "244", "22", "206", "207", "208", "210", "212", "2", "32", "34", "31", "36", "25", "222", "221", "225", "5", "65", "66", "69", "59", "60", "62", "64", "68", "71", "16", "897", "138", "140", "142", "11", "105", "110", "111", "106", "103", "109", "108", "104", "107", "10", "99", "100", "143", "98" ], "enumTitles": [ "Aceite, especias y salsas", "Aceite, especias y salsas › Aceite, vinagre y sal", "Aceite, especias y salsas › Especias", "Aceite, especias y salsas › Mayonesa, ketchup y mostaza", "Aceite, especias y salsas › Otras salsas", "Agua y refrescos", "Agua y refrescos › Agua", "Agua y refrescos › Isotónico y energético", "Agua y refrescos › Refresco de cola", "Agua y refrescos › Refresco de naranja y de limón", "Agua y refrescos › Tónica y bitter", "Agua y refrescos › Refresco de té y sin gas", "Aperitivos", "Aperitivos › Aceitunas y encurtidos", "Aperitivos › Frutos secos y fruta desecada", "Aperitivos › Patatas fritas y snacks", "Arroz, legumbres y pasta", "Arroz, legumbres y pasta › Arroz", "Arroz, legumbres y pasta › Legumbres", "Arroz, legumbres y pasta › Pasta y fideos", "Azúcar, caramelos y chocolate", "Azúcar, caramelos y chocolate › Azúcar y edulcorante", "Azúcar, caramelos y chocolate › Chicles y caramelos", "Azúcar, caramelos y chocolate › Chocolate", "Azúcar, caramelos y chocolate › Golosinas", "Azúcar, caramelos y chocolate › Mermelada y miel", "Azúcar, caramelos y chocolate › Turrones", "Bebé", "Bebé › Alimentación infantil", "Bebé › Biberón y chupete", "Bebé › Higiene y cuidado", "Bebé › Toallitas y pañales", "Bodega", "Bodega › Cerveza", "Bodega › Cerveza sin alcohol", "Bodega › Licores", "Bodega › Sidra y cava", "Bodega › Tinto de verano y sangría", "Bodega › Vino blanco", "Bodega › Vino lambrusco y espumoso", "Bodega › Vino rosado", "Bodega › Vino tinto", "Cacao, café e infusiones", "Cacao, café e infusiones › Cacao soluble y chocolate a la taza", "Cacao, café e infusiones › Café cápsula y monodosis", "Cacao, café e infusiones › Café molido y en grano", "Cacao, café e infusiones › Café soluble y otras bebidas", "Cacao, café e infusiones › Té e infusiones", "Carne", "Carne › Arreglos", "Carne › Aves y pollo", "Carne › Carne congelada", "Carne › Cerdo", "Carne › Conejo y cordero", "Carne › Embutido", "Carne › Hamburguesas y picadas", "Carne › Vacuno", "Carne › Empanados y elaborados", "Cereales y galletas", "Cereales y galletas › Cereales", "Cereales y galletas › Galletas", "Cereales y galletas › Tortitas", "Charcutería y quesos", "Charcutería y quesos › Aves y jamón cocido", "Charcutería y quesos › Bacón y salchichas", "Charcutería y quesos › Chopped y mortadela", "Charcutería y quesos › Embutido curado", "Charcutería y quesos › Jamón serrano", "Charcutería y quesos › Paté y sobrasada", "Charcutería y quesos › Queso curado, semicurado y tierno", "Charcutería y quesos › Queso lonchas, rallado y en porciones", "Charcutería y quesos › Queso untable, fresco y especialidades", "Congelados", "Congelados › Arroz y pasta", "Congelados › Carne", "Congelados › Fruta y verdura", "Congelados › Helados", "Congelados › Hielo", "Congelados › Marisco", "Congelados › Pescado", "Congelados › Pizzas", "Congelados › Rebozados", "Congelados › Tartas y churros", "Conservas, caldos y cremas", "Conservas, caldos y cremas › Atún y otras conservas de pescado", "Conservas, caldos y cremas › Berberechos y mejillones", "Conservas, caldos y cremas › Conservas de verdura y frutas", "Conservas, caldos y cremas › Gazpacho y cremas", "Conservas, caldos y cremas › Sopa y caldo", "Conservas, caldos y cremas › Tomate", "Cuidado del cabello", "Cuidado del cabello › Acondicionador y mascarilla", "Cuidado del cabello › Champú", "Cuidado del cabello › Coloración cabello", "Cuidado del cabello › Fijación cabello", "Cuidado facial y corporal", "Cuidado facial y corporal › Afeitado y cuidado para hombre", "Cuidado facial y corporal › Cuidado corporal", "Cuidado facial y corporal › Cuidado e higiene facial", "Cuidado facial y corporal › Depilación", "Cuidado facial y corporal › Desodorante", "Cuidado facial y corporal › Gel y jabón de manos", "Cuidado facial y corporal › Higiene bucal", "Cuidado facial y corporal › Higiene íntima", "Cuidado facial y corporal › Manicura y pedicura", "Cuidado facial y corporal › Perfume y colonia", "Cuidado facial y corporal › Protector solar y aftersun", "Fitoterapia y parafarmacia", "Fitoterapia y parafarmacia › Fitoterapia", "Fitoterapia y parafarmacia › Parafarmacia", "Fruta y verdura", "Fruta y verdura › Fruta", "Fruta y verdura › Lechuga y ensalada preparada", "Fruta y verdura › Verdura", "Huevos, leche y mantequilla", "Huevos, leche y mantequilla › Huevos", "Huevos, leche y mantequilla › Leche y bebidas vegetales", "Huevos, leche y mantequilla › Mantequilla y margarina", "Limpieza y hogar", "Limpieza y hogar › Detergente y suavizante ropa", "Limpieza y hogar › Estropajo, bayeta y guantes", "Limpieza y hogar › Insecticida y ambientador", "Limpieza y hogar › Lejía y líquidos fuertes", "Limpieza y hogar › Limpiacristales", "Limpieza y hogar › Limpiahogar y friegasuelos", "Limpieza y hogar › Limpieza baño y WC", "Limpieza y hogar › Limpieza cocina", "Limpieza y hogar › Limpieza muebles y multiusos", "Limpieza y hogar › Limpieza vajilla", "Limpieza y hogar › Menaje y conservación de alimentos", "Limpieza y hogar › Papel higiénico y celulosa", "Limpieza y hogar › Pilas y bolsas de basura", "Limpieza y hogar › Utensilios de limpieza y calzado", "Maquillaje", "Maquillaje › Bases de maquillaje y corrector", "Maquillaje › Colorete y polvos", "Maquillaje › Labios", "Maquillaje › Ojos", "Maquillaje › Pinceles y brochas", "Marisco y pescado", "Marisco y pescado › Marisco", "Marisco y pescado › Pescado congelado", "Marisco y pescado › Pescado fresco", "Marisco y pescado › Salazones y ahumados", "Mascotas", "Mascotas › Gato", "Mascotas › Perro", "Mascotas › Otros", "Panadería y pastelería", "Panadería y pastelería › Bollería de horno", "Panadería y pastelería › Bollería envasada", "Panadería y pastelería › Harina y preparado repostería", "Panadería y pastelería › Pan de horno", "Panadería y pastelería › Pan de molde y otras especialidades", "Panadería y pastelería › Pan tostado y rallado", "Panadería y pastelería › Picos, rosquilletas y picatostes", "Panadería y pastelería › Tartas y pasteles", "Panadería y pastelería › Velas y decoración", "Pizzas y platos preparados", "Pizzas y platos preparados › Listo para Comer", "Pizzas y platos preparados › Pizzas", "Pizzas y platos preparados › Platos preparados calientes", "Pizzas y platos preparados › Platos preparados fríos", "Postres y yogures", "Postres y yogures › Bífidus", "Postres y yogures › Flan y natillas", "Postres y yogures › Gelatina y otros postres", "Postres y yogures › Postres de soja", "Postres y yogures › Yogures desnatados", "Postres y yogures › Yogures griegos", "Postres y yogures › Yogures líquidos", "Postres y yogures › Yogures naturales y sabores", "Postres y yogures › Yogures y postres infantiles", "Zumos", "Zumos › Fruta variada", "Zumos › Melocotón y piña", "Zumos › Naranja", "Zumos › Tomate y otros sabores" ] }, "default": [] }, "postalCode": { "title": "Use the warehouse that serves a postal code", "pattern": "^[0-9]{5}$", "type": "string", "description": "Spanish postal code (5 digits). Mercadona uses it to pick the warehouse that serves that area, which sets prices and availability. Set either a postal code or a warehouse, not both." }, "warehouse": { "title": "Choose a warehouse", "type": "string", "description": "Mercadona warehouse code, e.g. mad1, bcn1 or vlc1 (the README lists them by province). Sets prices and availability. Set either a warehouse or a postal code, not both." }, "language": { "title": "Choose the language of names", "enum": [ "es", "vai", "ca", "gl", "eu", "en", "de" ], "type": "string", "description": "Language of the product and category names returned by Mercadona.", "default": "es" }, "includeEan": { "title": "Include EAN and brand", "type": "boolean", "description": "When scraping categories or the whole catalogue, fetch each product's EAN barcode and brand from its page. This is one extra request per product, so a whole-catalogue run is much slower. Turn it off to get listings and prices only. Searches always include the EAN regardless.", "default": 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 } } } } } } } } } }