Response fields define the returnable metadata of the FSQ Places API. This data will be returned when requesting a Places Search, Place Details, or Geotagging Candidates call. This page lists all place data fields and their groupings.

Types of Returnable :

Places Pro
Places Premium

Places Pro

Includes all fields available via our Places Open Source data and extra fields about chain membership and location. If no explicit fields are provided in an API request, all Pro fields will be returned by default.

Field	Description
`fsq_place_id`	A unique identifier for a FSQ Place (formerly known as Venue ID).
`name`	The best known name for the FSQ Place.
`categories`	An array, possibly empty, of categories that describe the FSQ Place. Included subfields: `id` (Category ID), `name` (Category Label), and `icon` (Category's Icon). View the list of FSQ Categories → Places Photos Guide
`location`	An object containing the following fields, if available: - `address` - `locality` - `region` - `postcode` - `country` - `admin_region` - `post_town` - `po_box`
`latitude`	The latitude of the location's main entrance.
`longitude`	The longitude of the location's main entrance.
`distance`	The calculated distance (in meters) from the provided location (i.e. ll + radius OR near OR ne + sw) in the API call. This field will only be returned by the Place Search endpoint.
`tel`	The best known telephone number, with local formatting.
`email`	The primary contact email address for the FSQ Place.
`website`	The official website for the FSQ Place.
`social_media`	An object containing a FSQ Place's social media identifiers. Included subfields: `facebook_id`, `instagram`, and `twitter`. Not all FSQ Places will have all subfields.
`link`	The URL associated with the FSQ Place Detail API call.
`date_closed`	The recorded date when the FSQ Place was marked as permanently closed in Foursquare's databases. This does not necessarily indicate the Place was actually closed on this date.
`placemaker_url`	The Foursquare Placemaker URL associated with the FSQ Place
`chains`	An array, possibly empty, of chains that the FSQ Place belongs to. Included subfields: `id` (Chain ID) and `name` (Chain Name). View the list of FSQ Chains →
`store_id`	A unique ID assigned to a venue to differentiate it from other stores in the same chain.
`related_places`	An object containing the information for Places related to the FSQ Place. Included subfields: `parent` and `children`. Not all FSQ Places will have parent or children relationships. Some Children Place responses may not show a `fsq_id`. This indicates that Foursquare does not have enough data inputs to mark the Child Place as an official Place. Example: `parent` = Los Angeles International Airport `children` = Terminal 1, Terminal 2, Terminal 3...
`extended_location`	An object containing additional location metadata, including `census_block` and `dma`.
`unresolved_flags`	An array containing a set of quality issue flags reported by Placemakers, human or agent, that require further corroboration. Each flag marks a suspected problem that has not yet been resolved. The values can be one or more of the following: - `closed` – the place is believed to be permanently closed - `duplicate` – the place is a duplicate of another record - `delete` – the place should be removed entirely - `privatevenue` – the place is private and should not be publicly listed - `inappropriate` – the content violates policy or is otherwise unsuitable - `doesnt_exist` – the place is thought not to exist at the specified location

Places Premium

Includes all data from Places Pro and additional fields:

Field	Description
`attributes`	A list of boolean tags that help to describe services and additional metadata offered by the Place (e.g. takes_reservations: true) For a full list of tags, see Places Tags.
`description`	A general description of the FSQ Place. Typically provided by the owner/claimant of the FSQ Place and/or updated by City Guide Superusers.
`hours`	An array containing the `regular` hours of operation, `is_local_holiday`, `open_now`, and a formatted `display` string. `regular` hours contain subfields: `day` (`1` = Monday, `2` = Tuesday, `7` = Sunday) and `open`/`close` (24-hour time).
`hours_popular`	An array containing the hours during the week when a FSQ Place is most often visited. This place must have a minimum number of check-ins to be considered for the calculation. Similar to `hours`, this field contains subfields: `day` (`1` = Monday, `2` = Tuesday, `7` = Sunday) and `open`/`close` (24-hour time).
`menu`	A menu URL for the FSQ Place.
`photos`	An array of objects containing the following subfields: - `id` - `created_at` - `classifications` - `prefix` - `suffix` - `width` - `height`.For more information, see our Places Photos Guide →
`place_actions`	A list of actionable links associated with the place, such as reservations or delivery ordering. Each action includes the action type, a URL for completing the action, and the provider source ID.
`popularity`	A measure of the FSQ Place's popularity, by foot traffic. This score is on a 0 to 1 scale and uses a 6-month span of Place visits for a given geographic area.
`price`	A numerical value (from 1 to 4) that best describes the pricing tier of the FSQ Place, based on known prices for menu items and other offerings. Values include: - `1` = Cheap - `2` = Moderate - `3` = Expensive - `4` = Very Expensive.
`rating`	A numerical rating (from 0.0 to 10.0) of the FSQ Place, based on user votes, likes/dislikes, tips sentiment, and visit data. Not all FSQ Places will have a rating.
`stats`	An object containing counts of photos, ratings, and tips. Included subfields: `total_photos`, `total_ratings`, and `total_tips`.
`tastes`	An array of up to 25 tastes describing the FSQ Place.
`tips`	An array containing the following subfields: `created_at` and `text`.
`veracity_rating`	A 1 to 5 star quality rating indicating how complete, current, and reliable the location's information is, helping you understand how strong our data signals are for this place. `5` = Highly reliable and complete information, regularly updated from trusted sources and real user activity.  `4` = Very good information verified from reliable sources with some user engagement.  `3` = Good essential information from multiple sources that's generally current but less frequently updated.  `2` = Basic information available but some details may be missing or outdated.  `1` = Limited information from few sources that may not have been updated recently.

For assistance and related questions, reach out to our team for support.