World Heritage Datasheets - UNEP-WCMC
Access detailed information about natural and mixed World Heritage Sites from the UNEP-WCMC World Heritage Datasheets database.
Overview
This skill provides access to the UNEP-WCMC World Heritage Datasheets, a comprehensive database containing detailed information about natural and mixed World Heritage Sites worldwide. The datasheets provide authoritative information on site characteristics, conservation values, management, threats, and protection status.
Available Functions
list_sites
List all World Heritage sites in the database.
Parameters: None
Returns:
success: Boolean indicating successcount: Total number of sitessites: Array of site objects with:name: Site nameslug: URL slug for the siteurl: Full URL to the site page
Example:
result = await execute({"function": "list_sites"})
# Returns list of 237+ World Heritage sites
get_site
Get detailed information about a specific World Heritage site.
Parameters:
site_slug(required): URL slug of the site (e.g., 'olympic-national-park')
Returns:
success: Boolean indicating successsite: Object containing:title: Full site nameslug: URL slugurl: Full URLdescription: Site description/statement of significanceinscription_year: Year inscribed on World Heritage Listsections: Dictionary of detailed sections including:- Natural World Heritage Serial Site / Natural World Heritage Site
- Statement of Outstanding Universal Value
- International Designation
- IUCN Management Category
- Biogeographical Province
- Geographical Location
- Dates and History of Establishment
- Land Tenure
- Area
- Altitude
- Physical Features
- Climate
- Vegetation
- Fauna
- Cultural Heritage
- Local Human Population
- Visitors and Visitor Facilities
- Scientific Research and Facilities
- Conservation Value
- Conservation Status and Management
- Management Constraints
- Staff
- Budget
- IUCN Management Category
- Further Reading
Example:
result = await execute({
"function": "get_site",
"site_slug": "olympic-national-park"
})
search
Search for World Heritage sites by keyword.
Parameters:
query(required): Search query string
Returns:
success: Boolean indicating successquery: The search querytotal_count: Total number of matching resultsresults: Array of matching sites with name, slug, and url
Example:
result = await execute({
"function": "search",
"query": "national park"
})
list_countries
List all countries with World Heritage sites and their site counts.
Parameters: None
Returns:
success: Boolean indicating successcount: Total number of countriescountries: Array of country objects with:name: Country namesite_count: Number of World Heritage sites
Example:
result = await execute({"function": "list_countries"})
get_sites_by_country
Get all World Heritage sites for a specific country.
Parameters:
country(required): Country name (case-insensitive, e.g., 'United States of America')
Returns:
success: Boolean indicating successcountry: Country namesite_count: Number of sites in the countrysites: Array of site objects with name, slug, and url
Example:
result = await execute({
"function": "get_sites_by_country",
"country": "United States of America"
})
Data Sources
All data is sourced from:
- Base URL: http://world-heritage-datasheets.unep-wcmc.org/
- Provider: UNEP World Conservation Monitoring Centre (UNEP-WCMC)
- Authority: International Union for Conservation of Nature (IUCN)
Content Coverage
The database includes:
- 237+ natural and mixed World Heritage Sites
- Sites from 90+ countries worldwide
- Comprehensive information on:
- Inscription criteria and history
- Geographic and ecological characteristics
- Conservation values and biodiversity
- Management status and challenges
- Threats and protection measures
Site URL Patterns
Sites can be accessed using their slug in the URL:
http://world-heritage-datasheets.unep-wcmc.org/datasheet/output/site/{site-slug}
Slug format: lowercase, hyphen-separated name (e.g., 'yellowstone-national-park', 'great-barrier-reef')
Error Handling
All functions return consistent error responses:
{
"success": false,
"error": "Error message",
"error_code": "ERROR_CODE"
}
Common error codes:
MISSING_PARAMETER: Required parameter not providedMISSING_FUNCTION: No function specifiedUNKNOWN_FUNCTION: Invalid function nameNOT_FOUND: Requested resource not foundFETCH_ERROR: Network or server error
Rate Limits
Please respect reasonable rate limits (recommended: 2 requests per second) to avoid overloading the server.
Use Cases
- Research: Access detailed conservation and management information for World Heritage Sites
- Planning: Review site characteristics for travel or research planning
- Education: Learn about natural heritage sites worldwide
- Conservation: Monitor conservation status and management constraints
- Comparative Studies: Compare sites across countries and regions