Search the UNESCO World Heritage List by keyword, country, category (Cultural, Natural, Mixed), region, inscription criteria (i)–(x), inscription year range, Danger-list status, transboundary status, or distance from a point. Every keyword must appear at the start of a word in a site's name (any of six languages), component names, description, or statement of Outstanding Universal Value; name matches rank first, then component matches, which list the components that matched. A country is an ISO 3166-1 alpha-2 or alpha-3 code and matches every site it shares, transboundary sites included. Set in_danger to true for the List of World Heritage in Danger; the data records the year of each site's current Danger-list entry but no threat factors. Criterion (vi) is inferred from each site's statement of Outstanding Universal Value and marked as inferred. Results page with next_cursor and carry facet counts over the whole match.
View input schema
{
"type": "object",
"properties": {
"query": {
"description": "Keywords; every word must match the start of a word in a site's name (any of six languages), component names, description, or statement of Outstanding Universal Value. Case, accents, and punctuation are ignored, so the query must contain at least one letter or digit and at most 16 distinct words; no phrases, operators, or fuzzy matching.",
"type": "string",
"maxLength": 200
},
"country": {
"description": "ISO 3166-1 alpha-2 or alpha-3 code, any case (FR, FRA). Matches every site the country takes part in, transboundary sites included. For a country name, look up its code with unesco_list_reference (topic countries).",
"type": "string",
"maxLength": 64
},
"category": {
"description": "Site category: Cultural, Natural, or Mixed.",
"type": "string",
"enum": [
"Cultural",
"Natural",
"Mixed"
]
},
"region": {
"description": "UNESCO region: Africa, Arab States, Asia and the Pacific, Europe and North America, or Latin America and the Caribbean (codes AFR, ARB, APA, EUR, LAC accepted).",
"type": "string",
"enum": [
"Africa",
"Arab States",
"Asia and the Pacific",
"Europe and North America",
"Latin America and the Caribbean"
]
},
"criteria": {
"description": "Inscription criteria a site must all carry. (i) A masterpiece of human creative genius. (ii) An important interchange of human values over time or within a cultural area, in architecture, technology, monumental arts, town planning, or landscape design. (iii) A unique or exceptional testimony to a cultural tradition or a civilization, living or vanished. (iv) An outstanding example of a type of building, architectural or technological ensemble, or landscape illustrating significant stages in human history. (v) An outstanding example of traditional human settlement, land use, or sea use representative of a culture or of human interaction with the environment, especially where vulnerable to irreversible change. (vi) Direct association with events, living traditions, ideas, beliefs, or artistic and literary works of outstanding universal significance. (vii) Superlative natural phenomena, or areas of exceptional natural beauty and aesthetic importance. (viii) An outstanding example of a major stage of Earth's history, including the record of life, significant ongoing geological processes, or significant landforms. (ix) An outstanding example of significant ongoing ecological and biological processes in the evolution of ecosystems and communities of plants and animals. (x) The most important natural habitats for in-situ conservation of biological diversity, including those holding threatened species of outstanding universal value. Criterion (vi) is inferred from the statement of Outstanding Universal Value, since UNESCO's criteria fields omit it.",
"maxItems": 10,
"type": "array",
"items": {
"description": "A criterion numeral i–x; 1–10 and (iv)-style forms are accepted.",
"type": "string",
"enum": [
"i",
"ii",
"iii",
"iv",
"v",
"vi",
"vii",
"viii",
"ix",
"x"
]
}
},
"in_danger": {
"description": "true: only sites on the List of World Heritage in Danger. false: only sites not on it. Omit for both.",
"type": "boolean"
},
"transboundary": {
"description": "true: only sites shared by more than one State Party. false: only single-State sites.",
"type": "boolean"
},
"inscribed_from": {
"description": "Earliest inscription year, inclusive.",
"type": "integer",
"minimum": 1900,
"maximum": 2100
},
"inscribed_to": {
"description": "Latest inscription year, inclusive.",
"type": "integer",
"minimum": 1900,
"maximum": 2100
},
"near": {
"description": "Only sites within radius_km of this point: a site matches when its representative point or any of its components lies within the radius, and a site with neither never matches. The match and the distance sort use the exact distance to the nearest of those points, which distance_km shows rounded to 0.1 km and never above radius_km.",
"type": "object",
"properties": {
"latitude": {
"type": "number",
"minimum": -90,
"maximum": 90,
"description": "Latitude of the point, in decimal degrees (−90 to 90)."
},
"longitude": {
"type": "number",
"minimum": -180,
"maximum": 180,
"description": "Longitude of the point, in decimal degrees (−180 to 180)."
},
"radius_km": {
"description": "Search radius in kilometres (up to 5000, default 100).",
"default": 100,
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000
}
},
"required": [
"latitude",
"longitude"
],
"additionalProperties": false
},
"sort": {
"description": "Result order. Default: relevance when query is set, else distance when near is set, else name. relevance needs query; distance needs near. Absent areas and Danger years sort last.",
"type": "string",
"enum": [
"relevance",
"name",
"inscribed_newest",
"inscribed_oldest",
"area_largest",
"danger_listed_newest",
"distance"
]
},
"include_description": {
"description": "Set false to leave each row's description out of the response (default true); unesco_get_site returns it. Which sites match, their order, matched_in, and matched_components are unchanged.",
"default": true,
"type": "boolean"
},
"limit": {
"description": "Maximum results per page (default 20). A page holds at most 50: a larger limit, up to 10000, is served as 50 and notice says so.",
"default": 20,
"type": "integer",
"minimum": 1,
"maximum": 10000
},
"cursor": {
"description": "Opaque continuation cursor from the previous call's next_cursor. Pass it with the same filters and sort to fetch the next page.",
"type": "string",
"maxLength": 1024
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}