Event Data with Eventfrog: Embedding, Import and API Integration Options
Whether you want to display an event calendar on your own website, import event data into an existing system, or create events directly via an interface: Eventfrog offers several ways to use event data. The right option depends on what you want to achieve, what technical setup is already in place, and how automated the process should be.
Overview:
Which option suits me?
- Show events on your website without programming: iFrame
- Bring public events from Eventfrog into your website, app or event platform, including events by other event organisers: Public API
- Transfer ticket sales, check-ins and payouts for your events to a CRM, BI or accounting tool: Organizer API with read access
- Create events in your own system and add them to Eventfrog automatically: Organizer API with read and write access
You can combine the options, for example create events via the Organizer API and show them on your website with the iFrame. You set up the iFrame yourself in the cockpit. For both APIs, you need programming skills or someone who builds the integration for you.
iFrame: an event calendar on your website
In the cockpit, you will find Embed in the main navigation. There you create a code that you paste into the HTML code of your website. An event calendar then appears on your website.
- By default, the calendar shows your published events. You can add more, for example events by other event organisers, specific categories or locations, and set a time period.
- You can adjust the accent colour to match your website.
- If you like, you can also embed a form that lets visitors to your website add their own events. They need their own Eventfrog account to do this.
Enter the address of your website under Your domain, otherwise the embedding will not work. You do not need an API key.
How to embed the event calendar
Public API: retrieve public event data
The Public API provides all public events on Eventfrog, plus event groups, categories and locations. You can filter by event organiser, location, category, country, radius or time period, for example. You cannot create or change events with it.
Typical uses:
- your own event lists with your own design and filters
- apps, screens or newsletters with current events
- regional or themed event platforms
You need an API key of the type Public API: Read. You will find all details in the Public API specification.
Organizer API: read your event data and create events
The Organizer API covers the events you have created, in the cockpit or via an API key of your account. Depending on the API key, you can only read or also write.
Read only
With an API key of the type Organizer API: Read, you read the data of your events:
- events, event groups and ticket categories
- ticket sales with the ticket buyers’ details and their answers to personalisation fields
- check-ins, seats and entrances
- payouts
This lets you transfer customer data to a CRM, sales and check-in figures to a BI tool, payouts to your accounting or food orders from personalisation fields to a restaurant system, for example.
Read and write
With an API key of the type Organizer API: Read/Write/Delete, you can also create, change, copy and delete events and event groups. This way you enter events only once in your own system, for example in your venue’s CMS or your tour planning. If dates change, the change is transferred automatically.
How an event gets from your system to Eventfrog:
- Your system creates the event via the API. It is a Draft and not yet publicly visible.
- If you sell tickets, set up the ticket categories and ticket sales in the cockpit. This is not possible via the API.
- Publish the event in the cockpit with Publish.
You will find all details in the Organizer API specification.
How to get an API key
You manage your API keys under Settings › API keys. Click Create API key and choose the type your solution needs. For Organizer keys, you confirm the creation in an additional step.
Only share an API key with people who build your integration. A key of the type Organizer API: Read/Write/Delete can change and delete your events. If you no longer need a key, for example after changing agencies, deactivate it in the list with Deactivate API key. This cannot be undone.
How to create and manage API keys
Frequently asked questions
Can I publish events via the Organizer API?
No. With write access, you can create and edit events, but you cannot publish them via the API. Newly created events are always a Draft and therefore not yet publicly visible. Publish them afterwards in the cockpit, in the event concerned, with Publish.
Can I see events by other event organisers with the Organizer API?
No. The Organizer API only shows events you have created. You can retrieve public events by other event organisers with the Public API.