# Brewery API
> Search, filter and look up breweries worldwide by name, city, state, country or type — with full address, geo-coordinates, phone and website. Plus a random-brewery endpoint. Great for travel, hospitality, beer-discovery, mapping and local-business apps.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/brewery-api/..."
```

## Pricing
- **Free** (Free) — 3,000 calls/Mo, 2 req/s
- **Basic** ($6/Mo) — 120,000 calls/Mo, 8 req/s
- **Pro** ($19/Mo) — 600,000 calls/Mo, 20 req/s
- **Mega** ($49/Mo) — 2,500,000 calls/Mo, 50 req/s

## Endpoints

### Breweries

#### `GET /v1/breweries` — Filter breweries

**Parameters:**
- `city` (query, optional, string) — City Example: `Portland`
- `type` (query, optional, string) — micro nano regional brewpub large … Example: `micro`
- `state` (query, optional, string) — State/province
- `country` (query, optional, string) — Country
- `limit` (query, optional, string) — Max 1-50 Example: `15`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/brewery-api/v1/breweries?city=Portland&type=micro&limit=15"
```

**Response:**
```json
{
    "data": {
        "count": 15,
        "results": [
            {
                "id": "b7db853a-e8aa-430f-84c8-d49b72184d01",
                "city": "Portland",
                "name": "Alameda Brewing Co",
                "phone": "5034609025",
                "state": "Oregon",
                "street": "4736 SE 24th Ave",
                "country": "United States",
                "website": null,
                "latitude": 45.48882655,
                "longitude": -122.6412495,
                "postal_code": "97202-4787",
                "brewery_type": "micro"
            },
            {
                "id": "07ad4030-fb5b-4eb7-9b28-d7f5556b145d",
                "city": "Portland",
                "name": "Alameda Brewing Co",
                "phone": "5034609025",
                "state": "Oregon",
                "street": "4765 NE Fremont St",
                "country": "United States",
                "website": "http://www.alamedabrewing.com",
                "latitude": 45.54849565,
                "longitude": -122.6136209,
                "postal_code": "97213-1724",
                "brewery_type": "micro"
            },
            {
                "id": "4cc17a95-7020-43f2-bc23-b9d9ddd29a10",
                "city": "Portland",
                "name": "Arlington Club",
                "phone": "5032234141",
                "state": "Oregon",
                "street": "811 SW Salmon St",
                "country": "United States",
                "
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/brewery` — Brewery by id

**Parameters:**
- `id` (query, required, string) — Brewery id Example: `78c50e54-34e3-415d-9574-ac0cc0505113`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/brewery-api/v1/brewery?id=78c50e54-34e3-415d-9574-ac0cc0505113"
```

**Response:**
```json
{
    "data": {
        "id": "78c50e54-34e3-415d-9574-ac0cc0505113",
        "city": "Renton",
        "name": "Dog & Pony Alehouse and Grill",
        "phone": "4252548080",
        "state": "Washington",
        "street": "351 Park Ave N",
        "country": "United States",
        "website": "http://www.thedogandpony.com",
        "latitude": 47.48758261,
        "longitude": -122.2023129,
        "postal_code": "98057-5716",
        "brewery_type": "closed"
    },
    "meta": {
        "timestamp": "2026-05-30T05:28:21.317Z",
        "request_id": "d9955ae1-4455-408b-b353-33927466ae7e"
    },
    "status": "ok",
    "message": "Brewery retrieved",
    "success": true
}
```

#### `GET /v1/random` — Random brewery

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/brewery-api/v1/random"
```

**Response:**
```json
{
    "data": {
        "id": "1da7a405-aa63-4c51-8b69-1fbb121d8bbe",
        "city": "Pilsting",
        "name": "Egerer",
        "phone": "+49 9953 3010",
        "state": "Bayern",
        "street": "27 Dachinger Straße",
        "country": "Germany",
        "website": "http://www.egerer.de",
        "latitude": 48.7001764,
        "longitude": 12.6003458,
        "postal_code": "94431",
        "brewery_type": "brewpub"
    },
    "meta": {
        "timestamp": "2026-05-30T05:28:21.870Z",
        "request_id": "b39c5344-6ffd-40ed-8747-f03f22b55bd7"
    },
    "status": "ok",
    "message": "Random brewery retrieved",
    "success": true
}
```

#### `GET /v1/search` — Search breweries

**Parameters:**
- `q` (query, required, string) — Search term Example: `dog`
- `limit` (query, optional, string) — Max 1-50 Example: `15`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/brewery-api/v1/search?q=dog&limit=15"
```

**Response:**
```json
{
    "data": {
        "count": 15,
        "query": "dog",
        "results": [
            {
                "id": "78c50e54-34e3-415d-9574-ac0cc0505113",
                "city": "Renton",
                "name": "Dog & Pony Alehouse and Grill",
                "phone": "4252548080",
                "state": "Washington",
                "street": "351 Park Ave N",
                "country": "United States",
                "website": "http://www.thedogandpony.com",
                "latitude": 47.48758261,
                "longitude": -122.2023129,
                "postal_code": "98057-5716",
                "brewery_type": "closed"
            },
            {
                "id": "b29882fe-e037-4e4a-a164-eb76723893ac",
                "city": "Cashmere",
                "name": "Dog and Pony Brewing Company",
                "phone": "5092640800",
                "state": "Washington",
                "street": "5427 Binder Rd",
                "country": "United States",
                "website": "https://www.facebook.com/DogAndPonybrewing",
                "latitude": 47.508453646467,
                "longitude": -120.47773889783,
                "postal_code": "98815-9690",
                "brewery_type": "taproom"
            },
            {
                "id": "c27f55b4-f410-4389-ae35-a5a9bada3578",
                "city": "Bremerton",
                "name": "Dog Days Brewing",
                "phone": "3606279925",
                "state": "Washington",
     
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/brewery-api
OpenAPI spec: https://www.oanor.com/api/brewery-api/openapi.json