Skip to main content
Piloterr
Back to library

Thalia Search API

Search Thalia by keyword and page books, media, and gifts. Cards include title, price, and the product link.

Active2 credits = 1 requestGET/v2/thalia/search

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

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 €.

QuickstartLink to Quickstart

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.

ParametersLink to Parameters

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.

Response fieldsLink to Response fields

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.

Main use casesLink to Main use cases

  • Monitor German book prices
  • Page an author or a title
  • Resolve a keyword to a product URL

Error codesLink to Error codes

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.

Related APIs

Expand your data capabilities with these complementary tools.

Ready to get started?

Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.

  • +500 credits
  • No credit card required
  • All endpoints included