Foursquare · Schema
PlaceMatchResponse
PlaceMatchResponse schema from Foursquare Places API
RestaurantLocationsPlacesGeocodingRecommendationsReviewsMovement
Properties
| Name | Type | Description |
|---|---|---|
| place | object |
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-match-response-schema.json",
"title": "PlaceMatchResponse",
"description": "PlaceMatchResponse schema from Foursquare Places API",
"type": "object",
"properties": {
"place": {
"allOf": [
{
"type": "object",
"properties": {
"fsq_place_id": {
"type": "string"
},
"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"
},
"icon": {
"type": "object",
"properties": {
"prefix": {
"type": "string"
},
"suffix": {
"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"
},
"date_closed": {
"type": "string"
},
"tel": {
"type": "string"
},
"email": {
"type": "string"
},
"website": {
"type": "string"
},
"social_media": {
"type": "object",
"properties": {
"facebook_id": {
"type": "string"
},
"instagram": {
"type": "string"
},
"twitter": {
"type": "string"
}
}
},
"hours": {
"type": "object",
"properties": {
"display": {
"type": "string"
},
"is_local_holiday": {
"type": "boolean"
},
"open_now": {
"type": "boolean"
}
}
},
"attributes": {
"type": "object",
"properties": {
"restroom": {
"type": "string"
},
"outdoor_seating": {
"type": "string"
},
"atm": {
"type": "string"
},
"parking": {
"type": "object"
},
"wifi": {
"type": "string"
},
"delivery": {
"type": "string"
},
"reservations": {
"type": "string"
},
"credit_cards": {
"type": "object"
}
}
},
"tastes": {
"type": "array",
"items": {
"type": "string"
}
},
"stats": {
"type": "object",
"properties": {
"total_photos": {
"type": "integer"
},
"total_ratings": {
"type": "integer"
},
"total_tips": {
"type": "integer"
}
}
},
"photos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"created_at": {
"type": "string",
"format": "date-time"
},
"prefix": {
"type": "string"
},
"suffix": {
"type": "string"
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
}
}
}
},
"tips": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"created_at": {
"type": "string",
"format": "date-time"
},
"text": {
"type": "string"
}
}
}
}
}
},
{
"type": "object",
"properties": {
"match_score": {
"type": "number",
"minimum": 0,
"maximum": 1,
"description": "Confidence of the match (0-1; higher is stronger)."
}
}
}
]
}
}
}