Albania Atlas

Every county, coast and century

The Albania Atlas
Places
Sections
Tools
Settings
Dark mode
Interface language
About
Settings
Dark mode
Interface language

Guided view
New to Albania? Every page opens with a plain-language explanation you could read to a ten-year-old, before the detail begins.

Expert view
You already know the basics. Straight to the substance, with the simple explanations hidden. This is the default.

★ Your saved pages

Tools

A free read-only API

Cached JSON over the same records the pages render, with the sources attached. Use it rather than scraping the HTML.

Endpoints

Entity

GET /api/v1/entity/{kind}/{slug} # example GET /api/v1/entity/city/berat GET /api/v1/entity/beach/borsh GET /api/v1/entity/site/butrint

Returns the record, its curated and measured facts, its images with creator and licence, and its graph relationships.

Climate normals

GET /api/v1/climate/{kind}/{slug} # example GET /api/v1/climate/city/sarande

Twelve months of normals computed from ERA5 reanalysis over 1994–2023, with the period and source stated in the payload.

Data series

GET /api/v1/metric/{code} # example GET /api/v1/metric/population GET /api/v1/metric/tourism-arrivals

The full observation history with each value's period, producer and retrieval date.

Search

GET /api/search?q=berat

Terms

  • No key, no rate limit beyond ordinary fair use. Please identify your client in the User-Agent header.
  • Editorial text and the entity graph: attribute The Albania Atlas and link back.
  • Photographs: the API returns each image's creator, licence and source file page. Reuse them under their own licences from the source, not from here.
  • Data series remain subject to their producers' terms — see data sources.
  • Values are cached and may lag the producer's latest release. Every payload carries the observation period so you can tell.