Skip to main content
The Obvlo API provides three search endpoints served by a Fastify server deployed as a Google Cloud Function in europe-west1.

​
Base URL

Base URL
https://api.obvlo.com

​
Authentication

All requests require a valid orgId query parameter. You may also pass a profileId to scope results to a specific host profile. Contact support@obvlo.com to obtain your credentials.

​
Endpoints

Guide Search

GET /v2/orgs/{orgId}/guide-search — Search curated travel guides.

Listing Search

GET /v2/orgs/{orgId}/listing-search — Search individual listings.

Location Search

GET /v2/orgs/{orgId}/location-search — Search neighbourhoods and areas.

Host Profile

GET /v2/orgs/{orgId}/host-profile — Retrieve branding and configuration for a host property.

Host Home

GET /v2/orgs/{orgId}/host-home — Bootstrap a host home screen in a single request.

Organisation Languages

GET /v2/orgs/{orgId}/org-languages — Retrieve supported languages for an organisation.

​
Pagination

All search endpoints return paginated results. Use page (1-based) and hitsPerPage (max 20) to navigate pages. The response always includes total (total matching records) and pages (total page count).

​
Localisation

Guide fields such as name, description, and introText are returned as objects keyed by BCP 47 language code (e.g. { "en-GB": "Top Restaurants" }). For listing endpoints, pass the lang parameter to receive resolved localised text fields in the response.