@eventer/api-client

TypeScript client for the eventer API — a platform for open event and cultural data built on sempods.

Each organizer maintains a semantic pod with their event data. This client lets you query events from pods and look up venue information.

Install

npm install @eventer/api-client

Quick start

import { eventerApiClient } from '@eventer/api-client'

const response = await eventerApiClient.fetchPodEvents({
  pod: 'aaltra',
  startDateMin: new Date(),
  sort: 'startDate_asc',
  expand: ['image'],
})
response.events.forEach((event) => {
  console.log(`${event.name()} starts at ${event.startDate()}`)
})

Examples

Fetch events modified since a specific date (useful for synchronization):

const response = await eventerApiClient.fetchPodEvents({
  pod: 'aaltra',
  dateModifiedMin: new Date('2026-01-01'),
  sort: 'dateModified_desc',
})

Paginate through all events using next:

let response = await eventerApiClient.fetchPodEvents({
  pod: 'aaltra',
  limit: 10,
})
while (response.graphResponse.next) {
  response = await eventerApiClient.fetchNextPodEvents(response.graphResponse.next)
}

Look up a place by its Google Place ID:

const place = await eventerApiClient.getPlace('ChIJqz9jQFxGp0cRiaEOhbcVxSM')
console.log(`${place.name} — ${place.google_maps_url}`)

References

• API Documentation — OpenAPI specification
• eventer-openapi — the spec source

Release

npm version patch  # or minor/major
npm publish