# Abconcerts — 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 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-abconcerts-be-api-ed382988/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-abconcerts-be-api-ed382988/get_agenda \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-abconcerts-be-api-ed382988/get_autocomplete \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-abconcerts-be-api-ed382988/get_event_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-abconcerts-be-api-ed382988/get_news_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-abconcerts-be-api-ed382988/get_news_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-abconcerts-be-api-ed382988/search_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```