Thalia Search
Search Thalia by keyword and page books, media, and gifts. Cards include title, price, and the product link.
Credit cost: 2 credits per call
ApiKeyAuthx-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringKeyword or a thalia.de search URL (/suche or a category URL). A product URL returns 400.
Example: Harry Potter
page?numberPage number, from 1. Sent to Thalia as the query parameter p. Default 1.
return_page_source?booleanWhen true, returns {"result": "..."} instead of the parsed JSON. Default false.
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
falseSuccessful response
application/json- response
results?array<>pagination?curl -X GET 'https://api.piloterr.com/v2/thalia/search?query=string'{ "results": [ { "id": "A1074644377", "url": "https://www.thalia.de/shop/home/artikeldetails/A1074644377", "image": "https://images.thalia.media/03/-/3aeeae4a5ce44ac39ca88cc122da4164/harry-potter-und-die-kammer-des-schreckens-harry-potter-2-gebundene-ausgabe-j-k-rowling.jpeg", "price": 18, "title": "Harry Potter und die Kammer des Schreckens (Harry Potter 2)", "author": "J. K. Rowling", "format": "Buch (Gebundene Ausgabe)", "rating": 5, "currency": "EUR", "review_count": 97, "price_display": "18,00 €" } ], "pagination": { "next": "https://www.thalia.de/suche?sq=Harry%20potter&p=2", "page": 1, "per_page": 24, "total_pages": 258, "total_results": null }}