Venue Search

Search the database for a list of venues that match a specific query string.

Endpoint

https://www.pollstar.com/api/v2/venues/search/{venueName}

Parameters

venueName
The name of the venue to find.
page
[optional] The zero-based index of the page number to select. Selecting a page number that is higher than the number of available pages will succeed with an empty response.
pageSize
[optional] The size of each page. Using a combination of the page and pageSize parameters, you can create a custom paging solution. The default pageSize is 20.

Remarks

This endpoint will return a list of matching venues based on the venueName parameter. It does not guarantee that a unique venue will be returned – it will return all venues that match some part of the search string, ranked by most likely match first. The higher the value of the rank element in the result set, then the higher the probability of an exact match to the query string.

The returned venueId value can be used as a parameter for the Get Venue Routebook endpoint.

Example

To find the first page of venues that match the query string “strummers”:

https://www.pollstar.com/api/v2/venues/search/strummers?page=0

Response

{
    "page": 0,
    "pageSize": 5,
    "totalVenues": 3,
    "venues": [
        {
            "id": 276581,
            "name": "Strummer's",
            "url": "https://www.pollstar.com/venue/strummer39s-276581",
            "latitude": 36.758982854229721,
            "longitude": -119.80032807128825,
            "location": "Fresno, CA",
            "cityId": 23546,
            "rb": 17,
            "th": 643,
            "bo": 11,
            "rank": 781.1891
        },
        {
            "id": 392463,
            "name": "Strummers",
            "url": "https://www.pollstar.com/venue/strummers-392463",
            "latitude": null,
            "longitude": null,
            "location": "Pittsburgh, PA",
            "cityId": 45168,
            "rb": 0,
            "th": 1,
            "bo": 0,
            "rank": 711.2125
        },
        {
            "id": 433963,
            "name": "Strummer's Village Tavern",
            "url": "https://www.pollstar.com/venue/strummer39s-village-tavern-433963",
            "latitude": 32.65895568499861,
            "longitude": -114.6255290478927,
            "location": "Yuma, AZ",
            "cityId": 473,
            "rb": 0,
            "th": 11,
            "bo": 0,
            "rank": 196.52716
        }
    ]
}
<root>
    <page>0</page>
    <pageSize>5</pageSize>
    <totalVenues>3</totalVenues>
    <venues>
        <venue>
            <id>276581</id>
            <name>Strummer&amp;#39;s</name>
            <url>https://www.pollstar.com/venue/strummer39s-276581</url>
            <location>Fresno, CA</location>
            <cityId>23546</cityId>
            <rb>17</rb>
            <th>643</th>
            <bo>11</bo>
            <rank>746.2765</rank>
        </venue>
        <venue>
            <id>392463</id>
            <name>Strummers</name>
            <url>https://www.pollstar.com/venue/strummers-392463</url>
            <location>Pittsburgh, PA</location>
            <cityId>45168</cityId>
            <rb>0</rb>
            <th>1</th>
            <bo>0</bo>
            <rank>668.86285</rank>
        </venue>
        <venue>
            <id>433963</id>
            <name>Strummer&amp;#39;s Village Tavern</name>
            <url>https://www.pollstar.com/venue/strummer39s-village-tavern-433963</url>
            <location>Yuma, AZ</location>
            <cityId>473</cityId>
            <rb>0</rb>
            <th>11</th>
            <bo>0</bo>
            <rank>189.46213</rank>
        </venue>
    </venues>
</root>

 

%d bloggers like this: