# Search

## Searches for and returns breweries that match the search term.

<mark style="color:blue;">`GET`</mark> `https://api.openbrewerydb.org/breweries/search?query={search}`

#### Path Parameters

| Name                                    | Type    | Description                                                                             |
| --------------------------------------- | ------- | --------------------------------------------------------------------------------------- |
| query<mark style="color:red;">\*</mark> | String  | The search term to return breweries.You can use underscores or URL encoding for spaces. |
| per\_page                               | Integer | Number of breweries to return each call.                                                |

{% tabs %}
{% tab title="200: OK " %}

```json
[
    {
        "id": "barrel-dog-brewing-evergreen",
        "name": "Barrel Dog Brewing",
        "brewery_type": "micro",
        "street": null,
        "address_2": null,
        "address_3": null,
        "city": "Evergreen",
        "state": "Colorado",
        "county_province": null,
        "postal_code": "80439",
        "country": "United States",
        "longitude": "-105.321458",
        "latitude": "39.6361637",
        "phone": "5599176846",
        "website_url": null,
        "updated_at": "2022-08-20T02:56:08.975Z",
        "created_at": "2022-08-20T02:56:08.975Z"
    },
    {
        "id": "boss-dog-brewing-cleveland",
        "name": "Boss Dog Brewing",
        "brewery_type": "brewpub",
        "street": "2179 Lee Rd",
        "address_2": null,
        "address_3": null,
        "city": "Cleveland",
        "state": "Ohio",
        "county_province": null,
        "postal_code": "44118-2907",
        "country": "United States",
        "longitude": "-81.56529555",
        "latitude": "41.50030645",
        "phone": "2163212337",
        "website_url": "http://www.bossdogbrewing.com",
        "updated_at": "2022-08-20T02:56:08.975Z",
        "created_at": "2022-08-20T02:56:08.975Z"
    },
    {
        "id": "diving-dog-brewhouse-oakland",
        "name": "Diving Dog Brewhouse",
        "brewery_type": "micro",
        "street": "1802 Telegraph Ave",
        "address_2": null,
        "address_3": null,
        "city": "Oakland",
        "state": "California",
        "county_province": null,
        "postal_code": "94612-2110",
        "country": "United States",
        "longitude": "-122.2698881",
        "latitude": "37.807739",
        "phone": "5103061914",
        "website_url": "http://www.divingdogbrew.com",
        "updated_at": "2022-08-20T02:56:08.975Z",
        "created_at": "2022-08-20T02:56:08.975Z"
    }
]
```

{% endtab %}
{% endtabs %}

<details>

<summary>Sample Request &#x26; Response</summary>

`GET https://api.openbrewerydb.org/breweries/search?query=dog&per_page=3`

```json
[
    {
        "id": "barrel-dog-brewing-evergreen",
        "name": "Barrel Dog Brewing",
        "brewery_type": "micro",
        "street": null,
        "address_2": null,
        "address_3": null,
        "city": "Evergreen",
        "state": "Colorado",
        "county_province": null,
        "postal_code": "80439",
        "country": "United States",
        "longitude": "-105.321458",
        "latitude": "39.6361637",
        "phone": "5599176846",
        "website_url": null,
        "updated_at": "2022-08-20T02:56:08.975Z",
        "created_at": "2022-08-20T02:56:08.975Z"
    },
    {
        "id": "boss-dog-brewing-cleveland",
        "name": "Boss Dog Brewing",
        "brewery_type": "brewpub",
        "street": "2179 Lee Rd",
        "address_2": null,
        "address_3": null,
        "city": "Cleveland",
        "state": "Ohio",
        "county_province": null,
        "postal_code": "44118-2907",
        "country": "United States",
        "longitude": "-81.56529555",
        "latitude": "41.50030645",
        "phone": "2163212337",
        "website_url": "http://www.bossdogbrewing.com",
        "updated_at": "2022-08-20T02:56:08.975Z",
        "created_at": "2022-08-20T02:56:08.975Z"
    },
    {
        "id": "diving-dog-brewhouse-oakland",
        "name": "Diving Dog Brewhouse",
        "brewery_type": "micro",
        "street": "1802 Telegraph Ave",
        "address_2": null,
        "address_3": null,
        "city": "Oakland",
        "state": "California",
        "county_province": null,
        "postal_code": "94612-2110",
        "country": "United States",
        "longitude": "-122.2698881",
        "latitude": "37.807739",
        "phone": "5103061914",
        "website_url": "http://www.divingdogbrew.com",
        "updated_at": "2022-08-20T02:56:08.975Z",
        "created_at": "2022-08-20T02:56:08.975Z"
    }
]
```

</details>
