Orizn Developers
Spots API
Read-only REST access to the Orizn community spot map: 440+ curated travel spots with photos, ratings, tags and precise coordinates. JSON responses, CORS enabled — call it straight from a browser.
Endpoints
GET /api/v1/spots — list & search public spots
GET /api/v1/spots/{id} — full spot detail with all media
Base URL: https://map.orizn.app/api/v1/spots
Parameters
| Param | Type | Description |
|---|---|---|
| country | ISO2 | Only spots in this country — e.g. country=VN. See available countries below. |
| q | string | Text search on the spot title — e.g. q=waterfall. |
| near | lat,lng | Geo search around a point — e.g. near=16.06,108.22. Results sorted by distance (distance_m included). |
| radius_km | number | Radius for ?near, default 50, max 500. |
| tags | list | Comma-separated tags — e.g. tags=beach,hike. |
| category | string | Filter by category. |
| min_rating | number | Minimum average rating (0–5). |
| limit | number | Results per page, default 20, max 50. |
| offset | number | Pagination offset, max 2000. |
Examples
curl "https://map.orizn.app/api/v1/spots?country=VN&limit=5"curl "https://map.orizn.app/api/v1/spots?near=16.06,108.22&radius_km=100"curl "https://map.orizn.app/api/v1/spots/{id}"Response shape
{
"count": 5,
"offset": 0,
"spots": [
{
"id": "019d95ee-…",
"title": "Pont du Dragon — Da Nang",
"description": "…",
"latitude": 16.0614,
"longitude": 108.2277,
"tags": ["city", "night"],
"country_code": "VN",
"avg_rating": 4.8,
"review_count": 12,
"photos": ["https://api.orizn.app/media/…jpg"],
"url": "https://orizn.app/spot/019d95ee-…"
}
]
}Available countries with spot counts: GET /api/spots/countries
Rate limits & API keys
Without a key you get a metered demo allowance per IP (30 requests/day) — enough to explore. With a free API key you get your plan's monthly quota, and each Orizn API has its own separate pool: spots calls never consume your visa API quota, and vice versa.
curl "https://map.orizn.app/api/v1/spots?country=IS" -H "x-api-key: YOUR_KEY"The same key also works with the Visa API (real-time visa requirements, 199 passports × 202 destinations).