Zum Hauptinhalt springen
Piloterr
Zurück zur Bibliothek

API Thalia Search

Suchen Sie bei Thalia nach Stichwort und blättern Sie Bücher, Medien und Geschenke.

Aktiv2 Credits = 1 AnfrageGET/v2/thalia/search

Endpunkt-Übersicht

Detaillierte Dokumentation, Preise und Anwendungsbeispiele.

ÜberblickLink to Überblick

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.

SchnellstartLink to Schnellstart

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.

ParameterLink to Parameter

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.

AntwortfelderLink to Antwortfelder

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.

HauptanwendungsfälleLink to Hauptanwendungsfälle

  • Deutsche Buchpreise beobachten
  • Einen Autor oder Titel durchblättern
  • Ein Stichwort in eine Produkt-URL auflösen

FehlercodesLink to Fehlercodes

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.

Verwandte EndpunkteLink to Verwandte Endpunkte

/v2/thalia/product liefert ein Produktdatenblatt.

Verwandte APIs

Erweitern Sie Ihre Datenmöglichkeiten mit diesen ergänzenden Tools.

Bereit loszulegen?

Ihre Web-Scraping-API ist nur einen Klick entfernt. Starten Sie mit +500 Credits, ohne Infrastruktur einrichten zu müssen, ohne Proxys zu verwalten und ohne Kreditkarte.

  • +500 Credits
  • Keine Kreditkarte erforderlich
  • Alle Endpunkte enthalten