Suche im Thalia-Shop (thalia.de). Stichwort und Such-URL funktionieren beide. Der Body ist { results, pagination }.
price ist eine Zahl. price_display ist derselbe Betrag in Euro, mit Cent (18,00 €, 1.649,99 €). Eine Shop-Angabe wie 261,- wird als 261,00 € zurückgegeben.
GET https://api.piloterr.com/v2/thalia/search?query=Harry%20Potter
GET https://api.piloterr.com/v2/thalia/search?query=Harry%20Potter&page=2
GET https://api.piloterr.com/v2/thalia/search?query=https://www.thalia.de/suche?sq=Harry+Potter
Header x-api-key senden. page beginnt bei 1 und geht als p an Thalia.
| Parameter |
Typ |
Pflicht |
Beschreibung |
query |
string |
ja |
Stichwort, /suche-URL oder /kategorie/-URL auf thalia.de. Eine Produkt-URL liefert 400. |
page |
integer |
nein |
Seitennummer ab 1. Standard 1. |
return_page_source |
boolean |
nein |
Wenn true, Antwort {"result": "<html>..."}. Standard false. |
| Feld |
Typ |
Beschreibung |
results[].id |
string |
Thalia-Artikelnummer, zum Beispiel A1074644377. |
results[].url |
string |
Produkt-URL. |
results[].title |
string |
Produkttitel. |
results[].author |
string oder null |
Autor, wenn die Karte einen zeigt. Bei Spielzeug oft null. |
results[].format |
string oder null |
Format, zum Beispiel Buch (Gebundene Ausgabe). |
results[].image |
string oder null |
Bild-URL. |
results[].price |
number oder null |
Aktueller Preis. |
results[].price_display |
string oder null |
Derselbe Betrag wie price, mit Cent und Eurozeichen. |
results[].currency |
string oder null |
EUR, wenn ein Preis vorhanden ist. |
results[].rating |
number oder null |
Sternebewertung auf der Karte. |
results[].review_count |
integer oder null |
Anzahl der Bewertungen auf der Karte. |
pagination.page |
integer |
Gelesene Seite. |
pagination.per_page |
integer |
Anzahl der Karten in results. |
pagination.total_results |
integer oder null |
Genaue Trefferzahl. Null, wenn Thalia nur eine ungefähre Zahl zeigt, etwa mehr als 1.000 Treffer. |
pagination.total_pages |
integer oder null |
Seitenzahl aus dem Pager, zum Beispiel Seite 1 von 258. |
pagination.next |
string oder null |
URL der nächsten Seite, oder null auf der letzten Seite. |
- Deutsche Buchpreise beobachten
- Einen Autor oder Titel durchblättern
- Ein Stichwort in eine Produkt-URL auflösen
| Code |
Wann |
| 400 |
Leere Abfrage, fremde Domain, Produkt-URL oder Seite unter 1. |
| 401 |
API-Schlüssel fehlt. |
| 404 |
Die Seite wurde gerendert, aber keine Produktkarte konnte gelesen werden. |
| 500 |
Unerwarteter Fehler beim Rendern oder Parsen. |
/v2/thalia/product liefert ein Produktdatenblatt.