# Gemeindebund — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access comprehensive information about Austrian municipalities, including community details, current news articles, team member profiles, regional associations, and upcoming events. Search across the Gemeindebund.at platform to find specific communities, news updates, and organizational information about Austria's municipal governance.

**Category:** Government & Public Data | **Website:** [gemeindebund.at/](https://gemeindebund.at/) | **Docs:** [parse.bot/marketplace/3b8dc557-11ec-4abc-bc61-83d7726951e1/gemeindebund-at-api](https://parse.bot/marketplace/3b8dc557-11ec-4abc-bc61-83d7726951e1/gemeindebund-at-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-gemeindebund-at-api-3b8dc557/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_communities

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.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-gemeindebund-at-api-3b8dc557/get_communities \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_events

Returns a list of events/Termine from the Gemeindebund calendar. Returns up to 10 events ordered by most recent.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-gemeindebund-at-api-3b8dc557/get_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_landesverbaende

Returns the Austrian regional municipal associations (Landesverbände) with their contact details including email, website, and leadership information.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-gemeindebund-at-api-3b8dc557/get_landesverbaende \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_news_article

Returns the full content and metadata of a single news article. Requires either a post_id or slug to identify the article. If both are provided, post_id takes precedence.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `post_id` | string | No | WordPress post ID of the article (from get_news_list results). |
| `slug` | string | No | URL slug of the article (from get_news_list results). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-gemeindebund-at-api-3b8dc557/get_news_article \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"post_id":"<string>","slug":"<string>"}'
```

### get_news_list

Returns a paginated list of news articles from the Gemeindebund website. Supports keyword search and category filtering. Pagination metadata (total_count, total_pages) is derived from WordPress response headers.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | integer | No | WordPress category ID to filter articles. |
| `page` | integer | No | Page number for pagination. |
| `per_page` | integer | No | Number of results per page. |
| `search` | string | No | Keyword to filter articles by content or title. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-gemeindebund-at-api-3b8dc557/get_news_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<integer>","page":"<integer>","per_page":"<integer>","search":"<string>"}'
```

### get_team_members

Returns the list of Gemeindebund staff members with their names and roles. All members share the general office email.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-gemeindebund-at-api-3b8dc557/get_team_members \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_site

Performs a keyword search across all site posts and returns up to 20 matching results ordered by relevance.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword or phrase. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-gemeindebund-at-api-3b8dc557/search_site \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```
