Aller au contenu principal
Piloterr
Retour à la bibliothèque

API Thalia Search

Recherchez sur Thalia par mot-clé et parcourez livres, médias et cadeaux. Les cartes ont le titre, le prix et le lien.

Actif2 crédits = 1 requêteGET/v2/thalia/search

Vue d'ensemble de l'endpoint

Documentation détaillée, tarifs et exemples d'utilisation.

AperçuLink to Aperçu

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

Démarrage rapideLink to Démarrage rapide

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ètresLink to Paramètres

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.

Champs de la réponseLink to Champs de la réponse

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.

Cas d'utilisationLink to Cas d'utilisation

  • Suivre les prix de livres en Allemagne
  • Parcourir un auteur ou un titre
  • Résoudre un mot-clé en URL produit

Codes d'erreurLink to Codes d'erreur

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.

Endpoints liésLink to Endpoints liés

/v2/thalia/product renvoie une fiche produit.

API associées

Étendez vos capacités data avec ces outils complémentaires.

Prêt à commencer ?

Votre API de scraping web est à un clic. Commencez avec +500 crédits, sans infrastructure à gérer, sans proxies à configurer, et sans carte bancaire.

  • +500 crédits
  • Aucune carte bancaire requise
  • Tous les endpoints inclus