ParkWhiz API: Venue

Venue and event information. The JSON API uses a URL structure similar to the main ParkWhiz website. For example, the URL to return JSON data for Fenway Park would be http://api.parkwhiz.com/fenway-park-parking/

Request

http://api.parkwhiz.com/[venue_url]/ GET

Parameters

Field	Type	Description
key	string	ParkWhiz public API key
start	integer	Optional event start time, expressed as a Unix timestamp. If there is an event at the venue within 12 hours of the provided start time, a 301 redirect to the event URL will be issued, returning detailed parking information about the event.
page	integer	Only 20 events are returned per API call. Use the page parameter to see more results.

Example Call

http://api.parkwhiz.com/fenway-park-parking/?page=2&key=62d882d8cfe5680004fa849286b6ce20

Returns

Field	Type	Description
venue_name	string	The name of the venue
parkwhiz_url	string	URL of the human-readable page for this venue on ParkWhiz.com
address	string	Street address of the venue
city	string	City of the venue
state	string	US state or Canadian province of the venue
zip	string	Postal code of the venue
type	string	The type of venue. One of: airport, sports, theater, park
lat	float	Latitude of the venue
lng	float	Longitude of the venue
num_events	integer	Total number of events at this venue. Only 20 events are returned at one time. Use the page parameter to browse events.
page	integer	The currently returned page
events	array	A list of upcoming events at the venue, in chronological order

events Object Parameters

Field	Type	Description
event_name	string	The name of the event
parkwhiz_url	string	URL of the event in human-readable form on ParkWhiz.com
api_url	string	URL to retreive more info about this event via the JSON API
start	integer	The start time of the event, expressed as a Unix timestamp in the local timezone
end	integer	The end time of the event, expressed as a Unix timestamp in the local timezone
parking_locations	integer	The number of available parking locations for this event
min_price	float	The price of the least expensive parking for this event
min_distance	integer	The distance from the event of the closest available parking, expressed in feet

Example Response

{
	"venue_name": "Fenway Park",
	"parkwhiz_url": "http:\/\/www.parkwhiz.com\/fenway-park-parking\/",
	"address": "4 Yawkey Way",
	"city": "Boston",
	"state": "MA",
	"zip": "02215",
	"type": "sports",
	"timezone": "America\/New_York",
	"lat": 42.3467459481307,
	"lng": -71.0974216461182,
	"num_events": 57,
	"page": 1,
	"events": [
		{
			"event_name": "Boston Red Sox vs Kansas City Royals",
			"parkwhiz_url": "http:\/\/www.parkwhiz.com\/fenway-park-parking\/2010-5-27-7pm-boston-red-sox-vs-kansas-city-royals\/",
			"api_url": "http:\/\/api.parkwhiz.com\/fenway-park-parking\/2010-5-27-7pm-boston-red-sox-vs-kansas-city-royals\/",
			"start": 1275001200,
			"end": 1275012000,
			"parking_locations": 4,
			"min_price": 27.50,
			"min_distance": 888
		},
		{
			"event_name": "Boston Red Sox vs Kansas City Royals",
			"parkwhiz_url": "http:\/\/www.parkwhiz.com\/fenway-park-parking\/2010-5-28-7pm-boston-red-sox-vs-kansas-city-royals\/",
			"api_url": "http:\/\/api.parkwhiz.com\/fenway-park-parking\/2010-5-28-7pm-boston-red-sox-vs-kansas-city-royals\/",
			"start": 1275087600,
			"end": 1275098400,
			"parking_locations": 4,
			"min_price": 27.50,
			"min_distance": 888
		},
		...
	]
}