# Open Brewery DB Scraper (`parseforge/open-brewery-db-scraper`) Actor

Scrape brewery listings across the United States. Get brewery names, types (micro, brewpub, large, contract), full addresses, GPS coordinates, phone numbers, and websites for 8,000+ breweries. Filter by state, city, brewery type, and postal code. Great for lead generation and market analysis.

- **URL**: https://apify.com/parseforge/open-brewery-db-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Lead generation, E-commerce, Other
- **Stats:** 5 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $8.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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

![ParseForge Banner](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner.jpg)

## 🍺 Open Brewery DB Scraper

> 🚀 Collect structured brewery data with names, types, full addresses, phone numbers, website URLs, and GPS coordinates from the Open Brewery DB. Filter by state, city, type, and postal code.

> 🕒 Last updated: 2026-04-17

The Open Brewery DB is an open-source dataset of breweries, primarily covering the United States. This Actor queries that database and returns structured records with brewery names, types (micro, nano, regional, brewpub, large, and more), full street addresses, phone numbers, website URLs, and latitude/longitude coordinates. You can filter by state, city, brewery type, postal code, and sort order.

If you are building a brewery finder app, researching the craft beer market, planning brewery tours, or prospecting for distribution partnerships, this scraper collects the data you need in seconds. Set it on a monthly schedule to keep your brewery database current as new locations open and others close.

| Target | Open Brewery DB |
|--------|-------------------------------|
| Use Cases | Brewery finder apps, market research, tour planning, distribution prospecting |

---

### 📋 What it does

- 🏭 **Brewery listings.** Names, types, and unique IDs for breweries across the United States.
- 📍 **Full addresses.** Street addresses, cities, states, postal codes, and countries.
- 📞 **Contact details.** Phone numbers and website URLs for each brewery.
- 🗺️ **GPS coordinates.** Latitude and longitude for mapping and geospatial analysis.
- 🔍 **Location and type filters.** Search by state, city, postal code, and brewery type.

Each record includes the brewery ID, name, type, street address, city, state, postal code, country, phone number, website URL, latitude, longitude, and scrape timestamp.

> 💡 **Why it matters:** Manually looking up brewery details one by one takes ages. This Actor collects hundreds of records with consistent formatting, complete with GPS coordinates for mapping, in a single run.

---

### 🎬 Full Demo

_🚧 Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded dataset._

---

### ⚙️ Input

<table>
<thead>
<tr><th>Input</th><th>Type</th><th>Default</th><th>Behavior</th></tr>
</thead>
<tbody>
<tr><td>state</td><td>string</td><td>"California"</td><td>Filter breweries by US state (e.g., "California", "New York", "Texas").</td></tr>
<tr><td>city</td><td>string</td><td>-</td><td>Optional city filter within the selected state.</td></tr>
<tr><td>postalCode</td><td>string</td><td>-</td><td>Filter by ZIP code (e.g., "44107" or "44107-9863").</td></tr>
<tr><td>breweryType</td><td>string</td><td>-</td><td>Filter by type: micro, nano, regional, brewpub, large, planning, bar, contract, proprietor, or closed.</td></tr>
<tr><td>sort</td><td>string</td><td>-</td><td>Sort by: name, city, state, or type.</td></tr>
<tr><td>maxItems</td><td>integer</td><td>10</td><td>Maximum breweries to return. Free users limited to 10. Paid users up to 1,000,000.</td></tr>
</tbody>
</table>

**Example: Microbreweries in California sorted by name.**

```json
{
    "state": "California",
    "breweryType": "micro",
    "sort": "name",
    "maxItems": 50
}
````

**Example: All breweries in Portland.**

```json
{
    "state": "Oregon",
    "city": "Portland",
    "maxItems": 100
}
```

> ⚠️ **Good to Know:** The Open Brewery DB is community-maintained and focuses primarily on US breweries. Some entries may have missing phone numbers or GPS coordinates. Schedule periodic runs to catch new additions.

***

### 📊 Output

Each record contains **15+ fields**. Download as CSV, Excel, JSON, or XML.

#### 🧾 Schema

| Field | Type | Example |
|---|---|---|
| 📋 `name` | string | `"Sierra Nevada Brewing Co"` |
| 🏷️ `breweryType` | string | `"regional"` |
| 📍 `address1` | string | `"1075 E 20th St"` |
| 🏙️ `city` | string | `"Chico"` |
| 🗺️ `stateProvince` | string | `"California"` |
| 📮 `postalCode` | string | `"95928-6722"` |
| 🌍 `country` | string | `"United States"` |
| 📞 `phone` | string | `"5308932520"` |
| 🔗 `websiteUrl` | string | `"http://www.sierranevada.com"` |
| 📍 `latitude` | string | `"39.7242"` |
| 📍 `longitude` | string | `"-121.7867"` |
| 🆔 `id` | string | `"sierra-nevada-brewing-co-chico"` |

#### 📦 Sample records

<details>
<summary><strong>🏭 Regional brewery</strong></summary>

```json
{
    "id": "sierra-nevada-brewing-co-chico",
    "name": "Sierra Nevada Brewing Co",
    "breweryType": "regional",
    "address1": "1075 E 20th St",
    "city": "Chico",
    "stateProvince": "California",
    "postalCode": "95928-6722",
    "country": "United States",
    "phone": "5308932520",
    "websiteUrl": "http://www.sierranevada.com",
    "latitude": "39.7242",
    "longitude": "-121.7867",
    "street": "1075 E 20th St",
    "scrapedAt": "2026-04-09T12:00:00.000Z"
}
```

</details>

<details>
<summary><strong>🍻 Microbrewery</strong></summary>

```json
{
    "id": "russian-river-brewing-company-santa-rosa",
    "name": "Russian River Brewing Company",
    "breweryType": "micro",
    "address1": "725 4th St",
    "city": "Santa Rosa",
    "stateProvince": "California",
    "postalCode": "95404-4449",
    "country": "United States",
    "phone": "7075457860",
    "websiteUrl": "http://www.russianriverbrewing.com",
    "latitude": "38.4408",
    "longitude": "-122.7133",
    "street": "725 4th St",
    "scrapedAt": "2026-04-09T12:05:00.000Z"
}
```

</details>

<details>
<summary><strong>🍽️ Brewpub</strong></summary>

```json
{
    "id": "21st-amendment-brewery-cafe-san-francisco",
    "name": "21st Amendment Brewery Cafe",
    "breweryType": "brewpub",
    "address1": "563 2nd St",
    "city": "San Francisco",
    "stateProvince": "California",
    "postalCode": "94107-1470",
    "country": "United States",
    "phone": "4153690900",
    "websiteUrl": "http://www.21st-amendment.com",
    "latitude": "37.7827",
    "longitude": "-122.3927",
    "street": "563 2nd St",
    "scrapedAt": "2026-04-09T12:10:00.000Z"
}
```

</details>

***

### ✨ Why choose this Actor

| | Capability |
|---|---|
| 🏭 | **10 brewery types.** Micro, nano, regional, brewpub, large, planning, bar, contract, proprietor, and closed. |
| 🗺️ | **GPS coordinates.** Latitude and longitude for mapping and geospatial work. |
| 📞 | **Contact details.** Phone numbers and website URLs included. |
| 📍 | **Location filtering.** Search by state, city, or postal code. |
| 📊 | **Sortable results.** Order by name, city, state, or type. |
| 📅 | **Schedule-ready.** Set monthly runs to track new brewery openings. |
| 📊 | **Multiple exports.** Download as CSV, Excel, JSON, or XML. |

> The United States has over 9,000 craft breweries, and that number changes every month as new ones open and others close. Keeping a directory current requires regular data refreshes.

***

### 📈 How it compares to alternatives

| Approach | Cost | Coverage | Refresh | Setup |
|---|---|---|---|---|
| **⭐ Open Brewery DB Scraper** *(this Actor)* | $5 free credit, then pay-per-use | US breweries + some intl | **Live per run** | ⚡ 2 min |
| Manual web searches | Free | Limited by time | Manual checks | 🕐 Hours |
| Open Brewery DB API | Free | Same dataset | Per request | 🔧 1-2 hours |
| Third-party brewery databases | $50-200/mo | Varies | Monthly | 📋 30 min |

Pick this Actor when you want structured brewery data with GPS coordinates without writing API code or managing pagination yourself.

***

### 🚀 How to use

1. 📝 **Sign up.** [Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) (takes 2 minutes).
2. 🌐 **Open the Actor.** Go to the Open Brewery DB Scraper page on the Apify Store.
3. 🎯 **Set input.** Choose a state, city, brewery type, and set your max items.
4. 🚀 **Run it.** Click **Start** and let the Actor collect your data.
5. 📥 **Download.** Grab your results in the **Dataset** tab as CSV, Excel, JSON, or XML.

> ⏱️ Total time from signup to downloaded dataset: **3-5 minutes.** No coding required.

***

### 💼 Business use cases

<table>
<tr>
<td width="50%" valign="top">

#### 🗺️ App Development

- Build brewery finder apps with GPS coordinates
- Create interactive maps of craft breweries by region
- Populate location databases for beer tourism apps
- Add brewery contact data to business directories

</td>
<td width="50%" valign="top">

#### 📊 Market Research

- Analyze craft beer industry density by state and city
- Track brewery types (micro vs. regional vs. brewpub)
- Study geographic clustering of craft breweries
- Compare brewery counts across metropolitan areas

</td>
</tr>
<tr>
<td width="50%" valign="top">

#### 🚐 Tourism and Events

- Plan brewery tour routes with addresses and coordinates
- Build curated brewery guides for specific cities
- Create event listings around brewery districts
- Generate tour packages with contact details

</td>
<td width="50%" valign="top">

#### 🛒 Distribution and Sales

- Identify breweries by region and type for prospecting
- Build sales territories based on brewery density
- Track new brewery openings for outreach
- Segment by type for targeted marketing

</td>
</tr>
</table>

***

***

### 🌟 Beyond business use cases

Data like this powers more than commercial workflows. The same structured records support research, education, civic projects, and personal initiatives.

<table>
<tr>
<td width="50%">

#### 🎓 Research and academia

- Empirical datasets for papers, thesis work, and coursework
- Longitudinal studies tracking changes across snapshots
- Reproducible research with cited, versioned data pulls
- Classroom exercises on data analysis and ethical scraping

</td>
<td width="50%">

#### 🎨 Personal and creative

- Side projects, portfolio demos, and indie app launches
- Data visualizations, dashboards, and infographics
- Content research for bloggers, YouTubers, and podcasters
- Hobbyist collections and personal trackers

</td>
</tr>
<tr>
<td width="50%">

#### 🤝 Non-profit and civic

- Transparency reporting and accountability projects
- Advocacy campaigns backed by public-interest data
- Community-run databases for local issues
- Investigative journalism on public records

</td>
<td width="50%">

#### 🧪 Experimentation

- Prototype AI and machine-learning pipelines with real data
- Validate product-market hypotheses before engineering spend
- Train small domain-specific models on niche corpora
- Test dashboard concepts with live input

</td>
</tr>
</table>

### 🤖 Ask an AI assistant about this scraper

Open a ready-to-send prompt about this ParseForge actor in the AI of your choice:

- 💬 [**ChatGPT**](https://chat.openai.com/?q=How%20do%20I%20use%20the%20Open%20Brewery%20DB%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🧠 [**Claude**](https://claude.ai/new?q=How%20do%20I%20use%20the%20Open%20Brewery%20DB%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🔍 [**Perplexity**](https://perplexity.ai/search?q=How%20do%20I%20use%20the%20Open%20Brewery%20DB%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🅒 [**Copilot**](https://copilot.microsoft.com/?q=How%20do%20I%20use%20the%20Open%20Brewery%20DB%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)

### ❓ Frequently Asked Questions

#### 💳 Do I need a paid Apify plan to run this actor?

No. You can start right now on the free Apify plan, which includes **$5 in free monthly credit**. That is enough to run this actor several times and explore the output before committing to anything. Paid plans unlock higher limits, more concurrent runs, and larger datasets. [Create a free Apify account here](https://console.apify.com/sign-up?fpr=vmoqkp) to get started.

#### 🚨 What happens if my run fails or returns no results?

Failed runs are not charged. If the source site changes, proxies get rate-limited, or a specific input matches nothing, re-run the actor or open our [contact form](https://tally.so/r/BzdKgA) and we will investigate. You can also check the run log in the Apify console to see why the run stopped.

#### 📏 How many items can I scrape per run?

Free users are limited to **10 items per run** so you can preview the output and confirm the actor works for your use case. Paid users can raise `maxItems` up to **1,000,000** per run. [Upgrade here](https://console.apify.com/sign-up?fpr=vmoqkp) if you need full scale.

#### 🕒 How fresh is the data?

Every run fetches live data at the moment of execution. There is no cache or delay: the records you get reflect what the source returned at that moment. Schedule the actor to maintain a rolling snapshot of the data you need.

#### 🧑‍💻 Can I call this actor from my own code?

Yes. Apify exposes every actor as a REST endpoint and ships first-class SDKs for [Node.js](https://docs.apify.com/sdk/js) and [Python](https://docs.apify.com/sdk/python). You can start a run, read the dataset, and handle webhooks from your own app in a few lines. All you need is your Apify API token.

#### 📤 How do I export the data?

Every Apify dataset can be downloaded in one click from the console as CSV, JSON, JSONL, Excel, HTML, XML, or RSS. You can also pull results programmatically via the [Apify API](https://docs.apify.com/api/v2) or stream them into BigQuery, S3, and other destinations through built-in integrations.

#### 📅 Can I schedule the actor to run automatically?

Yes. Use the Apify scheduler to run the actor on any cadence, from hourly to monthly. Results are saved to your dataset and can be delivered to webhooks, email, Slack, cloud storage, or automation tools such as Zapier and Make.

***

### 🔌 Automating Open Brewery DB Scraper

Control the scraper programmatically for scheduled runs and pipeline integrations:

- 🟢 **Node.js.** Install the `apify-client` NPM package.
- 🐍 **Python.** Use the `apify-client` PyPI package.
- 📚 See the [Apify API documentation](https://docs.apify.com/api/v2) for full details.

The [Apify Schedules feature](https://docs.apify.com/platform/schedules) lets you trigger this Actor on any cron interval. Run it monthly to track new brewery openings and closings in your target markets.

### 🔌 Integrate with any app

Open Brewery DB Scraper connects to any cloud service via [Apify integrations](https://apify.com/integrations):

- [**Make**](https://docs.apify.com/platform/integrations/make) - Automate multi-step workflows
- [**Zapier**](https://docs.apify.com/platform/integrations/zapier) - Connect with 5,000+ apps
- [**Slack**](https://docs.apify.com/platform/integrations/slack) - Get run notifications
- [**Airbyte**](https://docs.apify.com/platform/integrations/airbyte) - Pipe data into your warehouse
- [**GitHub**](https://docs.apify.com/platform/integrations/github) - Trigger runs from commits
- [**Google Drive**](https://docs.apify.com/platform/integrations/drive) - Export datasets straight to Sheets

You can also use webhooks to trigger downstream actions when a run finishes.

***

### 🔗 Recommended Actors

- [**🏫 Greatschools Scraper**](https://apify.com/parseforge/greatschools-scraper) - Collect school ratings and reviews by location
- [**🏠 REMAX Real Estate Scraper**](https://apify.com/parseforge/remax-scraper) - Scrape real estate listings with addresses
- [**📊 Smart Apify Actor Scraper**](https://apify.com/parseforge/smart-apify-actor-scraper) - Scrape Apify Store actors with 70+ fields
- [**📰 PR Newswire Scraper**](https://apify.com/parseforge/pr-newswire-scraper) - Collect press releases and corporate news
- [**🧠 HTML to JSON Smart Parser**](https://apify.com/parseforge/html-to-json-smart-parser) - Parse any web page into structured JSON

> 💡 **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for more data scrapers and tools.

***

**🆘 Need Help?** [**Open our contact form**](https://tally.so/r/BzdKgA) to request a new scraper, propose a custom data project, or report an issue.

***

> **⚠️ Disclaimer:** this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Open Brewery DB or its maintainers. All trademarks mentioned are the property of their respective owners. Only publicly available data is collected.

# Actor input Schema

## `maxItems` (type: `integer`):

Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000

## `state` (type: `string`):

Filter breweries by US state (e.g., California, New York, Texas).

## `city` (type: `string`):

Optional: Filter breweries by city.

## `postalCode` (type: `string`):

Filter breweries by postal/zip code (e.g., '44107' or '44107-9863').

## `breweryType` (type: `string`):

Filter by brewery type.

## `sort` (type: `string`):

Sort results by this field.

## Actor input object example

```json
{
  "maxItems": 10,
  "state": "California"
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "maxItems": 10,
    "state": "California"
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/open-brewery-db-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "maxItems": 10,
    "state": "California",
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/open-brewery-db-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 '{
  "maxItems": 10,
  "state": "California"
}' |
apify call parseforge/open-brewery-db-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=parseforge/open-brewery-db-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Open Brewery DB Scraper",
        "description": "Scrape brewery listings across the United States. Get brewery names, types (micro, brewpub, large, contract), full addresses, GPS coordinates, phone numbers, and websites for 8,000+ breweries. Filter by state, city, brewery type, and postal code. Great for lead generation and market analysis.",
        "version": "0.0",
        "x-build-id": "yMsnrM3d2k7GBSz9a"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/parseforge~open-brewery-db-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-parseforge-open-brewery-db-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/parseforge~open-brewery-db-scraper/runs": {
            "post": {
                "operationId": "runs-sync-parseforge-open-brewery-db-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/parseforge~open-brewery-db-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-parseforge-open-brewery-db-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": {
                    "maxItems": {
                        "title": "Max Items",
                        "minimum": 1,
                        "maximum": 1000000,
                        "type": "integer",
                        "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000"
                    },
                    "state": {
                        "title": "State",
                        "type": "string",
                        "description": "Filter breweries by US state (e.g., California, New York, Texas)."
                    },
                    "city": {
                        "title": "City",
                        "type": "string",
                        "description": "Optional: Filter breweries by city."
                    },
                    "postalCode": {
                        "title": "Postal Code",
                        "type": "string",
                        "description": "Filter breweries by postal/zip code (e.g., '44107' or '44107-9863')."
                    },
                    "breweryType": {
                        "title": "Brewery Type",
                        "enum": [
                            "",
                            "micro",
                            "nano",
                            "regional",
                            "brewpub",
                            "large",
                            "planning",
                            "bar",
                            "contract",
                            "proprietor",
                            "closed"
                        ],
                        "type": "string",
                        "description": "Filter by brewery type."
                    },
                    "sort": {
                        "title": "Sort By",
                        "enum": [
                            "",
                            "name",
                            "city",
                            "state",
                            "type"
                        ],
                        "type": "string",
                        "description": "Sort results by this field."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
