Untappd Beer & Brewery Scraper

Scrape Untappd — the world's largest beer check-in and rating community. Search beers or breweries, browse the global top-rated beer list, and fetch full beer or brewery detail: style, ABV, IBU, ratings, descriptions, locations, and images. No login, no API key, no cookies.

What this actor does

• Five modes: search, searchBreweries, topRated, byBeerIds, byBreweryIds
• Full beer detail — style, ABV, IBU, description, rating, rating count, label image, top reviews
• Full brewery detail — type, location, rating, total check-ins, website, social links, parent company
• Filters — minimum rating, ABV range, style substring match, top-rated-list style/country scoping
• Empty fields are omitted — every record only contains data Untappd actually returned

Output per beer

• beerId, beerName, breweryName, breweryUrl
• style, description
• abv (%), ibu
• rating (0–5), ratingCount
• labelImageUrl, beerUrl
• topReviews[] — authorName, reviewText, rating, datePublished (detail mode)
• recordType: "beer", scrapedAt

Output per brewery

• breweryId, breweryName, breweryType
• location, city, state, streetAddress
• description, website, instagramUrl, twitterUrl, facebookUrl
• logoImageUrl, parentCompany
• rating (0–5), totalCheckins, uniqueVisitorCount, monthlyCheckinCount
• breweryUrl
• recordType: "brewery", scrapedAt

Input

Field	Type	Default	Description
mode	string	search	search / searchBreweries / topRated / byBeerIds / byBreweryIds
searchQuery	string	ipa	Beer or brewery name/keyword
beerIds	array	–	Beer IDs or URLs (mode=byBeerIds)
breweryIds	array	–	Brewery IDs, vanity slugs, or URLs (mode=byBreweryIds)
minRating	number	–	Minimum average rating (0–5)
abvMin	number	–	Minimum ABV %
abvMax	number	–	Maximum ABV %
styleContains	string	–	Only keep beers whose style contains this text
topRatedStyle	select	–	Scope topRated to one of Untappd's ~320 beer styles (mode=topRated)
topRatedCountry	select	–	Scope topRated to breweries from one of ~220 countries (mode=topRated)
useProxy	bool	false	Route through Apify's free AUTO proxy (rarely needed)
maxItems	int	20	Hard cap (1–200). Note: topRated cannot exceed 50 regardless of this value (see FAQ)

Example: top-rated American IPAs

{
  "mode": "topRated",
  "topRatedStyle": "ipa-american",
  "maxItems": 50
}

Example: top-rated Belgian Imperial Stouts

{
  "mode": "topRated",
  "topRatedStyle": "stout-imperial-double",
  "topRatedCountry": "belgium",
  "maxItems": 25
}

Example: full beer detail with reviews

{
  "mode": "byBeerIds",
  "beerIds": ["1", "https://untappd.com/beer/38712"]
}

Example: brewery lookup by vanity slug

{
  "mode": "byBreweryIds",
  "breweryIds": ["magichat", "812"]
}

Use cases

• Beer discovery apps — power a "find a beer" search feature with real ratings and style data
• Craft beer market research — track style popularity, ABV trends, and top-rated releases
• Brewery directories — pull location, type, and rating data for brewery listing sites
• Menu / tap-list enrichment — attach Untappd ratings and descriptions to a bar or restaurant's beer list
• Recommendation engines — feed style + rating + ABV data into a beer recommender

FAQ

Do I need an Untappd account or cookies? No. Beer detail, brewery detail, search, and the top-rated list are all public pages, readable without logging in.

Why does search/searchBreweries only return up to 5 results? Untappd itself caps search result depth at 5 items per query for anonymous (logged-out) visitors, showing a "Please sign in to view more" prompt beyond that — this is Untappd's own access policy, not a limitation of the actor. For larger result sets, use topRated (no login-gated cap) or look up specific beers/breweries directly with byBeerIds / byBreweryIds.

Is the check-in social feed (who drank what, when) available? No — that data lives behind Untappd's login wall and is out of scope. This actor only surfaces the public catalog data: beer/brewery facts and aggregate ratings.

Where does the rating come from? Untappd's own aggregate rating (0–5 scale) computed from all user check-ins, the same number shown on the beer/brewery page.

Why do brewery search results have fewer fields than byBreweryIds? Untappd's brewery search cards show placeholder/zeroed stats regardless of the brewery's real numbers, so the actor doesn't surface unreliable data from search cards — look up the exact brewery with byBreweryIds for accurate rating and check-in counts.

Can I filter by beer style directly? Yes — set topRatedStyle (mode=topRated) to browse Untappd's own style-scoped top-rated list (e.g. ipa-american, stout-imperial-double), which returns a genuinely different, style-specific ranking rather than a client-side filter over the global top 50. You can also combine it with topRatedCountry to scope by brewery country (e.g. Belgian lambics), or use styleContains for a simple substring match on any mode's results.

Does raising maxItems get me more than 50 results from topRated? No. topRated returns Untappd's Top-Rated page, which is a single unpaginated list of at most 50 beers per style/country scope — Untappd exposes no further pages of this list to anonymous visitors, so topRated can never return more than 50 records no matter how high maxItems is set. To get a different set of ~50 beers, narrow the scope with topRatedStyle and/or topRatedCountry instead. For larger, effectively unbounded result sets, use byBeerIds/byBreweryIds with an explicit ID list.

What if a beer or brewery ID doesn't exist? The run reports which IDs weren't found and still returns records for the ones that were — a bad ID never aborts the whole run.

Will the beerUrl/breweryUrl links open for me? Yes, in a normal web browser — that's exactly how the actor itself renders them. Untappd's Cloudflare protection challenges non-browser tools (curl, plain HTTP scripts) on these page routes, so don't expect a bare curl request to a beer/brewery URL to succeed; opening the same link in Chrome, Firefox, Safari, etc. works fine. Image URLs (labelImageUrl, logoImageUrl) are served from Untappd's asset CDN and are not affected — they load in any client.