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.