Developers > Venue

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:

Required parameters are bold.

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:

venue_name

Name of the venue

venue_id

ID of the venue

parkwhiz_url

URL of this query in human-readable format on ParkWhiz.com

address

Street address of the venue

city

City of the venue

state

US state or Canadian province of the venue

zip

Zip code of the parking venue

type

The type of venue. One of: airport, sports, theater

lat

Latitude of the venue

lng

Longitude of the venue

description

Description of the venue, if any

num_events

Total number of events at this venue. Only 20 events are returned at one time. Use the page parameter to browse events.

page

The currently returned page

events

The upcoming events occurring at the venue, in chronological order

event_name: The name of the event; if a sporting event, the teams playing
event_id: The ID of the event
parkwhiz_url: URL of this event on ParkWhiz.com
api_url: URL to retreive more info about this event via the JSON API
start: The start time of the event, expressed as a Unix timestamp
end: The end time of the event, expressed as a Unix timestamp
parking_locations: The number of parking locations offering reserved parking
min_price: The cheapest parking available for this event
min_distance: The closest parking available for this event

Example response:

{
"venue_name":"Fenway Park",
"venue_id":"99",
"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",
"description":"Home of the Boston Red Sox.",
"num_events":57,
"page":1,
"events":[
		{
			"event_name":"Boston Red Sox vs Kansas City Royals",
			"event_id":"14694",
			"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",
			"event_id":"14695",
			"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"
		},
		...
	]
}

Developers Home