# EPREL — EU Energy Label Database (etichette energetiche UE) (`promptica/eprel-etichette-energetiche`) Actor Estrae dati pubblici dal registro EPREL della Commissione Europea sulle etichette energetiche: classe, consumi, parametri tecnici, produttore. Utile per e-commerce compliance (Reg. UE 2017/1369). - **URL**: https://apify.com/promptica/eprel-etichette-energetiche.md - **Developed by:** [Lorenzo Talamucci](https://apify.com/promptica) (community) - **Categories:** E-commerce, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## EPREL — EU Energy Label Database Estrae dati pubblici dal **registro EPREL** (European Product Registry for Energy Labelling) della Commissione Europea. EPREL è la fonte ufficiale per le etichette energetiche UE (Regolamento 2017/1369). Produttori e importatori sono obbligati a registrare i propri prodotti prima dell'immissione sul mercato. I dati sono **pubblici e liberamente accessibili** tramite API REST senza autenticazione. L'unico actor precedente disponibile su Apify Store è **deprecato** e non funziona più. ### Categorie supportate | productGroup | Descrizione | Prodotti in EPREL | |---|---|---| | `washingmachines2019` | Lavatrici (EU 2019/2014) | ~23.000 | | `televisions` | Televisori (EU 2019/2013) | ~8.400 | | `airconditioners` | Condizionatori | ~32.000 | | `localspaceheaters` | Riscaldatori locali | ~21.000 | | `dishwashers` | Lavastoviglie (legacy) | ~7.100 | | `lightsources` | Sorgenti luminose | ~632.000 | | `tyres` | Pneumatici | ~292.000 | | `professionalrefrigeratedstorageequipment` | Refrigerazione professionale | — | ### Input | Campo | Tipo | Default | Descrizione | |---|---|---|---| | `productGroup` | string | `washingmachines2019` | Categoria prodotto EPREL | | `brand` | string | `""` | Filtra per marca (parziale, case-insensitive) | | `modelContains` | string | `""` | Filtra per modelIdentifier (parziale) | | `energyClass` | string | `""` | Classe energetica minima (A/B/.../G) | | `statusFilter` | string | `PUBLISHED` | Solo PUBLISHED o tutti | | `maxResults` | integer | 1000 | Limite risultati (0 = nessun limite) | | `pageSize` | integer | 100 | Dimensione pagina API (max 100) | ### Output — esempio record reale Rilevato il 2026-07-11 tramite curl su `https://eprel.ec.europa.eu/api/products/washingmachines2019?page=1&size=1`: ```json { "eprelRegistrationNumber": "352460", "productGroup": "washingmachines2019", "implementingAct": "EU_2019_2014", "supplierOrTrademark": "LG Electronics", "modelIdentifier": "GC3V708S2", "energyClass": "A", "energyEfficiencyIndex": 52, "energyClassRange": "A_G", "status": "PUBLISHED", "onMarketStartDate": "2020-9-24", "onMarketEndDate": "2050-12-31", "registrantNature": "MANUFACTURER", "ratedCapacity": 8, "energyConsPerCycle": 0.473, "energyConsPer100Cycle": 48, "annualEnergyConsumption": null, "noiseClass": "A", "noise": 71, "dimensionWidth": 60, "dimensionHeight": 85, "dimensionDepth": 57, "webLinkSupplier": "https://www.lg.com/global/ajax/common_manual", "eprelUrl": "https://eprel.ec.europa.eu/screen/product/washingmachines2019/352460" } ```` ### Casi d'uso - **E-commerce compliance**: verifica che classe energetica e parametri tecnici sul tuo sito corrispondano al registro ufficiale (obbligo Reg. UE 2021/341) - **Price intelligence**: costruire database prodotti con label energetica per filtri avanzati - **Ricerca di mercato**: analisi distribuzione classi energetiche per categoria/produttore - **Due diligence**: controllo disponibilità sul mercato (`onMarketEndDate`) prima di acquisti B2B ### Note tecniche - **Fonte**: API pubblica EPREL — `https://eprel.ec.europa.eu/api/products/{productGroup}` - **Autenticazione**: nessuna (API pubblica UE) - **ToS**: dati open government, liberamente riutilizzabili (Direttiva PSI / Open Data Directive 2019/1024) - **robots.txt**: `/api/*` non è bloccato - **User-Agent**: identificabile e onesto (es. `apify-eprel-actor/0.1`) — nessuno spoofing di header first-party. Per un accesso stabile su volumi elevati, richiedere accesso ufficiale/API key alla Commissione Europea - **Paginazione**: API restituisce max 100 record per pagina; l'actor itera automaticamente su tutte le pagine - **Memoria**: paginazione senza buffer completo in memoria — footprint costante indipendentemente dal volume - **Retry**: backoff solo su timeout ed errori di rete/5xx. Un `403` è trattato come rifiuto del server e **non** viene forzato con ulteriori tentativi # Actor input Schema ## `productGroup` (type: `string`): Gruppo prodotto EPREL. Es: washingmachines2019, televisions, airconditioners, dishwashers, lightsources, tyres, localspaceheaters. ## `brand` (type: `string`): Filtra per nome marca o trademark. Corrispondenza parziale, case-insensitive. Es: Samsung, Bosch, LG. ## `modelContains` (type: `string`): Filtra per stringa nel modelIdentifier. Es: WM4 filtra tutti i modelli che contengono WM4. ## `energyClass` (type: `string`): Restituisce solo prodotti con questa classe energetica o migliore. Scala A-G (o A+ / AP per prodotti legacy). Lascia vuoto per tutte le classi. ## `statusFilter` (type: `string`): Filtra per stato EPREL del prodotto. ## `maxResults` (type: `integer`): Limite massimo di record da estrarre. 0 = nessun limite. ## `pageSize` (type: `integer`): Numero di record per chiamata API. Default 100, max 100. ## Actor input object example ```json { "productGroup": "washingmachines2019", "brand": "", "modelContains": "", "energyClass": "", "statusFilter": "PUBLISHED", "maxResults": 1000, "pageSize": 100 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("promptica/eprel-etichette-energetiche").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("promptica/eprel-etichette-energetiche").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call promptica/eprel-etichette-energetiche --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=promptica/eprel-etichette-energetiche", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "EPREL — EU Energy Label Database (etichette energetiche UE)", "description": "Estrae dati pubblici dal registro EPREL della Commissione Europea sulle etichette energetiche: classe, consumi, parametri tecnici, produttore. Utile per e-commerce compliance (Reg. UE 2017/1369).", "version": "0.1", "x-build-id": "IUwgCwXkUTI9nXgEN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/promptica~eprel-etichette-energetiche/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-promptica-eprel-etichette-energetiche", "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/promptica~eprel-etichette-energetiche/runs": { "post": { "operationId": "runs-sync-promptica-eprel-etichette-energetiche", "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/promptica~eprel-etichette-energetiche/run-sync": { "post": { "operationId": "run-sync-promptica-eprel-etichette-energetiche", "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": [ "productGroup" ], "properties": { "productGroup": { "title": "Categoria prodotto (product group)", "enum": [ "washingmachines2019", "washingdryingmachines2019", "tumbledriers2019", "dishwashers2021", "dishwashers", "refrigeratingappliances2021", "televisions", "airconditioners", "localspaceheaters", "lightsources", "tyres", "professionalrefrigeratedstorageequipment" ], "type": "string", "description": "Gruppo prodotto EPREL. Es: washingmachines2019, televisions, airconditioners, dishwashers, lightsources, tyres, localspaceheaters.", "default": "washingmachines2019" }, "brand": { "title": "Marca / brand (filtro parziale)", "type": "string", "description": "Filtra per nome marca o trademark. Corrispondenza parziale, case-insensitive. Es: Samsung, Bosch, LG.", "default": "" }, "modelContains": { "title": "Modello contiene (filtro parziale)", "type": "string", "description": "Filtra per stringa nel modelIdentifier. Es: WM4 filtra tutti i modelli che contengono WM4.", "default": "" }, "energyClass": { "title": "Classe energetica minima", "enum": [ "", "A", "B", "C", "D", "E", "F", "G" ], "type": "string", "description": "Restituisce solo prodotti con questa classe energetica o migliore. Scala A-G (o A+ / AP per prodotti legacy). Lascia vuoto per tutte le classi.", "default": "" }, "statusFilter": { "title": "Stato registrazione", "enum": [ "PUBLISHED", "ALL" ], "type": "string", "description": "Filtra per stato EPREL del prodotto.", "default": "PUBLISHED" }, "maxResults": { "title": "Numero massimo di risultati", "minimum": 0, "maximum": 500000, "type": "integer", "description": "Limite massimo di record da estrarre. 0 = nessun limite.", "default": 1000 }, "pageSize": { "title": "Dimensione pagina API (avanzato)", "minimum": 1, "maximum": 100, "type": "integer", "description": "Numero di record per chiamata API. Default 100, max 100.", "default": 100 } } }, "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 } } } } } } } } } } ```