# MountainFYI

> 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.

## Data Scope
- 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

## URL Patterns
- Append `.md` to any URL for plain-text markdown format.
- i18n: URL prefix `/{lang}` for non-English (ko, ja, zh-hans, es, fr, de, pt, ru, vi, tr, ar, hi, th, id).
- `/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`)

## Mountains & Ranges
- [All Mountains](https://mountainfyi.com/mountains/)
- [Mountain Ranges](https://mountainfyi.com/ranges/)
- [By Continent](https://mountainfyi.com/continents/)
- [Mountain Gallery](https://mountainfyi.com/gallery/)
- [Comparisons](https://mountainfyi.com/compare/)

## Climbing & Expeditions
- [Summit Reports](https://mountainfyi.com/reports/)
- [Expedition Plans](https://mountainfyi.com/expeditions/)
- [Mountain Challenges](https://mountainfyi.com/challenges/)

## Tools & Reference
- [Interactive Tools](https://mountainfyi.com/tools/)
- [Glossary](https://mountainfyi.com/glossary/)
- [Guides](https://mountainfyi.com/guides/)

## Nearby Mountains
- [Mountains Near Me](https://mountainfyi.com/nearby/)

## Embed Widget
- [MountainFYI Widget Docs](https://widget.mountainfyi.com)
- [mountainfyi-embed on npm](https://www.npmjs.com/package/mountainfyi-embed)
- [mountainfyi-embed on GitHub](https://github.com/fyipedia/mountainfyi-embed)

## REST API

Free REST API. No authentication required. JSON responses. CORS enabled.

| 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 |

```bash
curl -s "https://mountainfyi.com/api/v1/mountains/"
```

[API Docs](https://mountainfyi.com/developers/) · [OpenAPI Spec](https://mountainfyi.com/api/openapi.json)

## Developer Tools
- **PyPI**: `pip install mountainfyi` — [mountainfyi](https://pypi.org/project/mountainfyi/) — Mountains, peaks and elevation data API client
- **Embed Widget**: [mountainfyi-embed](https://widget.mountainfyi.com)

## Geo FYI Family

Part of [FYIPedia](https://fyipedia.com) developer tools ecosystem.
- [DistanceFYI](https://distancefyi.com) — Haversine distance, travel times, city pairs
- [QuakeFYI](https://quakefyi.com) — Earthquakes, seismic data, tectonic plates
- [ZipFYI](https://zipfyi.com) — ZIP/postal codes, geocoding, area lookup

## Full Index
- [Full content index](https://mountainfyi.com/llms-full.txt)
- [XML Sitemap](https://mountainfyi.com/sitemap.xml)