Skip to main content

Themes, Boundaries & Taxonomies API

These endpoints provide metadata, styling configuration, boundary shapes, and standard taxonomies that power district discovery experiences.


1. District Themes (/v0.3/themes/)​

Themes define branding, colors, typography, and embed layout configurations for a specific client district or neighborhood.

Endpoints​

  • GET /v0.3/themes/ — List all public themes.
  • GET /v0.3/themes/{slug}/ — Retrieve complete theme styling and configuration tokens by slug (e.g. /v0.3/themes/clermont/).

Request​

GET https://api.vibemap.com/v0.3/themes/clermont/ HTTP/1.1
Host: api.vibemap.com

Key Response Fields​

  • name: Display name of the district (e.g. "Connect Clermont").
  • slug: URL identifier (e.g. "clermont").
  • color: Primary brand accent color hex (e.g. "#0072ce").
  • branding: Logos, favicon, and partner visual identity assets.
  • design_tokens: Typography, border radii, shadows, and color palette tokens.
  • layout: Display defaults for map styles, cards, and filter toggles.

2. Boundaries API (/v0.3/boundaries/)​

Boundaries represent geographical polygons (neighborhoods, BIDs, downtown districts, or municipal borders).

Endpoints​

  • GET /v0.3/boundaries/ — List boundaries.
  • GET /v0.3/boundaries/{id}/ — Retrieve detailed boundary record with polygon geometries.

Query Parameters​

ParameterTypeDescription
show_in_appbooleanFilter boundaries designated for public applications (true).
typestringFilter by boundary classification (e.g. neighborhood, bid, city).
searchstringSearch boundary by name or city.

3. Taxonomies: Categories, Vibes & Tags​

Standard vocabularies used across Vibemap for tagging and search filtering.

Categories (GET /v0.3/categories)​

Returns the hierarchical taxonomy of place and event categories:

{
"categories": [
{
"id": 1138,
"slug": "arts",
"name": "Arts & Culture",
"parent": null
},
{
"id": 1791,
"slug": "gallery",
"name": "Art Gallery",
"parent": "arts"
}
]
}

Vibes (GET /v0.3/vibes/)​

Returns the complete list of canonical vibe tags used for experiential filtering:

{
"all_vibes": [
{ "name": "cozy" },
{ "name": "lively" },
{ "name": "family-friendly" },
{ "name": "romantic" },
{ "name": "scenic" }
]
}

Tags (GET /v0.3/tags/)​

Returns editorial and municipal taxonomy tags (such as black-owned, women-owned, wheelchair-accessible).


4. Search Autocomplete (/v0.3/search/autocomplete/)​

Fast prefix lookup for search inputs:

GET https://api.vibemap.com/v0.3/search/autocomplete/?q=coffee HTTP/1.1
Host: api.vibemap.com

Response Example​

{
"results": [
{
"id": "e932b109-8472-4638-9210-983b6320a102",
"name": "Coffee Emporium",
"model": "place"
}
]
}