Recherche sur la boutique Thalia (thalia.de). Un mot-clé ou une URL de recherche fonctionnent. Le corps est { results, pagination }.
price est un nombre. price_display est le même montant en euros, avec les centimes (18,00 €, 1.649,99 €). Un libellé du site comme 261,- est renvoyé 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
Envoyez l'en-tête x-api-key. page commence à 1 et est envoyé à Thalia dans le paramètre p.
| Paramètre |
Type |
Obligatoire |
Description |
query |
string |
oui |
Mot-clé, URL /suche ou URL /kategorie/ sur thalia.de. Une URL produit renvoie 400. |
page |
integer |
non |
Numéro de page à partir de 1. Défaut 1. |
return_page_source |
boolean |
non |
Si vrai, renvoie {"result": "<html>..."}. Défaut false. |
| Champ |
Type |
Description |
results[].id |
string |
Identifiant article Thalia, par exemple A1074644377. |
results[].url |
string |
URL du produit. |
results[].title |
string |
Titre du produit. |
results[].author |
string ou null |
Auteur quand la carte l'affiche. Souvent null pour un jouet. |
results[].format |
string ou null |
Libellé de format, par exemple Buch (Gebundene Ausgabe). |
results[].image |
string ou null |
URL de l'image. |
results[].price |
number ou null |
Prix courant. |
results[].price_display |
string ou null |
Même montant que price, avec les centimes et le signe euro. |
results[].currency |
string ou null |
EUR quand un prix est présent. |
results[].rating |
number ou null |
Note affichée sur la carte. |
results[].review_count |
integer ou null |
Nombre d'avis affiché sur la carte. |
pagination.page |
integer |
Page analysée. |
pagination.per_page |
integer |
Nombre de cartes dans results. |
pagination.total_results |
integer ou null |
Nombre exact de résultats. Null quand Thalia n'affiche qu'un total approximatif, par exemple mehr als 1.000 Treffer. |
pagination.total_pages |
integer ou null |
Nombre de pages du pager, par exemple Seite 1 von 258. |
pagination.next |
string ou null |
URL de la page suivante, ou null sur la dernière page. |
- Suivre les prix de livres en Allemagne
- Parcourir un auteur ou un titre
- Résoudre un mot-clé en URL produit
| Code |
Quand |
| 400 |
Requête vide, autre domaine, URL produit, ou page inférieure à 1. |
| 401 |
Clé API absente. |
| 404 |
La page a été rendue, mais aucune carte produit n'a pu être lue. |
| 500 |
Échec inattendu pendant le rendu ou l'analyse. |
/v2/thalia/product renvoie une fiche produit.