{ "openapi": "3.0.1", "info": { "title": "Tienda Solar Catalog Scraper", "description": "Scrape the full tienda-solar.es catalog (solar panels, inverters, batteries, kits) in 6 languages with per-market prices. Filter by category and brand. Clean JSON-LD, no proxy.", "version": "0.2", "x-build-id": "R9eavxMhGfXILpnAx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rastriq~tienda-solar-catalog-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rastriq-tienda-solar-catalog-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/rastriq~tienda-solar-catalog-scraper/runs": { "post": { "operationId": "runs-sync-rastriq-tienda-solar-catalog-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/rastriq~tienda-solar-catalog-scraper/run-sync": { "post": { "operationId": "run-sync-rastriq-tienda-solar-catalog-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": { "languages": { "title": "Languages", "type": "array", "description": "Which language storefronts to scrape. Prices and product names differ per market. Each language holds ~1,060 products.", "items": { "type": "string", "enum": [ "es", "en", "fr", "de", "it", "pt" ], "enumTitles": [ "Spanish", "English", "French", "German", "Italian", "Portuguese" ] }, "default": [ "es" ] }, "maxProducts": { "title": "Max products", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Maximum number of products to extract across all selected languages and filters. Use a low value (5-10) for your first test run. Leave empty to scrape everything." }, "categories": { "title": "Categories", "type": "array", "description": "Select one or more product categories to scrape. Labels show English / Español and the product count. Leave empty for all categories. Category is resolved from the Spanish storefront so it applies to every selected language.", "items": { "type": "string", "enum": [ "inversores-solares", "baterias-de-litio", "accesorios", "inversores-hibridos", "baterias", "instalacion-fotovoltaica-aislada", "paneles-solares", "regulador-solar", "placas-fotovoltaicas", "baterias-agm", "inversores-conexion-a-red", "microinversores", "reguladores-de-carga-solar", "productos", "kit-solar", "estructura-paneles-solares", "material-electrico", "cargadores-electricos", "acumuladores-estacionarios", "baterias-de-gel", "sai-ups", "optimizadores", "aire-acondicionado", "kits-para-balcon", "calentadores-de-agua-solar", "baterias-efb", "eficiencia-energetica", "iluminacion-led", "bombeo-solar", "baterias-de-plomo-carbono", "convertidores-dc-dc", "accesorios-controladores", "cargadores-baterias", "inversores-cargadores-48v-230v", "productos-destacados" ], "enumTitles": [ "Solar Inverters / Inversores Solares (292)", "Lithium Batteries / Baterías de Litio (89)", "Accessories / Accesorios (84)", "Hybrid Inverters / Inversores Híbridos (81)", "Batteries / Baterías (58)", "Off-Grid Inverters / Instalación Aislada (45)", "Solar Panels / Paneles Solares (44)", "Charge Controllers / Reguladores (43)", "Photovoltaic Panels / Placas Fotovoltaicas (40)", "AGM Batteries / Baterías AGM (39)", "Grid-Connected Inverters / Inversores Conexión a Red (38)", "Microinverters / Microinversores (20)", "Solar Charge Controllers / Reguladores de Carga Solar (19)", "Misc Products / Productos varios (18)", "Solar Kits / Kit Solar (18)", "Mounting Structures / Estructuras para Paneles (18)", "Electrical Equipment / Material Eléctrico (17)", "EV Chargers / Cargadores Eléctricos (16)", "Stationary Batteries / Acumuladores Estacionarios (15)", "Gel Batteries / Baterías de GEL (15)", "UPS / SAI (10)", "Optimisers / Optimizadores (9)", "Air Conditioning / Aire Acondicionado (6)", "Balcony Kits / Kits para Balcón (6)", "Solar Water Heating / Calentadores de Agua Solar (4)", "EFB Batteries / Baterías EFB (3)", "Energy Efficiency / Eficiencia Energética (2)", "LED Lighting / Iluminación LED (2)", "Solar Pumping / Bombeo Solar (2)", "Lead-Carbon Batteries / Baterías de Plomo-Carbono (2)", "DC/DC Converters / Convertidores DC/DC (1)", "Controller Accessories / Accesorios de Controladores (1)", "Battery Chargers / Cargadores de Baterías (1)", "Inverter Chargers 48V-230V / Inversores Cargadores 48V-230V (1)", "Featured Products / Productos Destacados (1)" ] }, "default": [] }, "brands": { "title": "Brands", "type": "array", "description": "Select or type one or more manufacturer brands to keep. Leave empty for all brands. Matching is case-insensitive. You can type a brand that is not in the list.", "items": { "type": "string", "enumSuggestedValues": [ "Victron", "TIENDA SOLAR", "SolaXPower", "Fronius", "Kaise", "SolarEdge", "SMA", "GoodWe", "Huawei", "Studer", "Deye", "PVSTAR", "SAJ", "Pylontech", "Voltronic Power", "V TAC", "Weidmüller", "LONGi Solar", "BYD", "ENPHASE", "Trina Solar", "Enersys", "SUNGROW", "JA Solar", "Jinko", "Salicru", "Steca", "Kostal", "Fischer", "TBS", "Dyness", "Solis", "Growatt", "APSystems", "FQS Battery", "FoxESS", "Trojan", "Mitsubishi", "SunEnergy XT", "Tongwei Solar", "POWER", "Sunwoda", "AIKO", "Morningstar", "Ingeteam", "LG", "Hyundai Energy Solutions", "TESLA", "SolarSpace", "Outback", "Solahart", "EFERGY", "Simon", "Wallbox", "Azzurro ZCS", "FuturaSun", "EPSolar", "TS", "Danfoss", "Canadian solar", "Risen Energy", "LEAPTON", "BMZ", "Tigo Energy", "Jinergy", "Halo", "Shurflo", "Cegasa", "BSLBatt", "TBB Power", "HANERSUN" ] }, "default": [] }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 30, "type": "integer", "description": "Number of product pages fetched in parallel. 8 is safe and fast.", "default": 8 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. The site does not require a proxy; enable only for very large jobs to spread requests across IPs." } } }, "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 } } }, "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 } } } } } } } } } }