Developer Documentation
Comprehensive mountain and peak reference for mountaineers, hikers, and geography enthusiasts. Covers mountains by continent, country, and range with elevation data, climbing routes, seasonal conditions, summit reports, expedition plans, challenges, interactive tools, glossary, and in-depth guides. 15 languages supported.
- Mountains with elevation, prominence, isolation, coordinates, and first ascent data
- Mountain ranges with member peaks and geographic extent
- Climbing routes with difficulty grade, duration, and technical requirements
- Seasonal conditions per mountain (best months, weather, snow coverage)
- Summit reports — first-person accounts of summiting peaks
- Expedition plans with day-by-day itineraries and logistics
- Mountain challenges — curated lists (Seven Summits, 8000ers, etc.)
- Countries and regions with peak statistics
- Mountain gallery with images
- Side-by-side mountain comparisons
- Interactive tools for planning and analysis
- Mountaineering glossary with categories
- In-depth guides organized by series
Quick Start
curl -s "https://mountainfyi.com/api/v1/mountains/"
API Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/continents/ | Continents |
| GET | /api/v1/countries/ | Countries with peaks |
| GET | /api/v1/regions/ | Regions |
| GET | /api/v1/ranges/ | Mountain ranges |
| GET | /api/v1/mountains/ | All mountains |
| GET | /api/v1/mountains/{slug}/ | Mountain detail |
| GET | /api/v1/routes/ | Climbing routes |
| GET | /api/v1/seasonal-conditions/ | Seasonal conditions |
| GET | /api/v1/faqs/ | FAQs |
| GET | /api/v1/stats/ | Site statistics |
| GET | /api/v1/search/?q={query} | Search across all content |
URL Patterns
Use these patterns to construct URLs programmatically:
/mountains/
Browse all mountains (e.g. /mountains/)
/mountain/{slug}/
Mountain detail (e.g. /mountain/mount-everest/)
/ranges/
Mountain ranges (e.g. /ranges/)
/range/{slug}/
Range detail (e.g. /range/himalayas/)
/continents/
Continents overview (e.g. /continents/)
/continent/{slug}/
Continent detail (e.g. /continent/asia/)
/country/{slug}/
Country mountain detail (e.g. /country/nepal/)
/compare/{slug1}-vs-{slug2}/
Mountain comparison (e.g. /compare/mount-everest-vs-k2/)
/reports/
Summit reports (e.g. /reports/)
/report/{slug}/
Summit report detail (e.g. /report/everest-south-col/)
/expeditions/
Expedition plans (e.g. /expeditions/)
/expedition/{slug}/
Expedition detail (e.g. /expedition/everest-classic/)
/challenges/
Mountain challenges (e.g. /challenges/)
/challenge/{slug}/
Challenge detail (e.g. /challenge/seven-summits/)
/gallery/
Mountain gallery (e.g. /gallery/)
/glossary/
Mountaineering glossary (e.g. /glossary/)
/glossary/{slug}/
Glossary term detail (e.g. /glossary/acclimatization/)
/guides/
In-depth guides (e.g. /guides/)
/guide/{slug}/
Guide detail (e.g. /guide/altitude-sickness/)
/tools/
Interactive tools (e.g. /tools/)
/tool/{slug}/
Tool detail (e.g. /tool/elevation-converter/)
/nearby/
Mountains near me hub (e.g. /nearby/)
/nearby/{mountain-slug}/
Mountains near a specific peak (e.g. /nearby/mount-everest/)
/search/
Search mountains, ranges, glossary (e.g. /search/?q=everest)
Response Format
All endpoints return JSON with pagination:
Example JSON response
{
"count": 636,
"next": "https://example.com/api/v1/items/?page=2",
"previous": null,
"results": [
{"slug": "example", "name": "Example Item", "...": "..."}
]
}
OpenAPI Specification
Full API schema available as OpenAPI 3.1.0 JSON. Import into Swagger UI, Postman, or any OpenAPI-compatible tool.
SDK Packages
PyPI
pip install mountainfyi
Mountains, peaks and elevation data API client
Embed Widget
Embed data cards on your site:
https://widget.mountainfyi.com
npm install mountainfyi-embed
Format Support
- Markdown endpoints: Append
.mdto any page URL for LLM-friendly markdown output. - Internationalization: Content available in 14 languages: ko, ja, zh-hans, es, fr, de, pt, ru, vi, tr, ar, hi, th, id.