ParkWhiz API: Search

Search for parking at a specific location and time.

Request

http://api.parkwhiz.com/search/ GET

Parameters

Field Type Desc
key string required ParkWhiz public API key
lat float required Latitude
lng float required Longitude
start integer Start time of the desired parking, expressed as a Unix Timestamp
end integer End time of the desired parking, expressed as a Unix Timestamp
monthly 1 or 0 Only return monthly parking listings.
sort string One of: rating, distance, price. Defaults to rating.
price float Only return locations with prices lower than the passed value
shuttle 1 or 0 Only return locations with shuttle service
eticket 1 or 0 Only return locations that accept Mobile Passes
perk 1 or 0 Only return locations that offer ParkWhiz Perks
valet 1 or 0 Only return locations that offer valet service
indoor 1 or 0 Only return indoor/covered locations
handicap 1 or 0 Only return handicap accessible locations
restroom 1 or 0 Only return locations that provide a restroom to customers
security 1 or 0 Only return locations with on-site security
tailgate 1 or 0 Only return locations that allow tailgating
rv 1 or 0 Only return locations that allow RV parking
unobstructed 1 or 0 Only return locations with unobstructed parking spots (vehicle won't be blocked in)
attended 1 or 0 Only return locations with an on-site parking attendant
reentry_allowed 1 or 0 Only return locations that allow reentry

Pricing information will only be returned if a start and end parameter is provided.

Example call

http://api.parkwhiz.com/search/?lat=41.8857256&lng=-87.6369590&start=1500997053&end=1501007853&key=62d882d8cfe5680004fa849286b6ce20

Returns

Field Type Desc
parkwhiz_url string URL of this query in human-readable format on ParkWhiz.com
lat float Latitude of the search location
lng float Longitude of the search location
min_price float Minimum price of the returned search results. This field is null if there are no search results.
max_price float Maximum price of the returned search results. This field is null if there are no search results.
min_distance integer Minimum distance in feet of the returned search results. This field is null if there are no search results.
max_distance integer Maximum distance in feet of the returned search results. This field is null if there are no search results.
amenities object A hash of how many of the returned locations offer certain amenities
parking_listings array A list of parking listings that matched the search parameters. The default sorting orders the results in ascending order by distance. Each entry has the following format:

parking_listings Object Parameters

Field Type Desc
location_name string The display name of the parking location
location_id integer ID number of the parking location
listing_id integer ID number of the parking listing
parkwhiz_url string URL of this location on ParkWhiz.com
api_url string URL to retrieve more info about this location via the JSON API
address string Street address of the parking location
city string City of the parking location
state string US State or Canadian province of the parking location
zip integer Zip code of the parking location
lat float Latitude of the parking location
lng float Longitude of the parking location
eticket integer Boolean (1 or 0) whether the location accepts mobile parking passes
distance integer Distance in feet from the search query destination
recommendations integer Number of ParkWhiz customers who gave this location positive feedback
available_spots integer Number of parking spaces available
price float Price to book a parking space for this location and time

Example response

{
	"parkwhiz_url": "http:\/\/api.parkwhiz.com\/search\/?lat=41.8857256&lng=-87.6369590&start=1289840400&end=1289853000",
	"lat": 41.8857256,
	"lng": -87.6369590,
	"min_price": 27.50,
	"min_distance": 111,
	"parking_listings": [
		{
			"location_name": "Central Parking",
			"listing_id": 3609,
			"parkwhiz_url": "http:\/\/www.parkwhiz.com\/p\/chicago-parking\/191-n-wacker-dr\/?start=1289840400&end=1289853000",
			"api_url": "http:\/\/api.parkwhiz.com\/p\/chicago-parking\/191-n-wacker-dr\/?start=1289840400&end=1289853000",
			"address": "191 N Wacker Dr",
			"city": "Chicago",
			"state": "IL",
			"zip": "60606",
			"lat": 41.885507,
			"lng": -87.636674,
			"eticket": 1,
			"distance": 111,
			"reservation": 0,
			"recommendations": 0,
			"available_spots": 0,
			"price": 27.50
		},
		{
			"location_name": "Franklin Self Park Garage",
			"listing_id": 6046,
			"parkwhiz_url": "http:\/\/www.parkwhiz.com\/p\/chicago-parking\/180-n-franklin-st\/?start=1289840400&end=1289853000",
			"api_url": "http:\/\/api.parkwhiz.com\/p\/chicago-parking\/180-n-franklin-st\/?start=1289840400&end=1289853000",
			"address": "180 N Franklin St",
			"city": "Chicago",
			"state": "IL",
			"zip": "60606",
			"lat": 41.885305,
			"lng": -87.635583,
			"eticket": 0
			"distance": 0,
			"reservation": 1,
			"recommendations": 0,
			"available_spots": 10,
			"price": 28.60
		},
		...
	]
}