Gemeindebund APIgemeindebund.at ↗
Access Austrian municipality data, mayor details, news, events, regional associations, and staff from the Gemeindebund.at platform via a structured REST API.
What is the Gemeindebund API?
The Gemeindebund.at API provides access to 7 endpoints covering Austrian municipal data drawn from the official Austrian Association of Municipalities website. The get_communities endpoint alone returns structured records for every Austrian community, including mayor name, salutation, role, state, district, population, and community code. Other endpoints surface news articles, calendar events, team members, regional associations (Landesverbände), and a full-text site search.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/b954a194-173e-4f88-8899-702308ca917f/get_communities' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace gemeindebund-at-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.gemeindebund_at_api import Gemeindebund, Community, ArticleSummary, Article, TeamMember, Association, Event, SearchResult
client = Gemeindebund()
# Search for news about mayors
for result in client.searchresults.search(query="Bürgermeister"):
print(result.title, result.link, result.date)
# List communities and inspect mayor details
for community in client.communities.list(limit=5):
print(community.name, community.state, community.population, community.mayor.full_name)
# Browse paginated news articles and drill into full content
for summary in client.articlesummaries.list(search="Pflege", limit=3):
print(summary.title, summary.date, summary.excerpt)
article = summary.details()
print(article.content, article.author)
# List regional associations
for assoc in client.associations.list():
print(assoc.name, assoc.email, assoc.website)
# List upcoming events
for event in client.events.list():
print(event.title, event.date, event.link)
# List team members
for member in client.teammembers.list():
print(member.name, member.role, member.email)
Returns all Austrian communities with their names, types, mayor details (name, salutation, role), state, district, population, and community code. Data sourced from the official interactive Bürgermeisterkarte. Returns approximately 2092 communities in a single response.
No input parameters required.
{
"type": "object",
"fields": {
"total": "integer total number of communities",
"communities": "array of community objects with keys: name, type, mayor (object with salutation, role, first_name, last_name, full_name), state, district, population, code"
},
"sample": {
"data": {
"total": 2092,
"communities": [
{
"code": 10101,
"name": "Eisenstadt",
"type": "Stadtgemeinde",
"mayor": {
"role": "Bürgermeister",
"full_name": "Thomas STEINER",
"last_name": "STEINER",
"first_name": "Thomas",
"salutation": "Herrn"
},
"state": "Burgenland",
"district": "Eisenstadt(Stadt)",
"population": "16 116"
}
]
},
"status": "success"
}
}About the Gemeindebund API
Community and Leadership Data
The get_communities endpoint returns the full dataset from the Gemeindebund's Bürgermeisterkarte — one record per Austrian community. Each object includes name, type, state, district, population, community_code, and a nested mayor object with salutation, role, first_name, last_name, and full_name. This is the primary reference for pairing community identifiers with current mayoral leadership across all nine Austrian states.
News and Content
get_news_list supports paginated browsing of Gemeindebund news with optional search keyword filtering and category filtering by WordPress category ID. It returns id, title, date, link, excerpt, and slug per article. Pass a slug or post_id from those results to get_news_article to retrieve the full article content as HTML, along with author and link. The search_site endpoint performs a keyword query across all site posts and returns up to 20 results with title, link, and date.
Events and Organizational Structure
get_events returns the Gemeindebund calendar with event id, title, link, date, and slug. get_landesverbaende returns all nine Austrian regional municipal associations, each with name, email, website, and details covering leadership contacts. get_team_members returns Gemeindebund staff with name, role, and email.
Coverage Scope
All endpoints are read-only and require no input parameters except get_news_list (pagination/filter params are optional), get_news_article (needs slug or post_id), and search_site (requires query). Data reflects the Austrian national municipal association's public-facing content, so coverage is Austria-only and limited to what the Gemeindebund publishes.
The Gemeindebund API is a managed, monitored endpoint for gemeindebund.at — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when gemeindebund.at changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official gemeindebund.at API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a searchable directory of Austrian mayors using community name, state, district, and mayor full name from
get_communities. - Monitor Gemeindebund policy news by polling
get_news_listwith category or keyword filters and fetching full text viaget_news_article. - Populate a municipal governance dashboard with population figures and community codes for all Austrian municipalities.
- Aggregate upcoming municipal events from
get_eventsinto a regional government calendar application. - Map regional association contact details from
get_landesverbaendeto build a directory of Landesverbände leadership and websites. - Feed
search_siteresults into an internal knowledge base for Austrian local government research. - Enrich a B2B contact dataset with Gemeindebund staff names, roles, and emails from
get_team_members.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Gemeindebund.at have an official developer API?+
What does get_communities return and can I filter it by state or district?+
Does the API return historical mayor data or past news archives?+
get_news_list and go back as far as the Gemeindebund site publishes, but there is no dedicated archive or date-range filter parameter. You can fork this API on Parse and revise it to add date-range filtering if needed.Does get_news_article return images or attached media from the article?+
content field, along with title, date, author, link, and the WordPress id. Embedded images within the HTML may be present in the content, but there is no dedicated media or image array in the response. You can fork this API on Parse and revise it to parse and expose media fields separately.