# Markthalle Hamburg Events API

> Markthalle Hamburg concerts and parties: upcoming shows with dates, line-ups and ticket links

- Vendor: `markthallehamburgeventsapi` · version 1.0 · category Entertainment · tags markthalle hamburg api, hamburg concerts api, concert listings api, live music events api, event calendar api, venue events api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/markthallehamburgeventsapi
- This document: https://apiclay.com/docs/markthallehamburgeventsapi.md
- OpenAPI 3.1: https://apiclay.com/api/markthallehamburgeventsapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `markthallehamburgeventsapi`
- Updated: 2026-11-18

## About

## Markthalle Hamburg Events API

The event calendar of the Markthalle, a concert venue in Hamburg (The Events Calendar plugin on WordPress): upcoming concerts, club nights and comedy shows with start and end time (local and UTC), title, description with line-up, image, ticket link (usually Eventim), category and room (Großer Saal, MarX, Kleiner Saal); one event by id; the rooms; and the event categories.

Data comes from **markthalle-hamburg.de** (https://markthalle-hamburg.de). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/events?per_page=20&amp;page=1`, or narrow with `start_date`, `end_date` and `search`, then `/event?id=`.

### Routes

#### GET `/events` - Events
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| per_page | query | number | no | Events per page (default 5, up to 50). |
| page | query | number | no | Page, from 1. |
| start_date | query | string | no | From this date, `YYYY-MM-DD` (default: today). |
| end_date | query | string | no | Up to this date, `YYYY-MM-DD`. |
| search | query | string | no | Text search in titles and descriptions. |
| categories | query | string | no | Category id or slug from `/categories`. |

Returns: `events` array (`id`, `title`, `description` (HTML), `url`, `image`, `start_date`, `end_date`, `utc_start_date`, `timezone`, `cost`, `website` (ticket link), `categories`, `venue` (room)), plus `total` and `total_pages`. Upcoming events only, earliest first.

#### GET `/event` - Event
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | string | yes | Event `id` from `/events`. |

Returns: one event with the same fields plus `json_ld` (schema.org Event).

#### GET `/venues` - Rooms
No parameters.

Returns: `venues` array: the venue rooms with `id`, `venue` (name), `slug`, `url`.

#### GET `/categories` - Categories
No parameters.

Returns: `categories` array: `id`, `name`, `slug`, `count`.

### Caveats

- Text is in German. Prices are rarely filled in; follow `website` for tickets. Images and descriptions belong to the venue and the artists.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by markthalle-hamburg.de.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /events — Events
- Gateway: `GET https://api.apiclay.com/v1/api/markthallehamburgeventsapi/events`
- Public query params: `per_page` (number), `page` (number), `start_date` (string), `end_date` (string), `search` (string), `categories` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /event — Event
- Gateway: `GET https://api.apiclay.com/v1/api/markthallehamburgeventsapi/event`
- Public query params: `id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /venues — Rooms
- Gateway: `GET https://api.apiclay.com/v1/api/markthallehamburgeventsapi/venues`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /categories — Categories
- Gateway: `GET https://api.apiclay.com/v1/api/markthallehamburgeventsapi/categories`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/markthallehamburgeventsapi/events" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
