# Abconcerts — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 concert listings and event details from Ancienne Belgique, search for specific shows, and stay updated with the latest news from Belgium's iconic music venue. Find upcoming performances, get complete event information, and discover news articles all in one place.

**Category:** Entertainment | **Website:** [abconcerts.be/](https://abconcerts.be/) | **Docs:** [parse.bot/marketplace/ed382988-e638-42a9-bb28-8f9fa35b1484/abconcerts-be-api](https://parse.bot/marketplace/ed382988-e638-42a9-bb28-8f9fa35b1484/abconcerts-be-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/abconcerts/`
**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 agenda

Fetch upcoming concert and event listings with optional filters. Returns paginated results ordered chronologically. Each event summary includes the main artist, support acts, date, ticket status, and a direct URL suitable for drilling into full details via get_event_detail. Pagination advances via the page parameter; total_pages indicates the last available page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ab_at_night` | string | No | Filter for AB at Night events. Accepted values: 'true', 'false'. |
| `free` | string | No | Filter for free admission events. Accepted values: 'true', 'false'. |
| `genres` | string | No | Comma-separated music genres to filter by (e.g. 'Rock,Pop'). |
| `just_announced` | string | No | Filter for just announced events. Accepted values: 'true', 'false'. |
| `months` | string | No | Comma-separated months in MM-YYYY format to filter by (e.g. '06-2026,07-2026'). |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/abconcerts/get-agenda \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"ab_at_night":"<string>","free":"<string>","genres":"<string>","just_announced":"<string>","months":"<string>","page":"<integer>"}'
```

### Get autocomplete

Get typeahead search suggestions for a partial query. Returns up to approximately 10 matching results from both concerts and news. Each suggestion includes display text, a sort key (timestamp-based for concerts, absent for news), and a URI path that can be used to construct a full URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Typed search query. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/abconcerts/get-autocomplete \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### Get event detail

Fetch full details for a single concert or event by its URL path or full URL. Returns structured artist info, timing schedule, ticket pricing, genres, performer list, and a long-form description. The url field in the response echoes the resolved URL. Returns input_not_found when the event page does not exist (404/410).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL or path of the event page (e.g. 'https://www.abconcerts.be/en/agenda/cabaret-voltaire/a10Qw00000C5Iv5IAF' or '/en/agenda/cabaret-voltaire/a10Qw00000C5Iv5IAF'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/abconcerts/get-event-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### Get news detail

Fetch the full content of a single news article by its URL path or full URL. Returns the article title, date/category metadata line, and full text content. Returns input_not_found for invalid or nonexistent article URLs (404/410).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL or path of the news article page (e.g. 'https://www.abconcerts.be/en/news/discover-the-2025-ab-annual-report/a1eQw000005pVq5IAE' or '/en/news/<article-slug>/<article-id>'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/abconcerts/get-news-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### Get news list

Retrieve a paginated list of news articles and stories in reverse chronological order. Each article summary includes title, publication date, category, a short summary, and a URL suitable for drilling into get_news_detail. Pagination advances via the page parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/abconcerts/get-news-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### Search events

Site-wide keyword search across concerts, series, news, and information pages. Results are grouped by category. Each category array may be empty if no matches exist. Concert hits include date and summary; news hits include metadata (date and category); series and information hits are title+url only. The page parameter allows manual pagination but the total page count is not returned by the site.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search keyword. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/abconcerts/search-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```

## Next steps

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