Aller au contenu principal
Piloterr
Retour à la bibliothèque

API Untappd Beer

Lisez une bière Untappd, y compris l'ABV, l'IBU et la brasserie.

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

Vue d'ensemble de l'endpoint

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

AperçuLink to Aperçu

Lit une page bière Untappd. Passez l'id numérique de la recherche, ou une URL /b/ ou /beer/. La réponse est un objet plat : brasserie, style, ABV, IBU, note, description et check-ins.

4509 est l'IPA de Lagunitas Brewing Company : le même id, le même nom, la même brasserie, l'ABV 6.2 et l'IBU 51 que la carte ipa. La note de la carte peut avoir moins de décimales que rating sur cette page.

DémarrageLink to Démarrage

GET https://api.piloterr.com/v2/untappd/beer?query=4509
GET https://api.piloterr.com/v2/untappd/beer?query=https://untappd.com/b/lagunitas-brewing-company-ipa/4509
GET https://api.piloterr.com/v2/untappd/beer?query=4473

GET et POST prennent le même query. 4473 est Guinness Draught issu d'une recherche stout, brasserie Guinness, ABV 4.2, IBU 45.

ParamètresLink to Paramètres

Paramètre Obligatoire Exemple
query oui 4509

query est obligatoire. Un entier ouvre /beer/{id}. Une URL doit être sur untappd.com et contenir /b/ ou /beer/. Un mot-clé, une URL de recherche ou un autre hôte renvoie 400.

Champs de réponseLink to Champs de réponse

Champ Type Sens
id string Id
name string Nom
url string URL sans query string
brewery string ou null Brasserie
brewery_url string ou null URL brasserie. Le chemin peut différer du lien de la carte
style string ou null Style
abv number ou null ABV
abv_display string ou null ABV imprimé, par exemple 6.2% ABV
ibu number ou null IBU
ibu_display string ou null IBU imprimé, par exemple 51 IBU
rating number ou null Note moyenne
ratings_count number ou null Nombre de notes
description string ou null Description
total_checkins number ou null Plancher du libellé. 1.97M+ devient 1970000
total_checkins_display string ou null Total imprimé, par exemple 1.97M+
unique_checkins number ou null Check-ins uniques
monthly_checkins number ou null Check-ins du mois
image string ou null Étiquette

abv correspond au nombre de abv_display. ibu correspond au nombre de ibu_display. Pas d'enveloppe results.

Cas d'usageLink to Cas d'usage

  • Enregistrer l'ABV 6.2, l'IBU 51 et la brasserie Lagunitas Brewing Company pour la bière 4509.
  • Garder la description de cette IPA à côté du style IPA - American.
  • Suivre les check-ins avec le libellé 1.97M+ et le plancher 1970000.

Codes d'erreurLink to Codes d'erreur

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

Endpoints liésLink to Endpoints liés

Untappd Search

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