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).
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è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.
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.
| 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 |
- 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.
| 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 |
Untappd Beer