Pesquisa a loja Thalia (thalia.de). Uma palavra-chave ou um URL de pesquisa funcionam. O corpo é { results, pagination }.
price é um número. price_display é o mesmo valor em euros, com cêntimos (18,00 €, 1.649,99 €). Uma etiqueta da loja como 261,- é devolvida como 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
Envie o cabeçalho x-api-key. page começa em 1 e é enviado à Thalia como p.
| Parâmetro |
Tipo |
Obrigatório |
Descrição |
query |
string |
sim |
Palavra-chave, URL /suche ou URL /kategorie/ em thalia.de. Um URL de produto devolve 400. |
page |
integer |
não |
Número da página a partir de 1. Predefinição 1. |
return_page_source |
boolean |
não |
Se true, devolve {"result": "<html>..."}. Predefinição false. |
| Campo |
Tipo |
Descrição |
results[].id |
string |
Id de artigo Thalia, por exemplo A1074644377. |
results[].url |
string |
URL do produto. |
results[].title |
string |
Título do produto. |
results[].author |
string ou null |
Autor quando o cartão o mostra. Em brinquedos costuma ser null. |
results[].format |
string ou null |
Formato, por exemplo Buch (Gebundene Ausgabe). |
results[].image |
string ou null |
URL da imagem. |
results[].price |
number ou null |
Preço atual. |
results[].price_display |
string ou null |
O mesmo valor que price, com cêntimos e o sinal do euro. |
results[].currency |
string ou null |
EUR quando há preço. |
results[].rating |
number ou null |
Avaliação em estrelas do cartão. |
results[].review_count |
integer ou null |
Número de avaliações do cartão. |
pagination.page |
integer |
Página lida. |
pagination.per_page |
integer |
Número de cartões em results. |
pagination.total_results |
integer ou null |
Total exato. Null quando a Thalia só mostra um total aproximado, por exemplo mehr als 1.000 Treffer. |
pagination.total_pages |
integer ou null |
Número de páginas do paginador, por exemplo Seite 1 von 258. |
pagination.next |
string ou null |
URL da página seguinte, ou null na última. |
- Acompanhar preços de livros na Alemanha
- Percorrer um autor ou um título
- Resolver uma palavra num URL
| Código |
Quando |
| 400 |
Consulta vazia, outro domínio, URL de produto ou página inferior a 1. |
| 401 |
Chave API em falta. |
| 404 |
A página foi renderizada, mas nenhum cartão pôde ser lido. |
| 500 |
Falha inesperada ao renderizar ou analisar. |
/v2/thalia/product devolve uma ficha de produto.