Search UNESCO World Heritage sites, intangible heritage, biosphere reserves, and Global Geoparks.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Fetch one biosphere reserve's full record by mab_id: its introduction, ecological and socio-economic characteristics, core, buffer, and transition areas (terrestrial and marine, in hectares) with resident population by zone, designation, extension, renaming, and periodic-review years, coordinates, and its UNESCO page.
The reserve's mab_id, from unesco_search_biosphere_reserves. Case and accents are ignored.
Fetch one biosphere reserve's full record by mab_id: its introduction, ecological and socio-economic characteristics, core, buffer, and transition areas (terrestrial and marine, in hectares) with resident population by zone, designation, extension, renaming, and periodic-review years, coordinates, and its UNESCO page.
| Argument | Type | Description |
|---|---|---|
| mab_id* | string | The reserve's mab_id, from unesco_search_biosphere_reserves. Case and accents are ignored. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"mab_id"
],
"properties": {
"mab_id": {
"type": "string",
"maxLength": 20,
"minLength": 1,
"description": "The reserve's mab_id, from unesco_search_biosphere_reserves. Case and accents are ignored."
}
},
"additionalProperties": false
}Fetch one UNESCO Global Geopark's full record by ugg_id: its countries, designation year, transnational status, area and resident population as recorded, coordinates, UNESCO's introduction and description, its account of how the geopark sustains local communities, its own website, and its UNESCO page.
| Argument | Type | Description |
|---|---|---|
| ugg_id* | string | The geopark's ugg_id, such as EUFR10, from unesco_search_geoparks. Case and surrounding whitespace are ignored. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"ugg_id"
],
"properties": {
"ugg_id": {
"type": "string",
"pattern": "^[A-Za-z0-9]+$",
"maxLength": 20,
"description": "The geopark's ugg_id, such as EUFR10, from unesco_search_geoparks. Case and surrounding whitespace are ignored."
}
},
"additionalProperties": false
}Fetch one Intangible Cultural Heritage element's full record by ich_ref: its description, the list it is inscribed on, the countries that share it, its inscription year, UNESCO concept terms, the World Heritage sites UNESCO links to it, its UNESCO page, and the main image with its caption and copyright credit. description_language fr returns UNESCO's French description instead of the English one.
| Argument | Type | Description |
|---|---|---|
| ich_ref* | string | The element's ich_ref, from unesco_search_intangible_heritage. A number, a digit string, or the element's ich.unesco.org/en/{RL|USL|Art18}/{ref} page URL. |
| description_language | string | Language of the description UNESCO publishes for the element: en or fr, in any case; UNESCO publishes element descriptions in no other language. Unset returns the English description. When UNESCO publishes none in French, the English one is returned with description_language en, and notice says so. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"ich_ref"
],
"properties": {
"ich_ref": {
"type": "string",
"pattern": "^[1-9]\\d{0,4}$",
"description": "The element's ich_ref, from unesco_search_intangible_heritage. A number, a digit string, or the element's ich.unesco.org/en/{RL|USL|Art18}/{ref} page URL."
},
"description_language": {
"enum": [
"en",
"fr"
],
"type": "string",
"description": "Language of the description UNESCO publishes for the element: en or fr, in any case; UNESCO publishes element descriptions in no other language. Unset returns the English description. When UNESCO publishes none in French, the English one is returned with description_language en, and notice says so."
}
},
"additionalProperties": false
}Fetch one World Heritage site's full record by id_no: its description, statement of Outstanding Universal Value, each inscription criterion with its meaning (criterion (vi) marked as inferred), States Parties, coordinates, area, inscription and later years, Danger-list year, component parts, names in six languages, and the main image with its copyright credit. description_language returns UNESCO's French, Spanish, Russian, Arabic, or Chinese description instead of the English one. Intangible heritage UNESCO links to the site is listed by unesco_search_intangible_heritage with world_heritage_site.
| Argument | Type | Description |
|---|---|---|
| id_no* | string | The site's World Heritage id_no, from unesco_search_sites. A number, a digit string, or the site's whc.unesco.org/en/list/{id} page URL. |
| max_components | integer | Maximum component parts to list (default 20). One call lists at most 1000: a larger value, up to 10000, is served as 1000 and notice says so. 0 omits the list but keeps components_total; the largest site has 758 components. |
| description_language | string | Language of the description UNESCO publishes for the site: en, fr, es, ru, ar, or zh, in any case. Unset returns the English description. When UNESCO publishes none in that language, the English one is returned with description_language en, and notice says so. The statement of Outstanding Universal Value is English only. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id_no"
],
"properties": {
"id_no": {
"type": "string",
"pattern": "^[1-9]\\d{0,4}$",
"description": "The site's World Heritage id_no, from unesco_search_sites. A number, a digit string, or the site's whc.unesco.org/en/list/{id} page URL."
},
"max_components": {
"type": "integer",
"default": 20,
"maximum": 10000,
"minimum": 0,
"description": "Maximum component parts to list (default 20). One call lists at most 1000: a larger value, up to 10000, is served as 1000 and notice says so. 0 omits the list but keeps components_total; the largest site has 758 components."
},
"description_language": {
"enum": [
"en",
"fr",
"es",
"ru",
"ar",
"zh"
],
"type": "string",
"description": "Language of the description UNESCO publishes for the site: en, fr, es, ru, ar, or zh, in any case. Unset returns the English description. When UNESCO publishes none in that language, the English one is returned with description_language en, and notice says so. The statement of Outstanding Universal Value is English only."
}
},
"additionalProperties": false
}List the vocabulary the other unesco_ tools accept and the coverage of the underlying datasets: the ten inscription criteria with their meanings and site counts, the countries in each dataset with their ISO alpha-2 and alpha-3 codes and record counts, the five UNESCO regions, the three intangible heritage lists, the MAB regional networks, and each dataset's record count, license, and data date. Set filter to narrow a topic to matching entries, for example a country name to find its code.
| Argument | Type | Description |
|---|---|---|
| topic* | string | What to list. criteria: the ten inscription criteria (i)–(x) with meanings and site counts, the values of the criteria input of unesco_search_sites. countries: every country with its ISO alpha-2 and alpha-3 codes and counts per dataset, the values of every country input. regions: the five UNESCO regions with codes, the values of the region inputs. intangible_lists: the three intangible heritage lists with acronyms, the values of the list input of unesco_search_intangible_heritage. biosphere_networks: the MAB regional networks with acronyms, the values of the regional_network input of unesco_search_biosphere_reserves. datasets: each dataset with its record count, data date, license, attribution, and coverage notes. |
| filter | string | Keep only entries whose name or code (a criterion's meaning, a dataset's title) contains every word of this text, each word matching at the start of a word. Case, accents, and punctuation are ignored, so the filter must contain at least one letter or digit and at most 16 distinct words. For example, a country name finds its ISO code. For countries, a two- or three-letter ISO code (or UK) keeps exactly that country, as the country inputs read it, and common former or everyday names such as Turkey, Swaziland, or Holland match too. |
Search the World Network of Biosphere Reserves (UNESCO Man and the Biosphere Programme) by keyword, country, region, MAB regional network, designation year range, transboundary or Small Island Developing States status, or distance from a point. Every keyword must appear at the start of a word in the reserve's name, introduction, or ecological or socio-economic description; there is no biome or ecosystem field, so an ecosystem search is a keyword search such as mangrove or alpine. A country is an ISO 3166-1 alpha-2 or alpha-3 code. A transboundary reserve appears once per participating country, each with its own mab_id. Results page with next_cursor and carry facet counts over the whole match.
| Argument | Type | Description |
|---|---|---|
| near | object | Only reserves within radius_km of this point. Every reserve has coordinates. |
| sids | boolean | true: only reserves in Small Island Developing States. false: only reserves elsewhere. |
| sort | string | Result order. Default: relevance when query is set, else distance when near is set, else name. relevance needs query; distance needs near. area_largest orders by total recorded area. |
| limit | integer | 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. |
| query | string | Keywords; every word must match the start of a word in the reserve's name, introduction, or ecological or socio-economic description. 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. For an ecosystem, use a habitat word such as mangrove, wetland, or alpine. |
Search UNESCO Global Geoparks by keyword, country, designation year range, transnational status, or distance from a point. Every keyword must appear at the start of a word in the geopark's name, introduction, description, or account of how it sustains local communities, and name matches rank first. A country is an ISO 3166-1 alpha-2 or alpha-3 code and matches every geopark it takes part in, transnational geoparks included. Geoparks UNESCO recognized before the Global Geopark label existed are dated 2015, the year it was created. Results page with next_cursor and carry facet counts over the whole match.
| Argument | Type | Description |
|---|---|---|
| near | object | Only geoparks within radius_km of this point. Every geopark has one point, which the distance measures. |
| sort | string | Result order. Default: relevance when query is set, else distance when near is set, else name. relevance needs query; distance needs near. area_largest orders by recorded area. |
| limit | integer | 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. |
| query | string | Keywords; every word must match the start of a word in the geopark's name, introduction, description, or account of sustaining local communities. 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. For a landform, use a word such as volcanic, karst, or fossil. |
| cursor |
Search UNESCO's Intangible Cultural Heritage lists — the Representative List, the Urgent Safeguarding List, and the Register of Good Safeguarding Practices — by keyword, country, list, inscription year range, multinational status, or linked World Heritage site. Every keyword must appear at the start of a word in an element's English or French name, its UNESCO concept terms, or its description, and name matches rank first. A country is an ISO 3166-1 alpha-2 or alpha-3 code and matches every element it shares, multinational elements included. world_heritage_site takes a site's id_no and lists the elements UNESCO links to it. Rows omit the description; read it with unesco_get_intangible_heritage_element. Results page with next_cursor and carry facet counts over the whole match.
| Argument | Type | Description |
|---|---|---|
| list | string | Intangible heritage list: Representative List, Urgent Safeguarding List, or Register of Good Safeguarding Practices (acronyms RL, USL, Art18 accepted). |
| sort | string | Result order. Default: relevance when query is set, else name. relevance needs query. |
| limit | integer | 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. |
| query | string | Keywords; every word must match the start of a word in an element's English or French name, its UNESCO concept terms, or its description. 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. |
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), description, or statement of Outstanding Universal Value, and name matches rank first. 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.
| Argument | Type | Description |
|---|---|---|
| near | object | 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. |
| sort | string | 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. |
| limit | integer | 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. |
| query | string | Keywords; every word must match the start of a word in a site's name (any of six languages), 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": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"topic"
],
"properties": {
"topic": {
"enum": [
"criteria",
"countries",
"regions",
"intangible_lists",
"biosphere_networks",
"datasets"
],
"type": "string",
"description": "What to list. criteria: the ten inscription criteria (i)–(x) with meanings and site counts, the values of the criteria input of unesco_search_sites. countries: every country with its ISO alpha-2 and alpha-3 codes and counts per dataset, the values of every country input. regions: the five UNESCO regions with codes, the values of the region inputs. intangible_lists: the three intangible heritage lists with acronyms, the values of the list input of unesco_search_intangible_heritage. biosphere_networks: the MAB regional networks with acronyms, the values of the regional_network input of unesco_search_biosphere_reserves. datasets: each dataset with its record count, data date, license, attribution, and coverage notes."
},
"filter": {
"type": "string",
"maxLength": 100,
"description": "Keep only entries whose name or code (a criterion's meaning, a dataset's title) contains every word of this text, each word matching at the start of a word. Case, accents, and punctuation are ignored, so the filter must contain at least one letter or digit and at most 16 distinct words. For example, a country name finds its ISO code. For countries, a two- or three-letter ISO code (or UK) keeps exactly that country, as the country inputs read it, and common former or everyday names such as Turkey, Swaziland, or Holland match too."
}
},
"additionalProperties": false
}| cursor | string | Opaque continuation cursor from the previous call's next_cursor. Pass it with the same filters and sort to fetch the next page. |
| region | string | 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). Matches any of a reserve's regions. |
| country | string | ISO 3166-1 alpha-2 or alpha-3 code, any case (FR, FRA). Matches the reserve's country; a transboundary reserve has one row per participating country. For a country name, look up its code with unesco_list_reference (topic countries). |
| designated_to | integer | Latest designation year, inclusive. |
| transboundary | boolean | true: only transboundary reserves (one row per participating country). false: only single-country reserves. |
| designated_from | integer | Earliest designation year, inclusive. |
| regional_network | string | MAB regional network, by full name or acronym (AfriMAB, ArabMAB, EABRN, EuroMAB, IberoMAB, SACAM, SeaBRnet), any case. A few reserves belong to no network. |
| include_description | boolean | Set false to leave each row's introduction out of the response (default true); unesco_get_biosphere_reserve returns it. Which reserves match, their order, and matched_in are unchanged. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"near": {
"type": "object",
"required": [
"latitude",
"longitude"
],
"properties": {
"latitude": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude of the point, in decimal degrees (−90 to 90)."
},
"longitude": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude of the point, in decimal degrees (−180 to 180)."
},
"radius_km": {
"type": "number",
"default": 100,
"maximum": 5000,
"description": "Search radius in kilometres (up to 5000, default 100).",
"exclusiveMinimum": 0
}
},
"description": "Only reserves within radius_km of this point. Every reserve has coordinates.",
"additionalProperties": false
},
"sids": {
"type": "boolean",
"description": "true: only reserves in Small Island Developing States. false: only reserves elsewhere."
},
"sort": {
"enum": [
"relevance",
"name",
"designated_newest",
"designated_oldest",
"area_largest",
"distance"
],
"type": "string",
"description": "Result order. Default: relevance when query is set, else distance when near is set, else name. relevance needs query; distance needs near. area_largest orders by total recorded area."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 10000,
"minimum": 1,
"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."
},
"query": {
"type": "string",
"maxLength": 200,
"description": "Keywords; every word must match the start of a word in the reserve's name, introduction, or ecological or socio-economic description. 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. For an ecosystem, use a habitat word such as mangrove, wetland, or alpine."
},
"cursor": {
"type": "string",
"maxLength": 1024,
"description": "Opaque continuation cursor from the previous call's next_cursor. Pass it with the same filters and sort to fetch the next page."
},
"region": {
"enum": [
"Africa",
"Arab States",
"Asia and the Pacific",
"Europe and North America",
"Latin America and the Caribbean"
],
"type": "string",
"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). Matches any of a reserve's regions."
},
"country": {
"type": "string",
"maxLength": 64,
"description": "ISO 3166-1 alpha-2 or alpha-3 code, any case (FR, FRA). Matches the reserve's country; a transboundary reserve has one row per participating country. For a country name, look up its code with unesco_list_reference (topic countries)."
},
"designated_to": {
"type": "integer",
"maximum": 2100,
"minimum": 1900,
"description": "Latest designation year, inclusive."
},
"transboundary": {
"type": "boolean",
"description": "true: only transboundary reserves (one row per participating country). false: only single-country reserves."
},
"designated_from": {
"type": "integer",
"maximum": 2100,
"minimum": 1900,
"description": "Earliest designation year, inclusive."
},
"regional_network": {
"enum": [
"African Biosphere Reserve Network (AfriMAB)",
"Arab States Biosphere Reserve Network (ArabMAB)",
"East Asian Biosphere Reserve Network (EABRN)",
"Europe and North America Biosphere Reserve Network (EuroMAB)",
"Ibero-American MAB Network (IberoMAB)",
"South and Central Asia MAB Network (SACAM)",
"Southeast Asian Biosphere Reserve Network (SeaBRnet)"
],
"type": "string",
"description": "MAB regional network, by full name or acronym (AfriMAB, ArabMAB, EABRN, EuroMAB, IberoMAB, SACAM, SeaBRnet), any case. A few reserves belong to no network."
},
"include_description": {
"type": "boolean",
"default": true,
"description": "Set false to leave each row's introduction out of the response (default true); unesco_get_biosphere_reserve returns it. Which reserves match, their order, and matched_in are unchanged."
}
},
"additionalProperties": false
}| string |
| Opaque continuation cursor from the previous call's next_cursor. Pass it with the same filters and sort to fetch the next page. |
| country | string | ISO 3166-1 alpha-2 or alpha-3 code, any case (FR, FRA). Matches every geopark the country takes part in, transnational geoparks included. For a country name, look up its code with unesco_list_reference (topic countries). |
| designated_to | integer | Latest designation year, inclusive. |
| transnational | boolean | true: only geoparks spanning more than one country. false: only single-country geoparks. |
| designated_from | integer | Earliest designation year, inclusive. |
| include_description | boolean | Set false to leave each row's introduction out of the response (default true); unesco_get_geopark returns it. Which geoparks match, their order, and matched_in are unchanged. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"near": {
"type": "object",
"required": [
"latitude",
"longitude"
],
"properties": {
"latitude": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude of the point, in decimal degrees (−90 to 90)."
},
"longitude": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude of the point, in decimal degrees (−180 to 180)."
},
"radius_km": {
"type": "number",
"default": 100,
"maximum": 5000,
"description": "Search radius in kilometres (up to 5000, default 100).",
"exclusiveMinimum": 0
}
},
"description": "Only geoparks within radius_km of this point. Every geopark has one point, which the distance measures.",
"additionalProperties": false
},
"sort": {
"enum": [
"relevance",
"name",
"designated_newest",
"designated_oldest",
"area_largest",
"distance"
],
"type": "string",
"description": "Result order. Default: relevance when query is set, else distance when near is set, else name. relevance needs query; distance needs near. area_largest orders by recorded area."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 10000,
"minimum": 1,
"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."
},
"query": {
"type": "string",
"maxLength": 200,
"description": "Keywords; every word must match the start of a word in the geopark's name, introduction, description, or account of sustaining local communities. 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. For a landform, use a word such as volcanic, karst, or fossil."
},
"cursor": {
"type": "string",
"maxLength": 1024,
"description": "Opaque continuation cursor from the previous call's next_cursor. Pass it with the same filters and sort to fetch the next page."
},
"country": {
"type": "string",
"maxLength": 64,
"description": "ISO 3166-1 alpha-2 or alpha-3 code, any case (FR, FRA). Matches every geopark the country takes part in, transnational geoparks included. For a country name, look up its code with unesco_list_reference (topic countries)."
},
"designated_to": {
"type": "integer",
"maximum": 2100,
"minimum": 1900,
"description": "Latest designation year, inclusive."
},
"transnational": {
"type": "boolean",
"description": "true: only geoparks spanning more than one country. false: only single-country geoparks."
},
"designated_from": {
"type": "integer",
"maximum": 2100,
"minimum": 1900,
"description": "Earliest designation year, inclusive."
},
"include_description": {
"type": "boolean",
"default": true,
"description": "Set false to leave each row's introduction out of the response (default true); unesco_get_geopark returns it. Which geoparks match, their order, and matched_in are unchanged."
}
},
"additionalProperties": false
}| cursor | string | Opaque continuation cursor from the previous call's next_cursor. Pass it with the same filters and sort to fetch the next page. |
| country | string | ISO 3166-1 alpha-2 or alpha-3 code, any case (FR, FRA). Matches every element the country shares, multinational elements included. For a country name, look up its code with unesco_list_reference (topic countries). |
| inscribed_to | integer | Latest inscription year, inclusive. |
| multinational | boolean | true: only elements shared by more than one country. false: only single-country elements. |
| inscribed_from | integer | Earliest inscription year, inclusive. |
| world_heritage_site | string | A World Heritage site's id_no (from unesco_search_sites or unesco_get_site); lists the elements UNESCO links to that site. A number, a digit string, or the site's whc.unesco.org/en/list/{id} page URL. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"list": {
"enum": [
"Representative List",
"Urgent Safeguarding List",
"Register of Good Safeguarding Practices"
],
"type": "string",
"description": "Intangible heritage list: Representative List, Urgent Safeguarding List, or Register of Good Safeguarding Practices (acronyms RL, USL, Art18 accepted)."
},
"sort": {
"enum": [
"relevance",
"name",
"inscribed_newest",
"inscribed_oldest"
],
"type": "string",
"description": "Result order. Default: relevance when query is set, else name. relevance needs query."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 10000,
"minimum": 1,
"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."
},
"query": {
"type": "string",
"maxLength": 200,
"description": "Keywords; every word must match the start of a word in an element's English or French name, its UNESCO concept terms, or its description. 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."
},
"cursor": {
"type": "string",
"maxLength": 1024,
"description": "Opaque continuation cursor from the previous call's next_cursor. Pass it with the same filters and sort to fetch the next page."
},
"country": {
"type": "string",
"maxLength": 64,
"description": "ISO 3166-1 alpha-2 or alpha-3 code, any case (FR, FRA). Matches every element the country shares, multinational elements included. For a country name, look up its code with unesco_list_reference (topic countries)."
},
"inscribed_to": {
"type": "integer",
"maximum": 2100,
"minimum": 1900,
"description": "Latest inscription year, inclusive."
},
"multinational": {
"type": "boolean",
"description": "true: only elements shared by more than one country. false: only single-country elements."
},
"inscribed_from": {
"type": "integer",
"maximum": 2100,
"minimum": 1900,
"description": "Earliest inscription year, inclusive."
},
"world_heritage_site": {
"type": "string",
"pattern": "^[1-9]\\d{0,4}$",
"description": "A World Heritage site's id_no (from unesco_search_sites or unesco_get_site); lists the elements UNESCO links to that site. A number, a digit string, or the site's whc.unesco.org/en/list/{id} page URL."
}
},
"additionalProperties": false
}| cursor | string | Opaque continuation cursor from the previous call's next_cursor. Pass it with the same filters and sort to fetch the next page. |
| region | string | 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). |
| country | string | 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). |
| category | string | Site category: Cultural, Natural, or Mixed. |
| criteria | array | 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. |
| in_danger | boolean | true: only sites on the List of World Heritage in Danger. false: only sites not on it. Omit for both. |
| inscribed_to | integer | Latest inscription year, inclusive. |
| transboundary | boolean | true: only sites shared by more than one State Party. false: only single-State sites. |
| inscribed_from | integer | Earliest inscription year, inclusive. |
| include_description | boolean | Set false to leave each row's description out of the response (default true); unesco_get_site returns it. Which sites match, their order, and matched_in are unchanged. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"near": {
"type": "object",
"required": [
"latitude",
"longitude"
],
"properties": {
"latitude": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude of the point, in decimal degrees (−90 to 90)."
},
"longitude": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude of the point, in decimal degrees (−180 to 180)."
},
"radius_km": {
"type": "number",
"default": 100,
"maximum": 5000,
"description": "Search radius in kilometres (up to 5000, default 100).",
"exclusiveMinimum": 0
}
},
"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.",
"additionalProperties": false
},
"sort": {
"enum": [
"relevance",
"name",
"inscribed_newest",
"inscribed_oldest",
"area_largest",
"danger_listed_newest",
"distance"
],
"type": "string",
"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."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 10000,
"minimum": 1,
"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."
},
"query": {
"type": "string",
"maxLength": 200,
"description": "Keywords; every word must match the start of a word in a site's name (any of six languages), 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."
},
"cursor": {
"type": "string",
"maxLength": 1024,
"description": "Opaque continuation cursor from the previous call's next_cursor. Pass it with the same filters and sort to fetch the next page."
},
"region": {
"enum": [
"Africa",
"Arab States",
"Asia and the Pacific",
"Europe and North America",
"Latin America and the Caribbean"
],
"type": "string",
"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)."
},
"country": {
"type": "string",
"maxLength": 64,
"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)."
},
"category": {
"enum": [
"Cultural",
"Natural",
"Mixed"
],
"type": "string",
"description": "Site category: Cultural, Natural, or Mixed."
},
"criteria": {
"type": "array",
"items": {
"enum": [
"i",
"ii",
"iii",
"iv",
"v",
"vi",
"vii",
"viii",
"ix",
"x"
],
"type": "string",
"description": "A criterion numeral i–x; 1–10 and (iv)-style forms are accepted."
},
"maxItems": 10,
"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."
},
"in_danger": {
"type": "boolean",
"description": "true: only sites on the List of World Heritage in Danger. false: only sites not on it. Omit for both."
},
"inscribed_to": {
"type": "integer",
"maximum": 2100,
"minimum": 1900,
"description": "Latest inscription year, inclusive."
},
"transboundary": {
"type": "boolean",
"description": "true: only sites shared by more than one State Party. false: only single-State sites."
},
"inscribed_from": {
"type": "integer",
"maximum": 2100,
"minimum": 1900,
"description": "Earliest inscription year, inclusive."
},
"include_description": {
"type": "boolean",
"default": true,
"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, and matched_in are unchanged."
}
},
"additionalProperties": false
}