{"openapi":"3.1.0","info":{"title":"World Heritage API","version":"1.0.0","description":"Every UNESCO World Heritage Site as an API — all 1,236 inscribed sites worldwide (cultural, natural and mixed) from the official UNESCO World Heritage List. Look up any site by its WHC id (e.g. Galápagos Islands, Machu Picchu, Historic Centre of Rome) with its country, exact coordinates, the year it was inscribed and the UNESCO selection criteria. Search and filter by name, country, category (cultural / natural / mixed) and inscription year, or find every World Heritage Site near any coordinate by great-circle distance. Ideal for travel, tourism, maps, education and cultural-discovery apps.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/heritage-api","description":"oanor gateway"}],"tags":[{"name":"World Heritage"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/nearby":{"get":{"operationId":"get_v1_nearby","tags":["World Heritage"],"summary":"Sites near a coordinate (great-circle)","description":"","parameters":[{"name":"lat","in":"query","required":false,"description":"Latitude (-90..90)","schema":{"type":"string"},"example":"41.9"},{"name":"lon","in":"query","required":false,"description":"Longitude (-180..180)","schema":{"type":"string"},"example":"12.5"},{"name":"radius_km","in":"query","required":false,"description":"Search radius in km (1-20000, default 500)","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"Optional category filter","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (1-100, default 20)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":20,"total":62,"center":{"lat":41.9,"lon":12.5},"results":[{"name":"Historic Centre of Rome, the Properties of the Holy See in that City Enjoying Extraterritorial Rights and San Paolo Fuori le Mura","whc_id":91,"country":"Vatican City","category":"cultural","criteria":["i","ii","iii","iv","vi"],"latitude":41.8928,"longitude":12.4866,"distance_km":1,"year_inscribed":1980},{"name":"Vatican City","whc_id":286,"country":"Vatican City","category":"cultural","criteria":["i","ii","iv","vi"],"latitude":41.904,"longitude":12.453,"distance_km":4,"year_inscribed":1984},{"name":"Appian Way","whc_id":1708,"country":"Italy","category":"cultural","criteria":["i","iii","iv","v","vi"],"latitude":41.841389,"longitude":12.5325,"distance_km":7,"year_inscribed":2024},{"name":"Hadrian's Villa","whc_id":907,"country":"Italy","category":"cultural","criteria":["i","ii","iii"],"latitude":41.941944,"longitude":12.775278,"distance_km":23,"year_inscribed":1999},{"name":"Villa d'Este","whc_id":1025,"country":"Italy","category":"cultural","criteria":["i","ii","iii","iv","vi"],"latitude":41.9625,"longitude":12.796111,"distance_km":25,"year_inscribed":2001},{"name":"Etruscan Necropolises of Cerveteri and Tarquinia","whc_id":1158,"country":"Italy","category":"cultural","criteria":["i","iii","iv"],"latitude":42.006833,"longitude":12.101889,"distance_km":35,"year_inscribed":2004},{"name":"Assisi, the Basilica of San Francesco and Other Franciscan Sites","whc_id":990,"country":"Italy","category":"cultural","criteria":["i","ii","iii","iv","vi"],"latitude":43.066167,"longitude":12.622444,"distance_km":130,"year_inscribed":2000},{"name":"Historic Centre of the City of Pienza","whc_id":789,"country":"Italy","category":"cultural","criteria":["i","ii","iv"],"latitude":43.0766,"longitude":11.679,"distance_km":147,"year_inscribed":1996},{"name":"Val d'Orcia","whc_id":1026,"country":"Italy","category":"cultural","criteria":["iv","vi"],"latitude":43.066667,"longitude":11.55,"distance_km":151,"year_inscribed":2004},{"name":"18th-Century Royal Palace at Caserta with the Park, the Aqueduct of Vanvitelli, and the San Leucio Complex","whc_id":549,"country":"Italy","category":"cultural","criteria":["i","ii","iii","iv"],"latitude":41.07333,"longitude":14.32639,"distance_km":178,"year_inscribed":1997},{"name":"Historic Centre of Siena","whc_id":717,"country":"Italy","category":"cultural","criteria":["i","ii","iv"],"latitude":43.318611,"longitude":11.331667,"distance_km":184,"year_inscribed":1995},{"name":"Historic Centre of Naples","whc_id":726,"country":"Italy","category":"cultural","criteria":["ii","iv"],"latitude":40.85139,"longitude":14.26278,"distance_km":188,"year_inscribed":1995},{"name":"Historic Centre of Urbino","whc_id":828,"country":"Italy","category":"cultural","criteria":["ii","iv"],"latitude":43.725,"longitude":12.63333,"distance_km":203,"year_inscribed":1998},{"name":"Archaeological Areas of Pompei, Herculaneum and Torre Annunziata","whc_id":829,"country":"Italy","category":"cultural","criteria":["iii","iv","v"],"latitude":40.75,"longitude":14.483333,"distance_km":209,"year_inscribed":1997},{"name":"Historic Centre of San Gimignano","whc_id":550,"country":"Italy","category":"cultural","criteria":["i","iii","iv"],"latitude":43.467057,"longitude":11.042804,"distance_km":211,"year_inscribed":1990},{"name":"Amalfi Coast","whc_id":830,"country":"Italy","category":"cultural","criteria":["ii","iv","v"],"latitude":40.633333,"longitude":14.6,"distance_km":225,"year_inscribed":1997},{"name":"San Marino Historic Centre and Mount Titano","whc_id":1245,"country":"San Marino","category":"cultural","criteria":["iii"],"latitude":43.932778,"longitude":12.451944,"distance_km":226,"year_inscribed":2008},{"name":"Historic Centre of Florence","whc_id":174,"country":"Italy","category":"cultural","criteria":["i","ii","iii","iv","vi"],"latitude":43.77306,"longitude":11.256111,"distance_km":232,"year_inscribed":1982},{"name":"Medici Villas and Gardens in Tuscany","whc_id":175,"country":"Italy","category":"cultural","criteria":["ii","iv","vi"],"latitude":43.857778,"longitude":11.304167,"distance_km":238,"year_inscribed":2013},{"name":"Piazza del Duomo, Pisa","whc_id":395,"country":"Italy","category":"cultural","criteria":["i","ii","iv","vi"],"latitude":43.723428,"longitude":10.394778,"distance_km":266,"year_inscribed":1987}],"radius_km":500},"meta":{"timestamp":"2026-05-31T07:26:14.640Z","request_id":"e1ac5186-3092-422a-99e8-2b33d5598fd8"},"status":"ok","message":"Nearby sites retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["World Heritage"],"summary":"Search & filter sites","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Search term matched against the site name","schema":{"type":"string"},"example":"castle"},{"name":"country","in":"query","required":false,"description":"Restrict to a country, e.g. Italy","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"cultural | natural | mixed","schema":{"type":"string"}},{"name":"year_from","in":"query","required":false,"description":"Inscribed in or after this year","schema":{"type":"string"}},{"name":"year_to","in":"query","required":false,"description":"Inscribed in or before this year","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results per page (1-100, default 20)","schema":{"type":"string"},"example":"20"},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":12,"limit":20,"query":"castle","total":12,"offset":0,"filters":[],"results":[{"name":"Castles and Town Walls of King Edward in Gwynedd","whc_id":374,"country":"United Kingdom","category":"cultural","criteria":["i","iii","iv"],"latitude":53.139722,"longitude":-4.276944,"year_inscribed":1986},{"name":"Forts and Castles, Volta, Greater Accra, Central and Western Regions","whc_id":34,"country":"Ghana","category":"cultural","criteria":["vi"],"latitude":5.103694,"longitude":-1.241,"year_inscribed":1979},{"name":"Durham Castle and Cathedral","whc_id":370,"country":"United Kingdom","category":"cultural","criteria":["ii","iv","vi"],"latitude":54.774722,"longitude":-1.576111,"year_inscribed":1986},{"name":"Budapest, including the Banks of the Danube, the Buda Castle Quarter and Andrássy Avenue","whc_id":400,"country":"Hungary","category":"cultural","criteria":["ii","iv"],"latitude":47.48242,"longitude":19.07067,"year_inscribed":1987},{"name":"Collegiate Church, Castle, and Old Town of Quedlinburg","whc_id":535,"country":"Germany","category":"cultural","criteria":["iv"],"latitude":51.78333,"longitude":11.15,"year_inscribed":1994},{"name":"Levoča, Spiš Castle and the associated cultural monuments","whc_id":620,"country":"Slovakia","category":"cultural","criteria":["iv"],"latitude":48.999444,"longitude":20.7675,"year_inscribed":1993},{"name":"Mir Castle Complex","whc_id":625,"country":"Belarus","category":"cultural","criteria":["ii","iv"],"latitude":53.451267,"longitude":26.472894,"year_inscribed":2000},{"name":"Himeji Castle","whc_id":661,"country":"Japan","category":"cultural","criteria":["i","iv"],"latitude":34.839444,"longitude":134.693611,"year_inscribed":1993},{"name":"Kronborg Castle","whc_id":696,"country":"Denmark","category":"cultural","criteria":["iv"],"latitude":56.038611,"longitude":12.621944,"year_inscribed":2000},{"name":"Malbork Castle","whc_id":847,"country":"Poland","category":"cultural","criteria":["ii","iii","iv"],"latitude":54.039722,"longitude":19.027778,"year_inscribed":1997},{"name":"Gardens and Castle at Kroměříž","whc_id":860,"country":"Czech Republic","category":"cultural","criteria":["ii","iv"],"latitude":49.297172,"longitude":17.381427,"year_inscribed":1998},{"name":"Three Castles of Bellinzona","whc_id":884,"country":"Switzerland","category":"cultural","criteria":["iv"],"latitude":46.192778,"longitude":9.022222,"year_inscribed":2000}]},"meta":{"timestamp":"2026-05-31T07:26:14.713Z","request_id":"e95f0ea3-6015-428b-afc0-cdd080adc87c"},"status":"ok","message":"Sites searched","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/site":{"get":{"operationId":"get_v1_site","tags":["World Heritage"],"summary":"One World Heritage Site by WHC id","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"WHC site id, e.g. 1 (Galápagos Islands)","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"site":{"name":"Galápagos Islands","whc_id":1,"country":"Ecuador","category":"natural","criteria":["ix","vii","viii","x"],"latitude":-0.622977,"longitude":-90.361243,"year_inscribed":1978}},"meta":{"timestamp":"2026-05-31T07:26:14.782Z","request_id":"3f2b9945-16da-427e-9d06-9d14116d9e68"},"status":"ok","message":"Site retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Totals & breakdown","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"1,236 inscribed UNESCO World Heritage Sites. category: cultural | natural | mixed. criteria: UNESCO selection criteria i-vi (cultural) / vii-x (natural).","total":1236,"fields":["whc_id","name","country","latitude","longitude","year_inscribed","category","criteria"],"source":"UNESCO World Heritage List (via Wikidata)","countries":174,"by_category":{"mixed":41,"natural":236,"cultural":957},"top_countries":[{"count":57,"country":"People's Republic of China"},{"count":54,"country":"Italy"},{"count":51,"country":"France"},{"count":49,"country":"Germany"},{"count":46,"country":"Spain"},{"count":43,"country":"India"},{"count":35,"country":"Mexico"},{"count":33,"country":"United Kingdom"},{"count":29,"country":"Iran"},{"count":28,"country":"Russia"},{"count":25,"country":"United States"},{"count":25,"country":"Japan"}]},"meta":{"timestamp":"2026-05-31T07:26:14.861Z","request_id":"9e827913-7d79-4af1-b7e8-bfb09c1f5488"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":4000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":500,"monthly_call_quota":48000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1300,"monthly_call_quota":240000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3400,"monthly_call_quota":1200000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/heritage-api"}