Piloterr

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

Authorization

ApiKeyAuth
headerx-api-key<token>

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

Query Parameters

query*string

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

Example:

ipa

URL example:

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

Response Body

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/untappd/search?query=string'
Example Response
{  "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  }}