Foursquare · Schema

FoursquarePlace

A point of interest returned by the Foursquare Places API.

RestaurantLocationsPlacesGeocodingRecommendationsReviewsMovement

Properties

Name	Type	Description
fsq_place_id	string	Stable Foursquare place identifier.
name	string
latitude	number
longitude	number
location	object
categories	array
chains	array
distance	integer
rating	number
price	integer
popularity	number
verified	boolean
tel	string
email	string
website	string
tastes	array
stats	object

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/foursquare/refs/heads/main/json-schema/foursquare-place.json",
  "title": "FoursquarePlace",
  "description": "A point of interest returned by the Foursquare Places API.",
  "type": "object",
  "required": ["fsq_place_id", "name"],
  "properties": {
    "fsq_place_id": { "type": "string", "description": "Stable Foursquare place identifier." },
    "name": { "type": "string" },
    "latitude": { "type": "number" },
    "longitude": { "type": "number" },
    "location": {
      "type": "object",
      "properties": {
        "address": { "type": "string" },
        "locality": { "type": "string" },
        "region": { "type": "string" },
        "postcode": { "type": "string" },
        "admin_region": { "type": "string" },
        "post_town": { "type": "string" },
        "po_box": { "type": "string" },
        "country": { "type": "string" },
        "formatted_address": { "type": "string" }
      }
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "fsq_category_id": { "type": "string" },
          "name": { "type": "string" },
          "short_name": { "type": "string" },
          "plural_name": { "type": "string" }
        }
      }
    },
    "chains": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "fsq_chain_id": { "type": "string" },
          "name": { "type": "string" }
        }
      }
    },
    "distance": { "type": "integer" },
    "rating": { "type": "number" },
    "price": { "type": "integer", "minimum": 1, "maximum": 4 },
    "popularity": { "type": "number" },
    "verified": { "type": "boolean" },
    "tel": { "type": "string" },
    "email": { "type": "string" },
    "website": { "type": "string" },
    "tastes": { "type": "array", "items": { "type": "string" } },
    "stats": {
      "type": "object",
      "properties": {
        "total_photos": { "type": "integer" },
        "total_ratings": { "type": "integer" },
        "total_tips": { "type": "integer" }
      }
    }
  }
}