Data feed for apps and AI

For developers

The API in brief. Access with an API key and the full description come with your plan.

Endpoints

GET	`/api/v1/events`Events with place, time, price and status	Events with place, time, price and status
GET	`/api/v1/event-series`Productions with all their dates	Productions with all their dates
GET	`/api/v1/locations`Places with address and opening hours	Places with address and opening hours
GET	`/api/v1/artists`Artists and ensembles	Artists and ensembles
GET	`/api/v1/festivals`Festivals with their dates	Festivals with their dates
GET	`/api/v1/works`Works such as operas or plays	Works such as operas or plays
GET	`/api/v1/search`Search across everything, in whole sentences too	Search across everything, in whole sentences too
GET	`/api/v1/exports/{id}/latest`The latest file of an export	The latest file of an export
POST	`/api/v1/partner/event-series/bulk`Send your own events in bulk	Send your own events in bulk

Filters for events

region: Region, including sub-regions
near, radius: Radius around a point
dateFrom, dateTo: Time span
genreIds: Genres
isFree, isOpenAir, isPremiere: only free, open air or premieres
search, semantic: free search or a whole sentence
lang: one of the ten languages
paginate=cursor: continuous instead of numbered

Access

Every request carries your organisation's key in the X-API-Key header. Every response shows in X-RateLimit-Remaining how much of the allowance is left.

A request

curl "$CIXTRA_API/api/v1/events" \
  -G -d region=graz -d lang=en \
  -d isFree=true \
  -H "X-API-Key: $CIXTRA_KEY"

In detail

What you can ask for

Everything CIXTRA knows, through one interface.

Content: Events, dates, places, artists, festivals, works, genres and regions.
Language: Every answer in one of the ten languages, as you ask.
Page by page: Large result sets come page by page, numbered or continuous.

What an entry carries

Enough to build a view from it right away.

Time and price: Start with time zone, prices and the ticket link.
Status: Whether a date is cancelled, sold out or moved.
Linked: Place, festival, artists, works, genres and images.
Ratings: Nine groups on fixed scales, such as audience, mood and accessibility.

Without querying too

For systems that would rather fetch files or send data in.

Files: If you prefer files, you get the data as XML, JSON, CSV or HTML.
Sending data in: Partners send their own places, events and dates in bulk.

In these products

Incoming Suite

For trains, buses and hotels: what is on nearby right now.

To the product

Custom

API, export, widget, screens and newsletter combined freely.