Geizhals API Go

Using geizhals.de via a RESTFul interface to search and display products.

Motivation

As part of a private project to learn the programming language Go, I needed the possibility to collect availability of articles from Geizhals.de without calling the website directly.

Run

# go run main.go

or

# go build -o geizhals-api-go
# ./geizhals-api-go   

Docker

# docker build -t geizhals-api-go:1.0 .
# docker run -d --name geizhals-api-go -p 8080:8080 geizhals-api-go:1.0

How to use

Search article

Request

GET /api/search/:query

curl -i -H 'Accept: application/json' http://localhost:8080/api/search/AMD

Response

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Wed, 26 May 2021 07:39:06 GMT
Transfer-Encoding: chunked

[
    {
        "name": "AMD Ryzen 5 3600, 6C/12T, 3.60-4.20GHz, boxed",
        "lowestPrice": 187,
        "offerCount": 70,
        "url": "amd-ryzen-5-3600-100-100000031box-a2064574.html",
        "imageUrl": "https://gzhls.at/i/45/74/2064574-r0.jpg",
        "availability": 1
    },
...
]

Availability	ID
ANY / UNKOWN	0
AVAILABLE	1
SHORTLY	2

Search article in a specific category

Request

GET /api/search/:query?category=:categoryId

curl -i -H 'Accept: application/json' http://localhost:8080/api/search/LG?category=4

Category	ID
Hardware	1
Software	2
Video, Photo & TV	4
Phone	5
Audio & HiFi	6
Movies	7
Household	8
Sport & Leisure	9
Drugstore	10
Car & Motorcycle	11
Toys & Model Making	12
Hardware store & Garden	13
Office & School	14

Response

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Wed, 26 May 2021 07:39:06 GMT
Transfer-Encoding: chunked

[
    {
        "name": "LG OLED 65CX9LA",
        "lowestPrice": 1675,
        "offerCount": 24,
        "url": "lg-oled-65cx9la-a2250846.html",
        "imageUrl": "https://gzhls.at/i/08/46/2250846-r0.jpg",
        "availability": 1
    },
...
]

Get article details

Request

GET /api/article/:identifier

curl -i -H 'Accept: application/json' http://localhost:8080/api/article/amd-ryzen-5-3600-100-100000031box-a2064574.html

Response

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Wed, 26 May 2021 07:39:06 GMT
Transfer-Encoding: chunked

{
    "article": {
        "name": "AMD Ryzen 5 3600, 6C/12T, 3.60-4.20GHz, boxed (100-100000031BOX)",
        "priceFrom": 187",
        "priceTo": 388.6,
        "imageUrl": "https://gzhls.at/i/45/74/2064574-m0.jpg"
    },
    "provider": [
        {
            "name": "Mindfactory",
            "offerURL": "https://geizhals.de//redir.cgi?h=mindfactory\u0026loc=https%3A%2F%2Fwww.mindfactory.de%2Fproduct_info.php%2Finfo%2Fp1313643%2Fpid%2Fgeizhals\u0026ghaID=2064574\u0026key=7167ae0337fc34de7a73d669596f3ab8",
            "price": 187,
            "availability": "Zentrallager: 5 Stück lagernd, Lieferung 1-3 WerktageFiliale Wilhelmshaven: 5 Stück lagerndStand: 26.05.2021, 09:55",
            "shipping": "Vorkasse, PayPal, Giropay, Finanzierung € 8,99.Expressversand möglich.Lieferung nur innerhalb Deutschlands."
        },
    ...
    ]
}

Get custom filter list

To create a custom filter visit www.geizhals.de and browse any category (example: https://geizhals.de/?cat=gra16_512&xf=9816_03+05+16+-+RTX+3080). Select your criteria and copy the url after the "?".

Request

GET /api/custom-filter/:queryUrl

curl -i -H 'Accept: application/json' http://localhost:8080/api/custom-filter/cat=gra16_512&xf=9816_03+05+16+-+RTX+3080~9816_03+05+16+-+RTX+3080+Ti&sort=p#productlist

Response

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Wed, 14 Jun 2021 07:50:06 GMT
Transfer-Encoding: chunked

{
    [
        {
            "name": "GIGABYTE GeForce RTX 3080 Turbo 10G, 10GB GDDR6X, 2x HDMI, 2x DP (GV-N3080TURBO-10GD)",
            "lowestPrice": 1199.99,
            "offerCount": 3,
            "url": "gigabyte-geforce-rtx-3080-turbo-10g-gv-n3080turbo-10gd-a2497121.html?hloc=at&hloc=de",
            "imageUrl": "https://gzhls.at/i/71/21/2497121-s0.jpg",
            "availability": 0
        },
        {
            "name": "GIGABYTE GeForce RTX 3080 Gaming OC 10G (Rev. 1.0), 10GB GDDR6X, 2x HDMI, 3x DP (GV-N3080GAMING OC-10GD)",
            "lowestPrice": 1209.99,
            "offerCount": 12,
            "url": "gigabyte-geforce-rtx-3080-gaming-oc-10g-gv-n3080gaming-oc-10gd-a2366735.html?hloc=at&hloc=de",
            "imageUrl": "https://gzhls.at/i/67/35/2366735-s0.jpg",
            "availability": 1
        },
        ...
    ]
}

Contribute

Maybe someone will find the project helpful or can give me hints/improvements.