Get City RouteBook

Fetch a list of upcoming events (the routebook) for a city and, optionally, nearby cities as well.

Endpoint

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

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.
fromDate
[optional] The starting date for the range of events to select. If this parameter is omitted, the selected event range will start from the current date. If the supplied fromDate is earlier than the current date, it will be ignored and events will be selected using the current date as the starting point. The date format should be in US format, MM/DD/YYYY.
toDate
[optional] The end date for the range of events to select. If this parameter is omitted, the selected event range will have no effective end date, and all future events will be selected with respect to the page and pageSize parameters. If the fromDate is later than toDate, the date range selection will always operate on the assumption that the earliest date is first start date and the later date is the end date.  The date format should be in US format, MM/DD/YYYY.
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 upcoming events within a 5 mile radius of Salida, California:

https://www.pollstar.com/api/v2/cities/49808/routebook/?radius=5

Response

{
    "page": 0,
    "pageSize": 100,
    "totalPages": 1,
    "totalEvents": 3,
    "fromDate": null,
    "toDate": null,
    "events": [
        {
            "EventId": 7389279,
            "EventName": "Justin Moore",
            "EventUrl": "https://localhost:2431/event/justin-moore-7389279",
            "VenueId": 109130546,
            "VenueName": "Westside Pavilion At Black Oak Casino",
            "VenueUrl": "https://localhost:2431/venue/westside-pavilion-at-black-oak-casino-109130546",
            "CityId": 49808,
            "CityName": "Salida",
            "CityUrl": "https://localhost:2431/city/salida-49808",
            "State": "CA",
            "Country": "United States",
            "Region": "Salida, CA",
            "HasEventTickets": false,
            "PlayDate": "5/25/2018",
            "HoursOld": 1007,
            "IsFestival": false,
            "Support": null
        },
        {
            "EventId": 7389230,
            "EventName": "Larry The Cable Guy",
            "EventUrl": "https://localhost:2431/event/larry-the-cable-guy-7389230",
            "VenueId": 109130546,
            "VenueName": "Westside Pavilion At Black Oak Casino",
            "VenueUrl": "https://localhost:2431/venue/westside-pavilion-at-black-oak-casino-109130546",
            "CityId": 49808,
            "CityName": "Salida",
            "CityUrl": "https://localhost:2431/city/salida-49808",
            "State": "CA",
            "Country": "United States",
            "Region": "Salida, CA",
            "HasEventTickets": false,
            "PlayDate": "6/15/2018",
            "HoursOld": 1007,
            "IsFestival": false,
            "Support": null
        },
        {
            "EventId": 7395098,
            "EventName": "Abbacadabra - The Ultimate Abba Trib.",
            "EventUrl": "https://localhost:2431/event/abbacadabra-the-ultimate-abba-trib-7395098",
            "VenueId": 467659,
            "VenueName": "Lucca Winery",
            "VenueUrl": "https://localhost:2431/venue/lucca-winery-467659",
            "CityId": 48057,
            "CityName": "Ripon",
            "CityUrl": "https://localhost:2431/city/ripon-48057",
            "State": "CA",
            "Country": "United States",
            "Region": "Ripon, CA",
            "HasEventTickets": false,
            "PlayDate": "8/4/2018",
            "HoursOld": 839,
            "IsFestival": false,
            "Support": null
        }
    ]
}
<root>
    <page>0</page>
    <pageSize>100</pageSize>
    <totalPages>1</totalPages>
    <totalEvents>3</totalEvents>
    <fromDate />
    <toDate />
    <events>
        <event>
            <EventId>7389279</EventId>
            <EventName>Justin Moore</EventName>
            <EventUrl>https://localhost:2431/event/justin-moore-7389279</EventUrl>
            <VenueId>109130546</VenueId>
            <VenueName>Westside Pavilion At Black Oak Casino</VenueName>
            <VenueUrl>https://localhost:2431/venue/westside-pavilion-at-black-oak-casino-109130546</VenueUrl>
            <CityId>49808</CityId>
            <CityName>Salida</CityName>
            <CityUrl>https://localhost:2431/city/salida-49808</CityUrl>
            <State>CA</State>
            <Country>United States</Country>
            <Region>Salida, CA</Region>
            <HasEventTickets>false</HasEventTickets>
            <PlayDate>5/25/2018</PlayDate>
            <HoursOld>1007</HoursOld>
            <IsFestival>false</IsFestival>
            <Support />
        </event>
        <event>
            <EventId>7389230</EventId>
            <EventName>Larry The Cable Guy</EventName>
            <EventUrl>https://localhost:2431/event/larry-the-cable-guy-7389230</EventUrl>
            <VenueId>109130546</VenueId>
            <VenueName>Westside Pavilion At Black Oak Casino</VenueName>
            <VenueUrl>https://localhost:2431/venue/westside-pavilion-at-black-oak-casino-109130546</VenueUrl>
            <CityId>49808</CityId>
            <CityName>Salida</CityName>
            <CityUrl>https://localhost:2431/city/salida-49808</CityUrl>
            <State>CA</State>
            <Country>United States</Country>
            <Region>Salida, CA</Region>
            <HasEventTickets>false</HasEventTickets>
            <PlayDate>6/15/2018</PlayDate>
            <HoursOld>1007</HoursOld>
            <IsFestival>false</IsFestival>
            <Support />
        </event>
        <event>
            <EventId>7395098</EventId>
            <EventName>Abbacadabra - The Ultimate Abba Trib.</EventName>
            <EventUrl>https://localhost:2431/event/abbacadabra-the-ultimate-abba-trib-7395098</EventUrl>
            <VenueId>467659</VenueId>
            <VenueName>Lucca Winery</VenueName>
            <VenueUrl>https://localhost:2431/venue/lucca-winery-467659</VenueUrl>
            <CityId>48057</CityId>
            <CityName>Ripon</CityName>
            <CityUrl>https://localhost:2431/city/ripon-48057</CityUrl>
            <State>CA</State>
            <Country>United States</Country>
            <Region>Ripon, CA</Region>
            <HasEventTickets>false</HasEventTickets>
            <PlayDate>8/4/2018</PlayDate>
            <HoursOld>839</HoursOld>
            <IsFestival>false</IsFestival>
            <Support />
        </event>
    </events>
</root>

 

%d bloggers like this: