Piloterr

Thalia Search

GET
/v2/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

Autorización

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Parámetros de consulta

query*string

Keyword or a thalia.de search URL (/suche or a category URL). A product URL returns 400.

Example: Harry Potter

page?number

Page number, from 1. Sent to Thalia as the query parameter p. Default 1.

return_page_source?boolean

When true, returns {"result": "..."} instead of the parsed JSON. Default false.

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Cuerpo de la respuesta

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/thalia/search?query=string'
Example Response
{  "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  }}