Search the Thalia shop at thalia.de. A keyword or a search URL both work. The body is { results, pagination }.
price is a number. price_display is the same amount in euros, written with cents (18,00 €, 1.649,99 €). A shop label such as 261,- is returned as 261,00 €.
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
Send header x-api-key. page starts at 1 and is sent to Thalia as p.
| Parameter |
Type |
Required |
Description |
query |
string |
yes |
Keyword, a /suche URL, or a /kategorie/ URL on thalia.de. A product URL returns 400. |
page |
integer |
no |
Page number from 1. Default 1. |
return_page_source |
boolean |
no |
When true, returns {"result": "<html>..."}. Default false. |
| Field |
Type |
Description |
results[].id |
string |
Thalia article id, for example A1074644377. |
results[].url |
string |
Product URL. |
results[].title |
string |
Product title. |
results[].author |
string or null |
Author when the card shows one. Toys often have null. |
results[].format |
string or null |
Format label, for example Buch (Gebundene Ausgabe). |
results[].image |
string or null |
Cover image URL. |
results[].price |
number or null |
Current price. |
results[].price_display |
string or null |
Same amount as price, with cents and the euro sign. |
results[].currency |
string or null |
EUR when a price is present. |
results[].rating |
number or null |
Star rating shown on the card. |
results[].review_count |
integer or null |
Number of reviews shown on the card. |
pagination.page |
integer |
Page that was parsed. |
pagination.per_page |
integer |
Number of cards in results. |
pagination.total_results |
integer or null |
Exact hit count. Null when Thalia only shows an approximate count such as mehr als 1.000 Treffer. |
pagination.total_pages |
integer or null |
Page count from the pager, for example Seite 1 von 258. |
pagination.next |
string or null |
Next page URL, or null on the last page. |
- Monitor German book prices
- Page an author or a title
- Resolve a keyword to a product URL
| Code |
When |
| 400 |
Empty query, another domain, a product URL, or a page below 1. |
| 401 |
Missing API key. |
| 404 |
The listing rendered, but no product card could be parsed. |
| 500 |
Unexpected failure while rendering or parsing. |
/v2/thalia/product returns one product sheet.