Ask

get

https://places-api.foursquare.com/places/ask

Ask is a natural language place search that returns a list of places matching a natural-language question. Provide query with what the user wants (e.g., "best cocktail lounge in Williamsburg"). Ask needs a search area from one of three places: a place mentioned in query, ll (lat,lng), or location (geocodable string). If the query does not contain a place, you should provide either ll or location. You may also pass context to describe preferences (e.g., "traveling with kids, need outdoor seating").

Note: The Ask Endpoint has different Pay as You Go pricing and rate limits than the rest of the Places API.

Query Params

query

string

required

A natural language search query. Ask needs a search area from one of: a place mentioned in query, ll, or location. If the query does not mention a place, provide either ll or location. (e.g. "show me all cheap cafes in Williamsburg")

string

The latitude/longitude around which to retrieve place information. Use this when the query does not already contain a place and no location is provided. This must be specified as latitude,longitude (e.g., ll=41.8781,-87.6298).

context

string

Context for the query. (e.g. "Traveling with kids, stroller friendly, need outdoor seating.")

location

string

A string naming a locality in the world (e.g., "Chicago, IL"). Use this when the query does not already contain a place and no ll is provided. If the value is not geocodable, returns an error. Global search results will be omitted.

fields

string

Indicate which fields to return in the response, separated by commas. If no fields are specified, all Pro Fields are returned by default.

For a complete list of returnable fields, refer to the Places Response Fields page.

Headers

X-Places-Api-Version

string

enum

required

Defaults to 2025-06-17

The version of the API to use.

Allowed:

Responses

400

bad request

401

unauthorized

200success