# BeerConnoisseur Scraper - Beer Reviews & Ratings (`lulzasaur/beerconnoisseur-scraper`) Actor Scrape beer reviews from beerconnoisseur.com. Get BJCP judge ratings, ABV, IBU, hops, malts, brewery info, tasting notes. Search by beer name, style, or brewery. 3,400+ expert reviews. - **URL**: https://apify.com/lulzasaur/beerconnoisseur-scraper.md - **Developed by:** [lulz bot](https://apify.com/lulzasaur) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $10.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## BeerConnoisseur Scraper Extract expert beer reviews and BJCP judge ratings from [beerconnoisseur.com](https://beerconnoisseur.com). Access 3,400+ professional beer reviews with detailed tasting notes, rating breakdowns, brewery information, and beer specifications. ### What does BeerConnoisseur Scraper do? This scraper extracts structured data from BeerConnoisseur.com's beer review database using their WordPress REST API. It collects: - **Beer ratings** - BJCP certified judge scores (0-100) with detailed breakdowns for aroma, appearance, flavor, mouthfeel, and overall impression - **Beer specifications** - ABV, IBU, hops, malts, style, style family, and availability - **Brewery information** - Name, city, state, and country - **Review content** - Full judge tasting notes and brewer descriptions - **Metadata** - Publication date, categories, tags, and featured images ### Features - **Search by keyword** - Find beers by name, style, brewery, or any keyword - **Browse latest reviews** - Scrape the most recent beer reviews without a search query - **Full detail mode** - Enable `scrapeDetails` to get complete review text and linked judge reviews - **Fast API-based scraping** - Uses the WordPress REST API directly (no browser needed) - **Automatic pagination** - Handles multi-page results automatically - **Pay-per-event billing** - Only pay for results you actually receive ### Input | Field | Type | Default | Description | |-------|------|---------|-------------| | `searchQueries` | string[] | `[]` | Beer names, styles, or breweries to search. Leave empty for latest reviews. | | `maxListings` | integer | `100` | Maximum number of beer reviews to scrape (1-5000). | | `scrapeDetails` | boolean | `false` | Get full review text, brewer descriptions, and linked judge reviews. | | `proxyConfiguration` | object | - | Optional proxy settings. | #### Example Input ```json { "searchQueries": ["IPA", "Stout"], "maxListings": 50, "scrapeDetails": true } ```` ### Output Each beer review includes the following fields: | Field | Type | Description | |-------|------|-------------| | `title` | string | Beer name | | `brewery` | string | Brewery name | | `breweryLocation` | string | City, State | | `breweryCountry` | string | Country | | `style` | string | Beer style (e.g., "Hazy IPA") | | `styleFamily` | string | Style family (e.g., "IPA") | | `abv` | string | Alcohol by volume | | `ibus` | string | International Bitterness Units | | `hops` | string | Hop varieties used | | `malts` | string | Malt varieties used | | `availability` | string | Availability (Year-Round, Seasonal, Limited) | | `rating` | number | BJCP judge rating (0-100) | | `ratingLabel` | string | Rating label (Exceptional, Very Good, etc.) | | `ratingBreakdown` | object | Detailed score breakdown (aroma, appearance, flavor, mouthfeel, overall) | | `reviewer` | string | Judge name | | `reviewerTitle` | string | Judge credentials | | `reviewContent` | string | Full tasting notes (when `scrapeDetails` is true) | | `brewerDescription` | string | Brewer's own description (when `scrapeDetails` is true) | | `publishDate` | string | Publication date (ISO 8601) | | `categories` | string\[] | Categories (e.g., "Beer Reviews") | | `tags` | string\[] | Tags | | `imageUrl` | string | Featured image URL | | `url` | string | Full review URL | | `searchQuery` | string | The search query that found this result | | `scrapedAt` | string | Timestamp of when the data was scraped | #### Example Output ```json { "title": "Tiki Like a Fox", "brewery": "New Realm Brewing", "breweryLocation": "Atlanta, GA", "breweryCountry": "USA", "style": "Hazy IPA", "styleFamily": "IPA", "abv": "6.5%", "ibus": "45", "hops": "Azacca, El Dorado", "malts": "Pale Malt, Wheat, Oats", "availability": "Year-Round", "rating": 92, "ratingLabel": "Exceptional", "ratingBreakdown": { "aroma": "22/24", "appearance": "6/6", "flavor": "36/40", "mouthfeel": "10/10", "overallImpression": "18/20" }, "reviewer": "Dan Preston", "reviewerTitle": "BJCP National Judge", "publishDate": "2026-02-12T14:42:49", "categories": ["Beer Reviews"], "imageUrl": "https://beerconnoisseur.com/wp-content/uploads/2026/02/tiki-like-a-fox.jpg", "url": "https://beerconnoisseur.com/beer/tiki-like-a-fox/", "scrapedAt": "2026-04-25T12:00:00.000Z" } ``` ### Use Cases - **Beer discovery** - Find top-rated beers by style or brewery - **Market research** - Analyze trends in beer styles, ratings, and ingredients - **Brewery analysis** - Compare ratings across breweries or regions - **Price comparison** - Cross-reference expert ratings with retail listings - **Content creation** - Build beer recommendation engines or review aggregators - **Data journalism** - Analyze patterns in craft beer industry ### How much will it cost? This scraper uses pay-per-event pricing at **$0.50 per 1,000 results**. A typical run scraping 100 beer reviews costs about $0.05. The API-based approach uses minimal compute resources compared to browser-based scrapers. | Results | Estimated Cost | |---------|---------------| | 100 | ~$0.05 | | 500 | ~$0.25 | | 1,000 | ~$0.50 | | 3,400 (all reviews) | ~$1.70 | ### Tips - **Start small** - Try `maxListings: 10` first to verify the output format meets your needs - **Use search queries** - Searching by style (e.g., "IPA", "Stout", "Pilsner") is the fastest way to find specific beers - **Enable details selectively** - `scrapeDetails: true` provides full review text but makes additional API calls per beer - **No proxy needed** - The WordPress REST API is public and generally doesn't require proxies # Actor input Schema ## `searchQueries` (type: `array`): Beer names, styles, or breweries to search for (e.g. "IPA", "Sierra Nevada", "Stout"). Leave empty to scrape latest reviews. ## `maxListings` (type: `integer`): Maximum number of beer reviews to scrape (1-5000). ## `scrapeDetails` (type: `boolean`): Get full review content, brewer descriptions, and linked judge reviews. Slightly slower due to additional API calls. ## `proxyConfiguration` (type: `object`): Optional proxy configuration for requests. ## Actor input object example ```json { "searchQueries": [ "IPA" ], "maxListings": 100, "scrapeDetails": false } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchQueries": [ "IPA" ] }; // Run the Actor and wait for it to finish const run = await client.actor("lulzasaur/beerconnoisseur-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchQueries": ["IPA"] } # Run the Actor and wait for it to finish run = client.actor("lulzasaur/beerconnoisseur-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchQueries": [ "IPA" ] }' | apify call lulzasaur/beerconnoisseur-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=lulzasaur/beerconnoisseur-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "BeerConnoisseur Scraper - Beer Reviews & Ratings", "description": "Scrape beer reviews from beerconnoisseur.com. Get BJCP judge ratings, ABV, IBU, hops, malts, brewery info, tasting notes. Search by beer name, style, or brewery. 3,400+ expert reviews.", "version": "1.0", "x-build-id": "FGs9A1CICddU4ZSjl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lulzasaur~beerconnoisseur-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lulzasaur-beerconnoisseur-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/lulzasaur~beerconnoisseur-scraper/runs": { "post": { "operationId": "runs-sync-lulzasaur-beerconnoisseur-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/lulzasaur~beerconnoisseur-scraper/run-sync": { "post": { "operationId": "run-sync-lulzasaur-beerconnoisseur-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchQueries": { "title": "Search Queries", "type": "array", "description": "Beer names, styles, or breweries to search for (e.g. \"IPA\", \"Sierra Nevada\", \"Stout\"). Leave empty to scrape latest reviews.", "items": { "type": "string" } }, "maxListings": { "title": "Max Listings", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of beer reviews to scrape (1-5000).", "default": 100 }, "scrapeDetails": { "title": "Scrape Full Details", "type": "boolean", "description": "Get full review content, brewer descriptions, and linked judge reviews. Slightly slower due to additional API calls.", "default": false }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Optional proxy configuration for requests." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```