Region dossier

GET /api/region-dossier Returns a rich intelligence dossier for the country or region at the given coordinates. Data is assembled in parallel from Nominatim, RestCountries, Wikidata SPARQL, and the Wikipedia REST API.

Rate limit: 30 requests per minute per IP.

Caching

Results are cached for 24 hours keyed on a 0.1° grid (approximately 11 km). Multiple requests within the same grid cell return instantly from the cache.

Query parameters

lat

number

required

Latitude in decimal degrees (−90 to 90).

lng

number

required

Longitude in decimal degrees (−180 to 180).

Response

coordinates

object

required

The input coordinates.

Show properties

lat

number

Input latitude.

lng

number

Input longitude.

location

object

required

Reverse geocode result from Nominatim.

Show properties

city

string

Nearest city, town, or village.

state

string

State or region.

country

string

Country name.

country_code

string

ISO 3166-1 alpha-2 country code (uppercase).

display_name

string

Full formatted address string from Nominatim.

country

object

Country profile. null if the point is in international waters or an uninhabited area.

Show properties

name

string

Common country name.

official_name

string

Official country name.

leader

string

Head of state from Wikidata (P35).

government_type

string

Form of government from Wikidata (P122).

population

number

Population from RestCountries.

capital

string

Capital city.

languages

string[]

List of official languages.

currencies

string[]

List of currencies in "Name (symbol)" format.

region

string

World region (e.g. "Asia").

subregion

string

Sub-region (e.g. "Eastern Asia").

area_km2

number

Total land area in km².

flag_emoji

string

Flag emoji character.

local

object

Wikipedia summary for the nearest city or the country itself.

Show properties

name

string

City or locality name.

state

string

State or region name.

description

string

Short Wikipedia description (e.g. "Capital city of Japan").

summary

string

Wikipedia article extract (first few paragraphs).

thumbnail

string

URL of the Wikipedia thumbnail image.

error

string

Present only when no country data is available — e.g. "No country data — possibly international waters or uninhabited area".

Example

curl "http://localhost:8000/api/region-dossier?lat=35.6762&lng=139.6503"

{
  "coordinates": { "lat": 35.6762, "lng": 139.6503 },
  "location": {
    "city": "Tokyo",
    "state": "Tokyo",
    "country": "Japan",
    "country_code": "JP",
    "display_name": "Tokyo, Japan"
  },
  "country": {
    "name": "Japan",
    "official_name": "Japan",
    "leader": "Fumio Kishida",
    "government_type": "Constitutional monarchy",
    "population": 125681593,
    "capital": "Tokyo",
    "languages": ["Japanese"],
    "currencies": ["Japanese yen (¥)"],
    "region": "Asia",
    "subregion": "Eastern Asia",
    "area_km2": 377930,
    "flag_emoji": "🇯🇵"
  },
  "local": {
    "name": "Tokyo",
    "state": "Tokyo",
    "description": "Capital and most populous city of Japan",
    "summary": "Tokyo, officially the Tokyo Metropolis, is the capital and most populous city of Japan...",
    "thumbnail": "https://upload.wikimedia.org/wikipedia/commons/thumb/.../320px-Tokyo.jpg"
  }
}

Overview

Live Data

Intelligence

Radio

AIS

Settings

System

Caching

Query parameters

Response

Example

Build docs developers (and LLMs) love

Overview

Live Data

Intelligence

Radio

AIS

Settings

System

​Caching

​Query parameters

​Response

​Example

Build docs developers (and LLMs) love

Caching

Query parameters

Response

Example