Loading...
Loading...
Private REST API for approved integrations
This API is private. Requests require a valid X-API-Key or an allowlisted IP address. Standard rate limiting still applies.
https://costaricatreeatlas.com/api/v1Send an X-API-Key header issued by the maintainers, or call from an allowlisted IP. Unauthorized requests are rejected with HTTP 401.
100 requests per minute per IP address. Rate limit headers are included in all responses.
X-RateLimit-Limit: Maximum requests per windowX-RateLimit-Remaining: Remaining requestsX-RateLimit-Reset: Unix timestamp when limit resets/api/v1/treesRetrieve a paginated list of trees with optional filtering and sorting.
localestringLanguage code (en, es)familystringFilter by botanical family nameconservationStatusstringFilter by IUCN conservation statustagstringFilter by tagdistributionstringFilter by distribution regionfloweringSeasonstringFilter by flowering monthfruitingSeasonstringFilter by fruiting monthsearchstringSearch in title, scientific name, and descriptionpagenumberPage number (default: 1)pageSizenumberResults per page (default: 20, max: 100)sortstringSort field (title, scientificName, family, updatedAt)orderstringSort order (asc, desc)https://costaricatreeatlas.com/api/v1/trees?locale=en&family=Fabaceae&pageSize=10Try it/api/v1/trees/{slug}Retrieve detailed information about a specific tree by its slug.
slug*stringTree URL sluglocalestringLanguage code (en, es)https://costaricatreeatlas.com/api/v1/trees/guanacaste?locale=enTry it/api/v1/familiesGet all botanical families with species counts.
localestringLanguage code (en, es)https://costaricatreeatlas.com/api/v1/families?locale=enTry it# List all trees
curl "https://costaricatreeatlas.com/api/v1/trees?locale=en"
# Get a specific tree
curl "https://costaricatreeatlas.com/api/v1/trees/guanacaste?locale=en"
# Search for trees
curl "https://costaricatreeatlas.com/api/v1/trees?search=ceiba&locale=en"
# Filter by family
curl "https://costaricatreeatlas.com/api/v1/trees?family=Fabaceae&locale=en"
# Get all families
curl "https://costaricatreeatlas.com/api/v1/families?locale=en"API data is not publicly licensed for open reuse. Usage is restricted to approved internal/partner purposes under the project usage policy.