Saltar al contenido principal
Piloterr
Volver a la biblioteca

API de Thalia Search

Busque en Thalia por palabra y recorra libros, medios y regalos.

Activo2 créditos = 1 solicitudGET/v2/thalia/search

Resumen del Endpoint

Documentación detallada, precios y ejemplos de uso.

DescripciónLink to Descripción

Busca en la tienda Thalia (thalia.de). Sirven una palabra clave o una URL de búsqueda. El cuerpo es { results, pagination }.

price es un número. price_display es el mismo importe en euros, con céntimos (18,00 €, 1.649,99 €). Una etiqueta de la tienda como 261,- se devuelve como 261,00 €.

Inicio rápidoLink to Inicio 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

Envía la cabecera x-api-key. page empieza en 1 y se envía a Thalia como p.

ParámetrosLink to Parámetros

Parámetro Tipo Obligatorio Descripción
query string sí Palabra clave, URL /suche o URL /kategorie/ en thalia.de. Una URL de producto devuelve 400.
page integer no Número de página desde 1. Por defecto 1.
return_page_source boolean no Si es true, devuelve {"result": "<html>..."}. Por defecto false.

Campos de la respuestaLink to Campos de la respuesta

Campo Tipo Descripción
results[].id string Id de artículo Thalia, por ejemplo A1074644377.
results[].url string URL del producto.
results[].title string Título del producto.
results[].author string o null Autor cuando la ficha lo muestra. En juguetes suele ser null.
results[].format string o null Formato, por ejemplo Buch (Gebundene Ausgabe).
results[].image string o null URL de la imagen.
results[].price number o null Precio actual.
results[].price_display string o null El mismo importe que price, con céntimos y el signo del euro.
results[].currency string o null EUR cuando hay precio.
results[].rating number o null Valoración en estrellas de la ficha.
results[].review_count integer o null Número de reseñas de la ficha.
pagination.page integer Página leída.
pagination.per_page integer Número de fichas en results.
pagination.total_results integer o null Total exacto. Null cuando Thalia solo muestra un total aproximado, por ejemplo mehr als 1.000 Treffer.
pagination.total_pages integer o null Número de páginas del paginador, por ejemplo Seite 1 von 258.
pagination.next string o null URL de la página siguiente, o null en la última.

Casos de usoLink to Casos de uso

  • Vigilar precios de libros en Alemania
  • Recorrer un autor o un título
  • Resolver una palabra en una URL

Códigos de errorLink to Códigos de error

Código Cuándo
400 Consulta vacía, otro dominio, URL de producto o página menor que 1.
401 Falta la clave API.
404 La página se renderizó, pero no se pudo leer ninguna ficha.
500 Fallo inesperado al renderizar o analizar.

Endpoints relacionadosLink to Endpoints relacionados

/v2/thalia/product devuelve una ficha de producto.

APIs relacionadas

Amplía tus capacidades de datos con estas herramientas complementarias.

¿Listo para empezar?

Tu API de web scraping está a un clic. Comienza con +500 créditos, sin infraestructura que configurar, sin proxies que gestionar y sin necesidad de tarjeta de crédito.

  • +500 créditos
  • Sin tarjeta de crédito
  • Todos los endpoints incluidos