{"swagger":"2.0","info":{"title":"foursquare","description":"Foursquare API","contact":{"name":"Natalia","email":"nbartol@gilt.com"},"version":"0.0.1-dev"},"host":"api.foursquare.com","basePath":"/v2","schemes":["https"],"consumes":["application/json"],"produces":["application/json"],"paths":{"/venues/explore":{"get":{"description":"Fetches venues nearby for a given query","parameters":[{"name":"client_id","in":"query","required":true,"type":"string"},{"name":"client_secret","in":"query","required":true,"type":"string"},{"name":"v","in":"query","description":"Version parameter","required":true,"type":"string"},{"name":"near","in":"query","description":"Search near this location","required":true,"type":"string"},{"name":"query","in":"query","description":"What to search for","required":true,"type":"string"}],"responses":{"200":{"description":"List of venues","schema":{"$ref":"#/definitions/venue_explore_response_wrapper"}}}}},"/venues/{venue_id}":{"get":{"description":"Venue details","parameters":[{"name":"venue_id","in":"path","required":true,"type":"string"},{"name":"client_id","in":"query","required":true,"type":"string"},{"name":"client_secret","in":"query","required":true,"type":"string"},{"name":"v","in":"query","description":"Version parameter","required":true,"type":"string"}],"responses":{"200":{"description":"Venue detials","schema":{"$ref":"#/definitions/venue_details_response_wrapper"}}}}}},"definitions":{"photo":{"type":"object","description":"Photo of venues","title":"photo","required":["prefix","suffix","width","height"],"properties":{"prefix":{"example":"https://irs2.4sqi.net/img/general/","type":"string"},"suffix":{"example":"/5293444_GBJkT8dTt_lCCu2qbwK5vm6uX64LWoDUzvMh6tG3kxY","type":"string"},"width":{"example":"640","type":"integer","format":"int32"},"height":{"example":"640","type":"integer","format":"int32"}}},"venue":{"type":"object","description":"Venue","title":"venue","required":["name","id"],"properties":{"name":{"description":"Name","example":"The Beerhouse","type":"string"},"id":{"description":"Id","example":"51b2504c498e537d84ee84c3","type":"string"},"bestPhoto":{"$ref":"#/definitions/photo"}}},"venue_details_response":{"type":"object","description":"Venue details response","title":"venue_details_response","required":["venue"],"properties":{"venue":{"$ref":"#/definitions/venue"}}},"venue_details_response_wrapper":{"type":"object","description":"Venue details response wrapper","title":"venue_details_response_wrapper","required":["response"],"properties":{"response":{"$ref":"#/definitions/venue_details_response"}}},"venue_explore_response":{"type":"object","description":"Explore venue response","title":"venue_explore_response","required":["groups"],"properties":{"groups":{"type":"array","items":{"$ref":"#/definitions/venue_group"}}}},"venue_explore_response_wrapper":{"type":"object","description":"Explore venue response wrapper","title":"venue_explore_response_wrapper","required":["response"],"properties":{"response":{"$ref":"#/definitions/venue_explore_response"}}},"venue_group":{"type":"object","description":"Venue group","title":"venue_group","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/definitions/venue_item"}}}},"venue_item":{"type":"object","description":"Venue item","title":"venue_item","required":["venue"],"properties":{"venue":{"$ref":"#/definitions/venue"}}}}}