Skip to content

Commit cfedce8

Browse files
JulianKahnertfabaff
authored andcommitted
Geizhals sensor documentation added (home-assistant#2980)
* Geizhals sensor documentation added * update documentation after review * Minor changes
1 parent 249d76d commit cfedce8

File tree

2 files changed

+48
-0
lines changed

2 files changed

+48
-0
lines changed
Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
---
2+
layout: page
3+
title: "Geizhals"
4+
description: "Instructions on how to integrate a Geizhals sensor into Home Assistant."
5+
date: 2017-07-15 14:15
6+
sidebar: true
7+
comments: false
8+
sharing: true
9+
footer: true
10+
logo: geizhals.png
11+
ha_category: Sensor
12+
ha_iot_class: "Cloud Polling"
13+
ha_release: "0.50"
14+
---
15+
16+
17+
The `geizhals` sensor will give you the best price of a product from [Geizhals](https://geizhals.de) or related site. With this information can be used in e.g. automations to notify you when a price drops.
18+
19+
To enable this sensor, add the following lines to your `configuration.yaml` file:
20+
21+
```yaml
22+
# Example configuration.yaml entry
23+
sensor:
24+
- platform: geizhals
25+
name: qc35
26+
product_id: 1453021
27+
```
28+
29+
Configuration variables:
30+
31+
- **name** (*Required*): The internal name of the product in Home Assistant.
32+
- **product_id** (*Required*): ID of the product. Get the ID from the geizhals website of your chosen product by clicking on the *Price History* tab, e.g. [here](https://geizhals.de/?phist=1453021). The URL of this site reveals the ID, e.g. <https://geizhals.de/?phist=1453021> with `product_id: 1453021`.
33+
- **description** (*Optional*): The name of the product in the front end.
34+
- **domain** (*Optional*): Domain which should be used for the request. Set this to `geizhals.at`, `geizhals.eu`, `geizhals.de`, `skinflint.co.uk` or `cenowarka.pl`. Defaults to `geizhals.de`.
35+
- **regex** (*Optional*): Regular expression to parse the price. Default: `\D\s(\d*)[\,|\.](\d*)`.
36+
37+
#### {% linkable_title Extended example %}
38+
39+
```yaml
40+
# Example configuration.yaml entry
41+
sensor:
42+
- platform: geizhals
43+
name: qc35
44+
product_id: 1453021
45+
description: "Bose QC35"
46+
domain: 'geizhals.de'
47+
regex: '\D\s(\d*)[\,|\.](\d*)'
48+
```
16.1 KB
Loading

0 commit comments

Comments
 (0)