Docs / Event Data API

Event Data API

Concerts, theatre, exhibitions and cinema with geocoded venues, UTC instants for every time, and per-session ticket inventory recorded at every scrape — successive scrapes give you sell-through, not just a snapshot.

Live https://api.softon.dev/v1 v1 · stable

Endpoints

Endpoint	Route	Returns
List events	`GET /v1/events`	collection
Retrieve an event	`GET /v1/events/{id}`	single object
Retrieve a venue	`GET /v1/venues/{id}`	single object

The Event object

The fields below appear on the dataset's primary resource. Endpoint pages list any fields specific to them.

Field	Type	Description
`id`	string	Stable identifier, "<source>:<source id>".
`source`	string	Which scraper produced this event.
`name`	string	Event name as published.
`category`	string · nullable	Category slug: concerts, theatre, exhibitions, sport, cinema.
`venue`	object · nullable	id, name, address, lat, lng. Coordinates where the source geocodes.
`starts_at`	timestamp · nullable	Start time as an RFC 3339 instant in UTC. Convert with the venue's timezone for display — all current venues are Asia/Baku (UTC+4).
`ends_at`	timestamp · nullable	End time in UTC, when the source publishes one.
`price`	object · nullable	min, max and currency across ticket tiers.
`age_limit`	string · nullable	Age restriction as published, e.g. "16+".
`tickets_available`	integer · nullable	Live inventory. null where the source does not expose it — never 0 as a stand-in.
`description`	string · nullable	Editorial copy for the event.
`url`	string · nullable	Canonical page on the source site.
`external_url`	string · nullable	Information or ticketing page. NOT guaranteed to be a purchase link — cinema sources have no dereferenceable buy href.
`poster_url`	string · nullable	Artwork, highest resolution the source offers.
`sessions`	array · nullable	Every individual showing, each with its own price range and inventory. Present on a detail fetch.
`ingested_at`	timestamp	When this version was stored.