# Thalia Product ## Overview | Property | Value | |----------|-------| | **Status** | active | | **Method** | `GET` | | **Endpoint** | `/v2/thalia/product` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 2 credits per call | | **Documentation** | https://www.piloterr.com/library/thalia-product | ## Description Read one Thalia product from its URL. You get price, author or brand, and the product details. ## Authentication - **Key Name:** `x-api-key` - **Location:** HTTP Header - **Get an API key:** https://app.piloterr.com/register ## Example Request ```bash curl --location --request GET 'https://api.piloterr.com/v2/thalia/product' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### Harry Potter und die Kammer des Schreckens ```json { "id": "A1074644377", "url": "https://www.thalia.de/shop/home/artikeldetails/A1074644377", "isbn": "978-3-551-55923-4", "image": "https://images.thalia.media/07/-/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": "Hardcover", "rating": 4.9, "series": "Harry Potter", "currency": "EUR", "language": "Deutsch", "subtitle": "Neuausgabe des Kinderbuch-Klassikers ab 10 Jahren über den bekanntesten Zauberer der Welt", "publisher": "Carlsen", "page_count": 352, "description": "Detailreiche und prachtvoll veredelte Neugestaltung aller sieben Bände Endlich wieder Schule! Einen solchen Seufzer kann nur der ausstoßen, dessen Ferien scheußlich waren: Harry Potter. Doch wie im vergangenen Schuljahr stehen nicht nur Zaubertrankunterricht und Verwandlung auf dem Programm. Ein grauenhaftes Etwas treibt sein Unwesen in der Schule. Wird Harry mit Hilfe seiner Freunde Ron und Hermine das Rätsel lösen und Hogwarts von den dunklen Mächten befreien können? Ein generationenübergreifender Fantasy-Klassiker Millionen von Leser*innen in mehreren Generationen sind mit den Geschichten von Harry Potter aufgewachsen. J.K. Rowling hat mit Hogwarts ein Universum geschaffen, das einzigartig ist und eine große kulturelle Bedeutung erlangt hat. Neben der magischen Welt und spannenden Abenteuern spielen auch moralische Werte wie Freundschaft, Toleranz, Loyalität und der Einsatz für das Gute in ihren Büchern eine wichtige Rolle. Diese vom griechischen Illustrator George Caltsoudas neu gestaltete Ausgabe des zweiten Bandes der Harry-Potter-Serie wird Leser*innen jeden Alters verzaubern.", "availability": "Sofort lieferbar", "review_count": 97, "price_display": "18,00 €", "publication_date": "2025-09-01" } ``` ## Documentation ## Overview Fetch one Thalia product sheet from thalia.de. Pass the article URL or the article id (`A1074644377`). The body is a flat object. `price` is a number. `price_display` is the same amount in euros, written with cents (`18,00 €`). A shop label such as `261,-` is returned as `261,00 €`. ## Quickstart ``` GET https://api.piloterr.com/v2/thalia/product?query=A1074644377 GET https://api.piloterr.com/v2/thalia/product?query=https://www.thalia.de/shop/home/artikeldetails/A1074644377 ``` Send header `x-api-key`. ## Parameters | Parameter | Type | Required | Description | |---|---|---|---| | `query` | string | yes | Product URL or article id. A keyword that is not an article id returns 400. | | `return_page_source` | boolean | no | When true, returns `{"result": "..."}`. Default false. | ## Response fields | Field | Type | Description | |---|---|---| | `id` | string | Thalia article id. | | `url` | string | Canonical product URL. | | `title` | string | Product title. | | `subtitle` | string or null | Subtitle under the title. | | `author` | string or null | Author names, comma-separated. | | `series` | string or null | Series name, for example `Harry Potter`. | | `description` | string or null | Product description. | | `image` | string or null | Main image URL. | | `price` | number or null | Current price. | | `price_display` | string or null | Same amount as `price`, with cents and the euro sign. | | `currency` | string or null | `EUR` when a price is present. | | `isbn` | string or null | ISBN when the sheet shows one. | | `format` | string or null | Selected format, for example `Hardcover`. | | `publisher` | string or null | Publisher. | | `language` | string or null | Language. | | `page_count` | integer or null | Number of pages. | | `publication_date` | string or null | Publication date as `YYYY-MM-DD`. | | `rating` | number or null | Average rating. | | `review_count` | integer or null | Number of reviews. | | `availability` | string or null | Stock label, for example `Sofort lieferbar`. | ## Main use cases - Open the book a search card pointed to - Store the selling price - Collect ISBN or article data when the page shows it ## Error codes | Code | When | |---|---| | 400 | Empty query, another domain, a search URL, or a value that is not an article id. | | 401 | Missing API key. | | 404 | The page rendered, but the product sheet could not be parsed. | | 500 | Unexpected failure while rendering or parsing. | ## Related endpoints `/v2/thalia/search` returns a listing.