Places & Venues API
The Places API allows developers to query verified merchant listings, cultural institutions, parks, and venues within specific districts or regions.
Endpoints
| Method | Path | Description |
|---|---|---|
GET | /v0.3/places/ | List places filtered by district boundary, categories, or vibes. |
GET | /v0.3/places/{id}/ | Retrieve full place details by UUID. |
GET | /v0.3/search/places/ | Fast Elasticsearch endpoint for keyword and geo-distance queries. |
1. List Places (/v0.3/places/)
Returns a paginated list of places wrapped in a GeoJSON FeatureCollection.
Request
GET https://api.vibemap.com/v0.3/places/?boundary=clermont&page_size=20 HTTP/1.1
Host: api.vibemap.com
Query Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
boundary | string | — | District polygon slug (e.g. clermont, downtown-nashville). Filters places within the boundary geometry. |
is_approved | boolean | true | Filter for approved places. |
is_closed | boolean | false | Whether to include permanently closed places. |
page | integer | 1 | Page number. |
page_size | integer | 50 | Number of results per page. |
2. Search Places (/v0.3/search/places/)
Use /v0.3/search/places/ when you need full-text search, spatial radius searches, or category filtering powered by Elasticsearch.
Request
GET https://api.vibemap.com/v0.3/search/places/?categories=arts&search=theatre&point=-84.507078,39.097171&dist=50000 HTTP/1.1
Host: api.vibemap.com
Query Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
search | string | — | Full-text search term matched against place names and descriptions. |
categories | string | — | Filter by category slug (e.g. arts, food-drink, music). Comma-separated. |
vibes | string | — | Filter by vibe keyword (e.g. cozy, lively, historic). Comma-separated. |
tags | string | — | Filter by taxonomy tag slug. Comma-separated. |
point | string | — | Center point coordinate formatted as lng,lat (e.g. -84.507078,39.097171). |
dist | integer | — | Radius in meters from point (e.g. 50000 for 50km). |
location__geo_distance | string | — | Alternative geo distance filter format: <meters>m__<lat>__<lng>. |
ordering | string | — | Sort order. Options include name, -score_combined, or distance if point is supplied. |
page_size | integer | 50 | Maximum results to return (up to 1000). |
Response Example
{
"count": 1413,
"next": "https://api.vibemap.com/v0.3/search/places/?page=2&page_size=1",
"previous": null,
"results": {
"type": "FeatureCollection",
"features": [
{
"id": "c76d29b2-32a1-4384-9036-7c6dfb4c2b9a",
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [-84.1824, 39.0743]
},
"properties": {
"name": "East Fork State Park",
"slug": "east-fork-state-park",
"address": "3294 Elklick Rd, Bethel, OH 45106",
"city": "Bethel",
"categories": ["outdoors", "parks"],
"category_slugs": ["outdoors", "parks"],
"vibes": ["scenic", "relaxing", "nature"],
"telephone": "(513) 734-4323",
"website": "https://ohiodnr.gov",
"is_approved": true,
"is_closed": false,
"vibemap_images": [
{
"url": "https://images.vibemap.com/places/east-fork.jpg",
"caption": "Lake overlook"
}
]
}
}
]
}
}