Get Local Venues

Fetch a list of venues within a city and, optionally, nearby cities as well.

Endpoint

https://www.pollstar.com/api/v2/cities/{cityId}/venues/

Parameters

cityId
The id of the city.
radius
[optional] The distance around the city specified by cityId to search for additional events. Omitting this parameter will have the same effect as passing a zero radius – it will only fetch events that occur in that specific city. The maximum radius (in miles) that can be specified is 50.
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.

Remarks

It is also possible to implement a paging system based on the fromDate and toDate parameters, instead of using page and pageSize by requesting data in date range blocks (by month or year for example).

Example

To fetch all venues in the town of Salida, California:

https://lwww.pollstar.com/api/v2/cities/49808/venues/?radius=0

Response

{
    "page": 0,
    "pageSize": 20,
    "totalPages": 0,
    "totalEvents": 0,
    "radius": 1,
    "venues": [
        {
            "VenueId": 109130546,
            "VenueName": "Westside Pavilion At Black Oak Casino",
            "VenueURL": "https://www.pollstar.com/venue/westside-pavilion-at-black-oak-casino-109130546",
            "CityId": 49808,
            "CityName": "Salida",
            "CityURL": "https://www.pollstar.com/city/salida-49808",
            "State": "CA",
            "CountryId": 105,
            "CountryName": "United States",
            "Location": "Salida, CA",
            "VenueTypes": [
                "Amphitheatre"
            ],
            "Capacity": 6000,
            "RB": true,
            "BO": false,
            "TH": false
        }
    ]
}
<root>
    <page>0</page>
    <pageSize>20</pageSize>
    <totalPages>0</totalPages>
    <totalEvents>0</totalEvents>
    <radius>1</radius>
    <venues>
        <venue>
            <VenueId>109130546</VenueId>
            <VenueName>Westside Pavilion At Black Oak Casino</VenueName>
            <VenueURL>https://www.pollstar.com/venue/westside-pavilion-at-black-oak-casino-109130546</VenueURL>
            <CityId>49808</CityId>
            <CityName>Salida</CityName>
            <CityURL>https://www.pollstar.com/city/salida-49808</CityURL>
            <State>CA</State>
            <CountryId>105</CountryId>
            <CountryName>United States</CountryName>
            <Location>Salida, CA</Location>
            <Capacity>6000</Capacity>
            <RB>true</RB>
            <BO>false</BO>
            <TH>false</TH>
        </venue>
    </venues>
</root>

 

%d bloggers like this: