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 €.
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á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. |
| 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. |
- Vigilar precios de libros en Alemania
- Recorrer un autor o un título
- Resolver una palabra en una URL
| 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. |
/v2/thalia/product devuelve una ficha de producto.