Find Nearby Places
GET {{baseUrl}}/v3/places/nearby?query=Chicken&ll=42.008576,-87.8772224&limit=14
Utilize Foursquare's Snap to Place technology to detect where your user's device is and what is around them. The endpoint is designed to provide POI tagging that supports a check-in use case. It will intentionally return lower quality results not found in Place Search. It is not intended to replace Place Search as the primary way to search for top, recommended POIs.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
query | string | A string to be matched against venue name for this place. | |
ll | string | The latitude/longitude around which to retrieve place information. This must be specified as latitude,longitude (e.g., ll=41.8781,-87.6298). If you do not specify ll, the server will attempt to retrieve the IP address from the request, and geolocate that IP address. | |
limit | number | The number of results to return, up to 50. Defaults to 10. | |
fields | null | Indicate which fields to return in the response, separated by commas. If no fields are specified, all <a href="https://docs.foursquare.com/reference/response-fields#core-data-fields" target="_blank">Core Fields</a> are returned by default. |
For a complete list of returnable fields, refer to the <a href="https://docs.foursquare.com/reference/response-fields" target="_blank">Response Fields</a> page. |
| hacc | null | | |
| altitude | string | | |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"results":[{"fsq_id":"12345abc8495fc2ca40f3dde","categories":[{"id":13068,"name":"American Restaurant","icon":{"id":"1234","created_at":"2022-04-23T18:25:43.511Z","prefix":"https://ss3.4sqi.net/img/categories_v2/food/hotdog_","suffix":".png","width":1500,"height":1500,"classifications":["food"],"tip":{"id":"123ABC","created_at":"2022-04-23T18:25:43.511Z","text":"A POI tip","url":"somelink.com","photo":"photolink.com","lang":"EN","agree_count":1000,"disagree_count":1000}}}],"chains":[{"id":"123ABC","name":"Chain Name"}],"date_closed":"2022-02-22","description":"a poi description","distance":5511,"email":"someone@site.com","fax":"123-456-7890","features":{"payment":{"credit_cards":{"accepts_credit_cards":{},"discover":{},"visa":{},"diners_club":{},"master_card":{}},"digital_wallet":{"accepts_nfc":{}}},"food_and_drink":{"alcohol":{"beer":{},"byo":{},"cocktails":{},"full_bar":{},"wine":{}},"meals":{"breakfast":{},"brunch":{},"lunch":{},"happy_hour":{},"dessert":{},"dinner":{}}},"services":{"delivery":{},"takeout":{},"drive_through":{},"dine_in":{"reservations":{},"online_reservations":{},"groups_only_reservations":{}}},"amenities":{"restroom":{},"smoking":{},"jukebox":{},"music":{},"live_music":{},"private_room":{},"outdoor_seating":{},"tvs":{},"atm":{},"coat_check":{},"wheelchair_accessible":{},"parking":{"parking":{},"street_parking":{},"valet_parking":{},"public_lot":{},"private_lot":{}}}},"geocodes":{"drop_off":{"latitude":42.054377,"longitude":-87.851752},"front_door":{"latitude":42.054377,"longitude":-87.851752},"main":{"latitude":42.054377,"longitude":-87.851752},"road":{"latitude":42.054377,"longitude":-87.851752},"roof":{"latitude":42.054377,"longitude":-87.851752}},"hours":{"display":"lorem","is_local_holiday":false,"open_now":true,"regular":[{"close":"10:00pm","day":"1","open":"6:00am"}],"seasonal":[{"closed":"true","end_date":"2023-01-15","hours":[{"close":"10:00pm","day":"1","open":"6:00am"}],"start_date":"2023-01-14"}]},"hours_popular":[{"close":"10:00pm","day":"1","open":"6:00am"}],"link":"/v3/places/12345abc8495fc2ca40f3dde","location":{"address":"1234 W Street Rd","address_extended":"Suite 25","admin_region":"lorem ipsom","census_block":"170318060012000","country":"US","cross_street":"Some St","dma":"City","formatted_address":"1234 W Street Rd, Niles, IL 12345","locality":"Niles","neighborhood":"Niles","po_box":"PO Box 123","postcode":"12345","region":"IL"},"menu":"lorem ipsum","name":"POI Name","photos":[{"id":"123455f5b863c0008b1edca","created_at":"2020-01-14T02:50:07.000Z","prefix":"https://fastly.4sqi.net/img/general/","suffix":"/12345438_8tJRLpG3PbPVN-Ekde66x8XN7IVVYP__YaS1KmLfntc.png","width":2000,"height":1500,"classifications":["food"],"tip":{"id":"ullamco qui dolore","created_at":"1963-08-21T13:57:06.927Z","text":"eiusmod","url":"eu commodo ut","photo":"lorem ipsom","lang":"nulla","agree_count":40683730,"disagree_count":65410876}}],"popularity":1234.12,"price":4,"rating":123.5,"related_places":{"parent":"lorem"},"social_media":{"facebook_id":"lorem","instagram":"ipsom","twitter":"plurubus"},"stats":{"total_photos":20,"total_ratings":50,"total_tips":25},"tastes":["lorem"],"tel":"123-456-7890","timezone":"America/Chicago","tips":[{"id":"ullamco qui dolore","created_at":"1963-08-21T13:57:06.927Z","text":"eiusmod","url":"eu commodo ut","photo":"lorem ipsom","lang":"nulla","agree_count":40683730,"disagree_count":-65410876}],"verified":true,"website":"www.site.com"}]}