New upcoming recommendations feature!
Introduction
The NET2GRID Customer Engagement API provides personalized energy-saving recommendations based on a user's consumption patterns, peer comparison, and disaggregation categories. These recommendations help users take actionable steps to reduce their energy usage and optimize efficiency.
Example 1 (App output)
Example 2
You are using 17% more energy for space heating than similar households. Installing a smart thermostat can optimize heating, reduce waste, and save up to 237 kWh.
Implementation Considerations
Recommendations list (IDs)
Each recommendation is referenced by an ID that corresponds to a predefined energy-saving action. The App is responsible for constructing the final recommendation text using the mapped descriptions.
| ID | Category | Short description | Type |
|---|---|---|---|
| T10 | Always On | Turn off appliances completely after use. | Behaviour change |
| T30 | Always On | Use power strips to easily switch off multiple appliances after use. | Small investment |
| T20 | Always On | Turn off as many appliances as possible when you go on holiday. | Behaviour change |
| T200 | Laundry | Wait until you have a full load before turning on your washing machine. | Behaviour change |
| T210 | Laundry | Use a low temperature or eco programme that is tuned to work effectively. Most energy is used for heating up water. | Settings |
| T290 | Laundry | Purchase a more efficient washing machine. | Investment |
| T230 | Laundry | Make use of nice weather, dry your clothes outside. | Behaviour change |
| T250 | Laundry | Try to avoid overdrying your clothes. Choose the appropriate programme. | Settings |
| T270 | Laundry | Clean the filter of your dryer regularly. A dirty filter blocks the airflow causing your dryer to use more energy. | Maintenance |
| T280 | Laundry | Use eco balls in your dryer. They create gaps in your laundry and let the air move around easier. | Small investment |
| T300 | Laundry | Purchase a more efficient dryer. | Investment |
| T50 | Laundry | Use a low temperature or eco programme that is tuned to work effectively. Most energy is used for heating up water. | Settings |
| T60 | Laundry | Wait until you have a full load before turning on your dishwasher. | Behaviour change |
| T80 | Laundry | Purchase a more efficient dishwasher. | Investment |
| T90 | Cooking | Keep the oven door closed as much as possible while using the oven. | Behaviour change |
| T150 | Cooking | Turn off the oven a little earlier. Many dishes will carry on cooking while the oven cools down slowly. | Behaviour change |
| T100 | Cooking | Use a microwave for small cooking tasks instead of the oven. | Behaviour change |
| T110 | Cooking | Use a lid on your pan. This helps to keep the heat inside your pan as much as possible. | Behaviour change |
| T130 | Cooking | You only need one ring for cooking, if you use a steamer or segmented pan for cooking your vegetables. | Small investment |
| T140 | Cooking | Choose the right size cooking ring and check that the flame does not exceed the pan you use for cooking. | Behaviour change |
| T160 | Cooking | Most vegetables can be boiled in a 1-2 cm layer of water. | Behaviour change |
| T120 | Cooking | Use an electric kettle to boil water for cooking instead of a pan on the hob. | Behaviour change |
| T340 | Lighting | Replace old light bulbs or halogen lights by energy efficient LED lamps. | Small investment |
| T330 | Lighting | Switch off your lighting when you leave the room. | Behaviour change |
| T310 | Lighting | Add a timer to your outdoor lighting. | Small investment |
| T360 | Refrigeration | Don't leave the doors of your refrigeration appliances open unnecessarily. | Behaviour change |
| T380 | Refrigeration | Let hot food cool down first before putting it in the fridge. | Behaviour change |
| T390 | Refrigeration | Regularly check the rubber edges of your refrigeration appliances. They may no longer seal properly, allowing cold air to escape. | Maintenance |
| T400 | Refrigeration | Defrost your freezer regularly. It is already worth defrosting your freezer from 0.5 cm of ice. | Maintenance |
| T410 | Refrigeration | Regularly dust the condenser coils at the back of your fridge and freezer. | Maintenance |
| T420 | Refrigeration | Check the temperature of your fridge and adjust if necessary: 4 to 6°C is ideal for fridges. | Settings |
| T430 | Refrigeration | Purchase more efficient refrigeration appliances. | Investment |
| T440 | Refrigeration | Leave about 10 cm of space behind your refrigeration appliances. | Maintenance |
| T350 | Refrigeration | Do you really need your second fridge? Especially old models are real energy guzzlers. | Behaviour change |
| T450 | Refrigeration | Consider buying a larger fridge so you no longer need a second appliance. One large fridge is more economical than two smaller ones. | Investment |
| T460 | Refrigeration | Do you insist on keeping your second fridge for parties and barbecues? Unplug it and turn it on only when you need it. Don't forget to unplug it again afterwards. | Behaviour change |
| T260 | Pool pump | Upgrade to a more efficient pool pump for swimming pools. | Behaviour change |
| T470 | Space heating | It is a waste to heat rooms when you are not around. Leave the heating off in the rooms you don't go much. | Behaviour change |
| T480 | Space heating | Keep the doors closed so that heat does not escape from the living room. | Behaviour change |
| T500 | Space heating | Do doors often stay open unnoticed? Then buy a door spring or door closer for a few euros. This will close the door automatically. | Small investment |
| T520 | Space heating | In bedrooms, leave the heating off. Use an extra blanket or warm your bed with a warm hot water bottle or electric blanket. | Behaviour change |
| T540 | Space heating | Don't set the thermostat higher than 19 degrees. Were you already doing that? Then see if you can go down another degree. | Behaviour change |
| T550 | Space heating | If you are active in the house for longer, you can turn down the heating a degree lower. | Behaviour change |
| T560 | Space heating | Set the thermostat to 15 degrees at night. Do this as early as an hour before you go to sleep: as your house cools down slowly. | Behaviour change |
| T370 | Space heating | Set the thermostat to 6 degrees when you go away for a few days. | Behaviour change |
| T580 | Space heating | Install a smart thermostat. | Small investment |
| T570 | Space heating | Install thermostatic radiator valves. | Small investment |
| T510 | Space heating | Let the heated air around your radiators circulate sufficiently. Don't block this with curtains or furniture. | Behaviour change |
| T490 | Space heating | Draught excluders might help to keep the warmth inside your home. | Small investment |
| T530 | Space heating | Close your curtains when it is cold at night. This will keep the warmth in the room. | Behaviour change |
| T320 | Space heating | Are your curtains blocking your radiator? Shorten them and let the warmth flow freely into your room—don't let your heat get trapped! | Small investment |
| T610 | Space heating | Insulating your walls, either externally or internally, can help reduce heating costs and keep your home cool in summer. | Investment |
| T620 | Space heating | Is your radiator on an uninsulated outside wall? Place radiator foil between the radiator and wall to reduce heat loss. | Behaviour change |
| T590 | Space heating | Do you have a radiator with 2 or 3 plates? Then attach a radiator fan under the radiator. This will blow heat into the room, making it feel warmer faster. | Behaviour change |
| T650 | Space heating | Replacing single glass windows with double or tripple glass will help to save on heating costs and in the summer to keep your home cool. | Investment |
| T600 | Space heating | Do you have single or double glazing and can't replace it right away? Then window film could be a solution. This will improve the insulating effect of the glass. | Behaviour change |
| T630 | Space heating | The temperature of the hot water is usually set at 80 degrees, but can safely be set to a lower temperature. Do not go lower than 60 degrees, as you will increase the risk of legionella. | Behaviour change |
| T640 | Space heating | Insulate the heating pipes in unheated areas like the crawl space or attic to prevent heat loss from the boiler to the radiators. | Behaviour change |
| T660 | Space heating | Use an infrared panel to heat yourself, not the whole room. They heat up very quickly. | Behaviour change |
| T670 | Space heating | Replace your gas boiler with a more efficient (hybrid) heat pump. | Investment |
| T680 | Spave heating | Schedule maintenance for your heating system for optimal performance. | Maintenance |
| T690 | Space cooling | Use ceiling fans to supplement air conditioning. | Behaviour change |
| T710 | Space cooling | Clean or replace HVAC filters regularly for optimal efficiency. | Behaviour change |
| T700 | Water heating | Install a thermostatic mixer tap in the shower and kitchen. You lose less hot water while setting the right temperature. | Behaviour change |
| T730 | Water heating | Replace you showerhead for a low-flow model. | Behaviour change |
| T720 | Water heating | Put a water-saving nozzle or flow restrictor on your hot water taps. | Behaviour change |
| T770 | Water heating | Is your boiler set to the comfort setting? Then change it to eco-setting for hot water. The comfort setting keeps the boiler standby all day. | Behaviour change |
| T780 | Water heating | Take quicker, refreshing showers and reduce your energy usage for water heating | Behaviour change |
| T790 | Water heating | Do you sometimes take a bath? Then you can save on that too. After all, bathing uses 3 times as much water as a 5-minute shower. | Behaviour change |
| T800 | Water heating | New bathroom? Have a shower heat recovery system installed. This uses the heat from the run-off shower water to pre-heat the cold water. | Investment |
| T820 | Pool pump | Upgrade to a more efficient pool pump for swimming pools. | Behaviour change |
Potential savings calculation
The potentialSavingsKWh field represents the estimated energy savings if the recommendation is implemented. This is calculated dynamically based on:
- The user's historical energy consumption.
- Average savings impact for the given action type.
- The estimated efficiency gain per appliance category.
Peer comparison (deltaPerc)
The deltaPerc field shows how much higher the user's consumption is compared to a benchmark:
- Benchmarks are derived from similar households (size, region, appliance usage patterns).
- A higher deltaPerc (e.g., 25%) indicates excessive consumption, making the recommendation more relevant.
API endpoints
GET Weekly recommendations
GET /v2/recommendations/weekly
Description: Returns an array of personalized weekly recommendations based on recent consumption and peer benchmarking.
GET Monthly recommendations
GET /v2/recommendations/monthly
Description: Returns an array of personalized monthly recommendations based on broader consumption trends and comparisons.
Response structure
{
"status": "ok",
"data": [
{
"id": "T360",
"deltaPerc": 25,
"potentialSavingsKWh": 10,
"disaggregation_category": "Refrigeration",
"appliance": "Refrigeration",
"action_type": "Behaviour",
"timestamp": "2023-01-09T14:17:31+00:00"
}
],
"timestamp": "2022-10-13T20:37:53+02:00"
}
Field definitions
| Field | Type | Description |
|---|---|---|
id | string | Unique recommendation identifier (e.g., T360). |
deltaPerc | number | Excess consumption percentage compared to peers. |
potentialSavingsKWh | number | Estimated savings in kWh per month if the recommendation is followed. |
disaggregation_category | string | The energy category related to the recommendation (e.g., "Refrigeration"). |
appliance | string | Specific appliance affected by the recommendation. |
action_type | string | Type of action required (Behaviour change, Investment, Maintenance, etc.). |
timestamp | string | When the recommendation was generated. |
Error Handling
| Error Code | Description |
|---|---|
| 118 | Cloud error occurred. |
| 120 | Unexpected exception while retrieving report. |
| 152 | User does not have a valid household object. |
| 153 | No valid meter found for user. |
| 190 | No recommendations available. |
| 400 | Required resource for the report retrieval was not found. |
| 424 | Invalid time period or timezone. |
Summary
- The API provides weekly and monthly recommendations.
- Recommendations are based on peer benchmarking and historical (Weekly & Monthly) consumption.
- The App processes recommendations by retrieving texts mapped to ID values.
- Potential savings and excess consumption drive prioritization. Recommendations output is ordered accordingly.
- Customization options allow translation and wording adjustments by the App.
Updated 11 days ago