Skip to main content

Places & Venues API

The Places API allows developers to query verified merchant listings, cultural institutions, parks, and venues within specific districts or regions.


Endpoints​

MethodPathDescription
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​

ParameterTypeDefaultDescription
boundarystring—District polygon slug (e.g. clermont, downtown-nashville). Filters places within the boundary geometry.
is_approvedbooleantrueFilter for approved places.
is_closedbooleanfalseWhether to include permanently closed places.
pageinteger1Page number.
page_sizeinteger50Number 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​

ParameterTypeDefaultDescription
searchstring—Full-text search term matched against place names and descriptions.
categoriesstring—Filter by category slug (e.g. arts, food-drink, music). Comma-separated.
vibesstring—Filter by vibe keyword (e.g. cozy, lively, historic). Comma-separated.
tagsstring—Filter by taxonomy tag slug. Comma-separated.
pointstring—Center point coordinate formatted as lng,lat (e.g. -84.507078,39.097171).
distinteger—Radius in meters from point (e.g. 50000 for 50km).
location__geo_distancestring—Alternative geo distance filter format: <meters>m__<lat>__<lng>.
orderingstring—Sort order. Options include name, -score_combined, or distance if point is supplied.
page_sizeinteger50Maximum 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"
}
]
}
}
]
}
}