# Beer Scraper Extract comprehensive brewery data from Open Brewery DB, the largest open database of breweries worldwide. This powerful scraper enables beer enthusiasts, analysts, and developers to access thousands of brewery records for market analysis, brewery discovery, and data-driven insights. ## 🚀 Key Features - Advanced Search & Filtering: Search breweries by name, location, and type - High-Volume Data Collection: Retrieve thousands of brewery records with automatic pagination - Structured Data Output: Clean, consistent JSON output ready for analysis - Automatic Error Handling: Built-in retries and error management - Geographic Filtering: Filter by city, state, country, and postal code ## 📊 What You Can Scrape - Brewery Details: Names, types, addresses, contact info, and websites - Location Data: City, state, country, postal codes, and coordinates - Brewery Types: Micro, nano, regional, brewpub, large, planning, contract, proprietor, closed ## 🔧 Input Configuration Configure your scraping job with these parameters: | Parameter | Type | Description | Default | |-----------|------|-------------|---------| | search | string | Search query for brewery names | "" | | by_city | string | Filter by city | "" | | by_country | string | Filter by country | "" | | by_state | string | Filter by state (full name) | "" | | by_postal | string | Filter by postal / ZIP code | "" | | by_type | select | Filter by brewery type | "" | | results_wanted | integer | Maximum results to collect | 100 | | max_pages | integer | Maximum API pages to fetch | 10 | | sort | string | Sort order (name:asc/desc) | "name:asc" | ### Brewery Type Options - micro - Most craft breweries - nano - Extremely small breweries - regional - Regional location of expanded brewery - brewpub - Beer-focused restaurant with brewery - large - Very large brewery - planning - Brewery in planning - contract - Uses another brewery's equipment - proprietor - Brewery incubator - closed - Closed location ### Example Inputs json { "search": "Sierra Nevada", "by_country": "United States", "by_type": "micro", "results_wanted": 50 } ## 📤 Output Data Structure ### Brewery Example json { "id": "5128df48-79fc-4f0f-8b52-d06be54d0cec", "name": "Sierra Nevada Brewing Co", "brewery_type": "regional", "address_1": "1075 E 20th St", "address_2": null, "address_3": null, "city": "Chico", "state_province": "California", "postal_code": "95928-0210", "country": "United States", "longitude": "-121.876", "latitude": "39.724", "phone": "5308933520", "website_url": "http://www.sierranevada.com", "state": "California", "street": "1075 E 20th St", "url": "http://www.sierranevada.com", "source": "openbrewerydb.org" } ## 🎯 Usage Examples ### Search for Breweries by Name json { "search": "Stone Brewing", "results_wanted": 10 } ### Find Micro Breweries in California json { "by_state": "California", "by_type": "micro", "results_wanted": 100, "sort": "name:asc" } ### Breweries in a Specific City json { "by_city": "Portland", "by_country": "United States", "by_postal": "97201", "results_wanted": 50 } ## ⚙️ Advanced Configuration ### Optimizing for Large Datasets - Set appropriate max_pages to control API usage - Use specific filters to narrow results before pagination - Sort by name for alphabetical ordering ### Data Filtering Tips - Use by_country for international searches - Filter by by_type for specific brewery categories - Combine city and state for precise location targeting ## 📈 Use Cases - Brewery Discovery: Find breweries by location and type - Market Analysis: Analyze brewery distribution and types - Beer Tourism: Plan brewery tours with location data - Business Intelligence: Track brewery openings and closures - Data Analysis: Geographic and demographic brewery studies ## 🔍 API Integration This actor integrates with the public Open Brewery DB REST API to provide comprehensive brewery listings and metadata. See the dedicated API Integration section above for important details. ## 📋 Limits & Considerations - Data Coverage: Over 8,000 breweries worldwide - Data Freshness: Regularly updated community-driven database - Geographic Coverage: Primarily US-focused with international additions ## 🤝 Contributing Found a bug or have a feature request? Open an issue on our GitHub repository. ## 📄 License This project is licensed under the MIT License - see the LICENSE file for details. --- Keywords: beer scraper, brewery data, Open Brewery DB, craft beer API, brewery finder, beer tourism, brewery database