Using the Eventotron API

Eventotron’s API allows festivals and seasons to seamlessly integrate their event data with their own websites or apps. This enables ticket buyers to access real-time information on events, venues, and performances — all pulled directly from your Eventotron database.

Eventotron offers three main integration methods:

1. WordPress Plugin
The quickest and easiest option. Install the plugin on your existing WordPress site, add your API key, and your events, performances and venues are instantly live and searchable. With Super Simple Box Office, ticket sales can also be activated with just one click.

Use this for: Ease and speed.
You will need: A WordPress site and about four minutes to set up.

IMPORTANT: For developers and designers working on behalf of a mutual client please request the plugin via your client in the first instance.

2. Big Dump
Useful for festivals or seasons with custom-built websites. This approach downloads all event and venue data from Eventotron in a single batch at regular intervals. Your website or app is then responsible for presenting, filtering, and searching the data for users.

Use this for: Full control over event presentation, custom search functionality, and integration with other systems.
You will need: A developer, a well-provisioned server, and sufficient time.

3. Live Integration
Your website queries Eventotron in real time, ensuring event data is always current. Eventotron handles searching and filtering, reducing development overhead and keeping data up to date.

Use this for: Real-time integration, staying current, and ease of use.
You will need: A developer, a server, and some time.

 

While the API offers flexibility, we strongly recommend using Super Simple Box Office (SSBO) for ticket sales. SSBO is Eventotron’s fully integrated box office solution, with over 1 million tickets sold. It works seamlessly with your Eventotron data, automatically syncing changes without the need to manually export or reconcile information between different systems.

Using SSBO means:

  • No duplication of data across separate platforms.

  • Artists, venues, and festival / season staff can update event details directly in Eventotron, ensuring your ticket buyers always see the most accurate information.

  • Reduced development costs — changes in Eventotron are instantly reflected on your website, simplifying site management.

  • Flexible options to sell tickets both online and at venues, all managed within Eventotron.

Generating an API Key
Regardless of the integration method you choose, you’ll need an API key to access your festival or season data. API keys are managed via Festival / Season Management Dashboard – Setup → API Keys. For security, generate a separate API key for each external service. This allows you to revoke access if needed without affecting other integrations.

Setting API Output
By default, the API includes event names, performance times, prices, and venue details. To include additional information — such as images, press reviews, or custom questions — navigate to Info Collection in your festival or season management dashboard and set “Appears Online” to “Yes” for the relevant fields. Add an “API Field Name” to ensure consistent naming.

Box Office Integration
Although some third-party box office providers offer their own APIs, using them often means duplicating data, managing separate systems, and losing the rich event detail stored in Eventotron. By contrast, Super Simple Box Office integrates fully with Eventotron, keeping your event information consistent and your ticket sales efficient.

Getting Data Out

Once you’ve configured your output and generated an API key, you can start extracting data from Eventotron.

  • WordPress Plugin: Install the plugin, enter your API key, and import your events with ease.

  • Big Dump and Live Integration: Use the Eventotron API to fetch data in JSON format. To test, paste the relevant URL into your browser, replacing [API KEY HERE] with your key. For better readability, consider installing a JSON viewer plugin.

Key Endpoints:

Season Summary
Returns an overview of your festival, including all events and venues:

https://www.eventotron.com/api/season.php?apikey=[API KEY HERE]

All Events (Big Dump)

Provides details of all events — dates, times, prices, and venue summaries:

https://www.eventotron.com/api/shows.php?apikey=[API KEY HERE]

Updated Shows
Lists Eventotron IDs for shows updated since your last API call:

https://www.eventotron.com/api/showupdates.php?apikey=[API KEY HERE]

Add &test to retrieve sample data.


Single Show

Fetches detailed information for a specific show:

https://www.eventotron.com/api/show.php?apikey=[API KEY HERE]&show_id=[EVENTOTRON EVENT ID HERE]

Venues
Returns detailed information about venues:

https://www.eventotron.com/api/venues.php?apikey=[API KEY HERE]

 

Search Endpoint
Filter events based on any field in your questionnaires, venue info, or performance details. Customize which fields are returned to match your website’s requirements.
Use the Search Endpoint with the Single Show endpoint to achieve a fully live integration — Eventotron handles all searching, filtering, and data delivery.

Please note that use of the Search Endpoint is subject to load restrictions. For access, contact: api@eventotron.com

 

Other useful info:

Images

If you are exposing images in your API, you will not be sent the raw data but, instead, a URL for the image at our CDN. You are free to use these images directly (although this may be subject to extra charges in future).