Ir para o conteúdo principal
Piloterr
Voltar à biblioteca

API Thalia Search

Pesquise na Thalia por palavra e percorra livros, média e presentes.

Ativo2 créditos = 1 requisiçãoGET/v2/thalia/search

Visão Geral do Endpoint

Documentação detalhada, preços e exemplos de uso.

Visão geralLink to Visão geral

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

Início rápidoLink to Início rápido

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âmetrosLink to Parâmetros

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.

Campos da respostaLink to Campos da resposta

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.

Casos de usoLink to Casos de uso

  • Acompanhar preços de livros na Alemanha
  • Percorrer um autor ou um título
  • Resolver uma palavra num URL

Códigos de erroLink to Códigos de erro

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.

Endpoints relacionadosLink to Endpoints relacionados

/v2/thalia/product devolve uma ficha de produto.

APIs Relacionadas

Expanda suas capacidades de dados com essas ferramentas complementares.

Pronto para começar?

Sua API de web scraping está a um clique. Comece com +500 créditos, sem infraestrutura para configurar, sem proxies para gerenciar e sem cartão de crédito necessário.

  • +500 créditos
  • Sem cartão de crédito
  • Todos os endpoints incluídos