Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: dumaguete.uk places Search API
version: 1.0.0
summary: What is at this address in Dumaguete City, and what is near it.
description: Keyless JSON over the same 741 places in Dumaguete City that the HTML pages render. Read https://dumaguete.uk/llms-full.txt#fields before filtering on category.
contact:
email: ai@dumaguete.uk
url: https://dumaguete.uk
license:
name: RSL
url: https://dumaguete.uk/license.xml
servers:
- url: https://dumaguete.uk
tags:
- name: Search
paths:
/v1/search:
get:
operationId: searchPlaces
summary: Which places match this name?
parameters:
- name: q
in: query
description: Substring, case-insensitive, min 2 chars.
schema:
type: string
example: Office
- name: limit
in: query
description: Max 200.
schema:
type: integer
default: 50
responses:
'200':
description: Matches
content:
application/json:
schema:
type: object
properties:
count:
type: integer
results:
type: array
items:
type: object
properties:
id:
type: integer
name:
type: string
lat:
type: number
lon:
type: number
category:
type: string
address:
type: string
hours:
type: string
description: opening hours exactly as published upstream; free text, not a schedule you may parse into a promise
osm:
type: string
description: OpenStreetMap element this record came from
source:
type: string
description: where this record came from
phone:
type: string
description: contact number as published
website:
type: string
description: the place's own site
email:
type: string
description: contact address as published
distance_km:
type: number
description: present only on a near= query, great-circle
required:
- id
- name
- lat
- lon
tags:
- Search