Skip to main content
Piloterr
Back to library

Untappd Search API

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

Active2 credits = 1 requestGET/v2/untappd/search

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

Search beers on Untappd. Send a keyword such as ipa or stout, or a search URL whose path is /search. The response is { results, pagination } for the beer cards in the rendered results. Pass results[].id or results[].url to /v2/untappd/beer.

Each card can include brewery, style, ABV, and IBU. abv is the number inside abv_display (for example 6.2 and 6.2% ABV). ibu is the number inside ibu_display (for example 51 and 51 IBU).

QuickstartLink to Quickstart

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

GET and POST take the same query. ipa includes beer 4509, name IPA, brewery Lagunitas Brewing Company, ABV 6.2, IBU 51. The beer call for 4509 returns that same id, name, brewery, ABV, and IBU. stout includes Guinness Draught, id 4473.

ParametersLink to Parameters

Parameter Required Example
query yes ipa

query is required. A URL must be on untappd.com and its path must be /search. A beer URL belongs on the beer endpoint. Another host returns 400. There is no page parameter.

PaginationLink to Pagination

Untappd prints a drink count and loads more hits inside the page. This endpoint returns the cards present in the fetch. pagination.page is 1. pagination.next is null when the page does not expose a next URL. Do not invent one. pagination.per_page is the number of beer cards parsed, 5 for ipa and for stout. pagination.total_results is the drink count in the search stats, such as the six-digit count on ipa. pagination.total_pages is null.

Ids are unique on the page. next stays null for these keyword searches because the site does not print a next page link.

Response fieldsLink to Response fields

Field Type Meaning
results[].id string Beer id, such as 4509
results[].name string Beer name
results[].url string Beer URL, usually under /b/
results[].brewery string or null Brewery
results[].brewery_url string or null Brewery URL
results[].style string or null Style
results[].abv number or null ABV
results[].abv_display string or null Printed ABV, such as 6.2% ABV
results[].ibu number or null IBU
results[].ibu_display string or null Printed IBU, such as 51 IBU
results[].rating number or null Rating shown on the card. The beer page can print more decimal places
results[].image string or null Label image
pagination.page integer 1
pagination.per_page integer or null Cards returned
pagination.total_results number or null Drink count Untappd prints
pagination.total_pages null No page count
pagination.next null No next URL on these searches

Use casesLink to Use cases

  • Find Lagunitas IPA as id 4509 from the keyword ipa, with ABV 6.2 and IBU 51 on the card.
  • Compare ABV and IBU across the first stout cards, including Guinness Draught 4473.
  • Keep total_results as the printed drink count and stop when next is null.

Error codesLink to Error codes

Code Meaning
400 Empty query, a non-search URL, or a domain outside untappd.com
401 Missing API key
404 The page was not a beer search
500 The fetch failed

Untappd Beer

Related APIs

Expand your data capabilities with these complementary tools.

Ready to get started?

Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.

  • +500 credits
  • No credit card required
  • All endpoints included