Places API

Number of APIs: 9

Foursquare Places APIs

Our Places API Qodex collection allows developers to test our Places endpoints with different inputs to review how the API will respond.

Usage

All API call to Foursquare's endpoints require an API Key. If you dont have an API key already generate one in out Developer Console.

Set your API key as the value for a global variable named **'fsqapiKey'.**_ All request will read that global var to execute.

Autocomplete sessions can use a session token to reduce cost between calls (usually every keystroke). Create 2 global variables named **'sessiontoken' and 'expiresession**' to allow the pre-request script to manage this for you.

Most endpoints come with pre-filled data that will return a reponse. Play around with inputs to get an understanding for how the API will respond. Our responses are typically very concise and infrom the user of what issue occurred.

Use our Developer Docs for more in depth API documentation.

Join our Discord Developer Comminity for help from other engineers or to provide feedback on API usage.

*Note: Successful response schemas include all possible fields but may not be typical of a standard response for that endpoint.

  1. Place Search GET {{baseUrl}}/v3/places/search?query=Burgers&ll=41.8781,-87.6298&radius=36105&categories=13000&exclude_all_chains=true&fields=fsq_id,name,location&min_price=3&max_price=3&open_at=&open_now=true&near=&sort=DISTANCE&limit=20&session_token={{session_token}}

  2. Get Autocomplete Results GET {{baseUrl}}/v3/autocomplete?ll=41.8861786,-87.6332421&limit=14&types=place&session_token={{session_token}}&query=Als&radius=3000

  3. Get Place Details GET {{baseUrl}}/v3/places/:fsq_id?fields=&session_token={{session_token}}

  4. Find Nearby Places GET {{baseUrl}}/v3/places/nearby?query=Chicken&ll=42.008576,-87.8772224&limit=14

  5. Report Nearby Place Selection POST {{baseUrl}}/v3/place/select?request_id=63f78c917213564bc075a8e9&fsq_id=4e507dc81495fc2ca40f3dde&select_context=nearby

  6. Get Place Photos GET {{baseUrl}}/v3/places/:fsq_id/photos?limit=25&sort=NEWEST

  7. Get Place Tips GET {{baseUrl}}/v3/places/:fsq_id/tips?limit=14&sort=NEWEST

  8. Get Address Details GET {{baseUrl}}/v3/address/:fsq_addr_id?session_token={{session_token}}

  9. Place Match GET {{baseUrl}}/v3/places/match?name=Als Beef&address=548 N Wells St&city=Chicago&state=IL&cc=US&ll=41.8942505,-87.6380201