alpin-api

Every night, this project turns posts from dedicated Alpine ski-resort forum topics into a public GeoJSON map of the latest construction and infrastructure progress.

View the live GeoJSON map

For developers

You can install the alpin_api Python package from PyPI: its forum scrapers, AlpinAPI, data types, and deterministic resort/topic constants. The installed package reads live forum pages. The repository's Groq analysis, map generation, nightly automation, and file-writing application are not included in the published package.

pip install alpin-api

Or add it to a uv project:

uv add alpin-api

Examples

Choose the path that matches what you already know.

If you want updates for one registered resort, fetch recent posts from every topic assigned to its marker:

from alpin_api import AlpinAPI

posts_by_resort = AlpinAPI().fetch_posts(
    resort_ids=["hintertuxer_gletscher"],  # None fetches all registered resorts
    days_old_max=5,
)
hintertux_posts = posts_by_resort["hintertuxer_gletscher"]

If you first want to see what people are discussing on a forum, discover its latest topics:

from alpin_api import AlpinAPI, Forum

api = AlpinAPI()
latest_topics = api.fetch_latest_topics(
    forum=Forum.ALPINFANS,
    topic_limit=20,
)
for topic in latest_topics:
    print(topic.topic_id, topic.title)

Then select an interesting result and fetch its recent posts:

selected_topic = latest_topics[0]
topic_posts = api.fetch_topic_posts(
    forum=selected_topic.forum,
    topic_identifier=selected_topic.topic_id,
    days_old_max=5,
)

Retrieval boundaries

days_old_max is a rolling clock window, so 1 means exactly 24 hours backward. It intentionally reads the newest page and at most the immediately preceding page. topic_limit applies separately to every discovery listing configured for a forum news and construction topics.

Development

Install the locked development environment and the repository's Git hooks:

uv sync --extra tracker
uv run pre-commit install

Run every configured hook with uv run pre-commit run --all-files. Repository-wide coding guidance lives in AGENTS.md.