Aller au contenu principal
Piloterr
Retour à la bibliothèque

API Untappd Search

Recherchez des bières Untappd par mot-clé. Les cartes incluent la brasserie, l'ABV et l'IBU. next vaut null quand Untappd n'expose pas de page suivante.

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

Vue d'ensemble de l'endpoint

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

AperçuLink to Aperçu

Recherchez des bières sur Untappd. Envoyez un mot-clé comme ipa ou stout, ou une URL dont le chemin est /search. La réponse est { results, pagination } pour les cartes rendues. Passez results[].id ou results[].url à /v2/untappd/beer.

Chaque carte peut porter la brasserie, le style, l'ABV et l'IBU. abv est le nombre dans abv_display (par exemple 6.2 et 6.2% ABV). ibu est le nombre dans ibu_display (par exemple 51 et 51 IBU).

DémarrageLink to Démarrage

GET https://api.piloterr.com/v2/untappd/search?query=ipa
GET https://api.piloterr.com/v2/untappd/search?query=stout

GET et POST prennent le même query. ipa contient la bière 4509, nom IPA, brasserie Lagunitas Brewing Company, ABV 6.2, IBU 51. L'appel bière de 4509 renvoie le même id, le même nom, la même brasserie, le même ABV et le même IBU. stout contient Guinness Draught, id 4473.

ParamètresLink to Paramètres

Paramètre Obligatoire Exemple
query oui ipa

query est obligatoire. Une URL doit être sur untappd.com et son chemin doit être /search. Une URL de bière appartient à l'endpoint bière. Un autre hôte renvoie 400. Il n'y a pas de paramètre page.

PaginationLink to Pagination

Untappd affiche un nombre de bières et charge d'autres résultats dans la page. Cet endpoint renvoie les cartes présentes. pagination.page vaut 1. pagination.next vaut null quand la page n'expose pas d'URL suivante. N'en inventez pas. pagination.per_page est le nombre de cartes, 5 pour ipa et pour stout. pagination.total_results est le compte affiché dans les stats. pagination.total_pages vaut null.

Les ids sont uniques. next reste null sur ces recherches parce que le site n'imprime pas de lien de page suivante.

Champs de réponseLink to Champs de réponse

Champ Type Sens
results[].id string Id, par exemple 4509
results[].name string Nom
results[].url string URL, en général sous /b/
results[].brewery string ou null Brasserie
results[].brewery_url string ou null URL de la brasserie
results[].style string ou null Style
results[].abv number ou null ABV
results[].abv_display string ou null ABV imprimé, par exemple 6.2% ABV
results[].ibu number ou null IBU
results[].ibu_display string ou null IBU imprimé, par exemple 51 IBU
results[].rating number ou null Note de la carte. La fiche peut afficher plus de décimales
results[].image string ou null Étiquette
pagination.page integer 1
pagination.per_page integer ou null Cartes renvoyées
pagination.total_results number ou null Nombre de bières imprimé
pagination.total_pages null Pas de nombre de pages
pagination.next null Pas d'URL suivante sur ces recherches

Cas d'usageLink to Cas d'usage

  • Trouver l'IPA Lagunitas, id 4509, avec ABV 6.2 et IBU 51 sur la carte.
  • Comparer ABV et IBU sur les premières cartes stout, dont Guinness Draught 4473.
  • Garder total_results comme compte imprimé et s'arrêter quand next vaut null.

Codes d'erreurLink to Codes d'erreur

Code Sens
400 Requête vide, URL qui n'est pas une recherche, ou domaine hors untappd.com
401 Clé API absente
404 La page n'est pas une recherche de bières
500 Échec de la récupération

Endpoints liésLink to Endpoints liés

Untappd Beer

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