Untappd Search

GET

/v2/untappd/search

Search Untappd beers by keyword. Cards include brewery, ABV, and IBU. next is null when Untappd does not expose a next page.

Credit cost: 2 credits per call

Autorización

ApiKeyAuth

headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Parámetros de consulta

query*string

Required. A beer keyword, or an Untappd search URL whose path is /search.

Example:

ipa

ipa

URL example:

https://untappd.com/search?q=ipa

https://untappd.com/search?q=ipa

Cuerpo de la respuesta

Successful response

application/json

response

results?array<>

pagination?

Example Request

curl -X GET 'https://api.piloterr.com/v2/untappd/search?query=string'

Example Request

curl -X GET 'https://api.piloterr.com/v2/untappd/search?query=string'

Example ResponseSchema

{
  "results": [
    {
      "id": "4509",
      "abv": 6.2,
      "ibu": 51,
      "url": "https://untappd.com/b/lagunitas-brewing-company-ipa/4509",
      "name": "IPA",
      "image": "https://assets.untappd.com/site/beer_logos/beer-4509_21190_sm.jpeg",
      "style": "IPA - American",
      "rating": 3.68,
      "brewery": "Lagunitas Brewing Company",
      "abv_display": "6.2% ABV",
      "brewery_url": "https://untappd.com/brewery/765",
      "ibu_display": "51 IBU"
    }
  ],
  "pagination": {
    "next": null,
    "page": 1,
    "per_page": 5,
    "total_pages": null,
    "total_results": 401027
  }
}

{  "results": [    {      "id": "4509",      "abv": 6.2,      "ibu": 51,      "url": "https://untappd.com/b/lagunitas-brewing-company-ipa/4509",      "name": "IPA",      "image": "https://assets.untappd.com/site/beer_logos/beer-4509_21190_sm.jpeg",      "style": "IPA - American",      "rating": 3.68,      "brewery": "Lagunitas Brewing Company",      "abv_display": "6.2% ABV",      "brewery_url": "https://untappd.com/brewery/765",      "ibu_display": "51 IBU"    }  ],  "pagination": {    "next": null,    "page": 1,    "per_page": 5,    "total_pages": null,    "total_results": 401027  }}

AutorizaciónCopiar enlace del ancla

Parámetros de consultaCopiar enlace del ancla

Cuerpo de la respuestaCopiar enlace del ancla

Autorización

Parámetros de consulta

Cuerpo de la respuesta