# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/gemeindebund/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/gemeindebund/get-communities \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/gemeindebund/get-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/gemeindebund/get-landesverbaende \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/gemeindebund/get-news-article \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/gemeindebund/get-news-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/gemeindebund/get-team-members \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/gemeindebund/search-site \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.