Displaying events from Fienta on your own website

Displaying events

You can display all your events from Fienta directly on your own website. With a little programming, you can style and format the list to match your site's design and structure.

Public API

Our public API is organized around REST, returns JSON-encoded responses and uses standard HTTP response codes.

Endpoint

You can retrieve a list of published, non-private upcoming events for a single organiser using this endpoint:

GET https://fienta.com/api/v1/public/events?organizer=<organiser_id>

<locale>
Two lowercase letters indicating the preferred language of the event. Events entered in other languages will still be returned. To retrieve only events in a specific language, add the "locale_strict" parameter to the query.

<organiser_id>
The organiser ID on Fienta. You can find it in the URL when visiting the Settings page.
Example: if your Settings page URL is /my/organizers/1234/edit, your organiser_id is 1234.

Example: Retrieve events from organiser 1234, preferring English language:

GET https://fienta.com/api/v1/public/events?organizer=1234&locale=en

Example: Retrieve only German events from organiser 1234:

GET https://fienta.com/api/v1/public/events?organizer=1234&locale_strict=de

Please see all available parameters from our API documentation.

Response

Example JSON API response:

{"events": [
   {
    "id": 5678,
    "title": "Indie festival",
    "starts_at": "2020-12-16 19:00:00",
    "ends_at": "2020-12-16 21:15:00",
    "duration_string": "Mon 16. December 2020 at 19:00 - 21:15",
    "venue": "Millennium Park",
    "address": "201 E Randolph St, Chicago, IL 60602",
    "description": "An award winning festival weekender which takes place on the outskirts of ..",
    "url": "https:\/\/fienta.com\/indie-festival",
    "buy_tickets_url":"https:\/\/fienta.com\/indie-festival",
    "image_url": "https:\/\/fienta.com\/uploads\/5678.jpg",
    "organizer_name": "Smdith Events Ltd.",
    "organizer_phone": "+81 555 666",
    "organizer_email": "[email protected]",
  },
]}

id
Unique ID of the event.

title
Title of the event.

starts_at, ends_at
The event start and end date and time.

duration_string
A formatted string showing the start and end times.

venue
Name of the venue.

address
Address of the venue, without country name.

description
The event description. This can include HTML.

url
Full URL of the event page on Fienta.

buy_tickets_url
The full URL of the event ticket sales page. If tickets are sold on Fienta, the value is the same as the "url" parameter. If tickets are sold on an external platform, the corresponding URL is returned. If the event does not have ticketing or registration, an empty value is returned.

image_url
URL of the event image.

organizer_name
Name of the organiser.

organizer_phone
Phone number of the organiser.

organizer_email
Email address of the organiser.

JavaScript example

Example of fetching events from Fienta and rendering HTML on your own website using JavaScript and jQuery:

<div id="events">
  <!-- Events will be rendered inside this div -->
</div>

<script src="https://code.jquery.com/jquery-3.4.1.min.js"></script>
<script>
jQuery(document).ready(function() {
  // HTML element which will include event list
  var container = jQuery('#events'); 
  // Pull upcoming events from Fienta
  jQuery.getJSON('https://fienta.com/api/v1/public/events?organizer=1234', function(data) {
    // Cycle through the results
    data.events.forEach(function (event) {
      // Write events into DOM
      container.append(
        '<div>' +
        '<img src="' + event.image_url + '">' +
        '<h2>' + event.title + '</h2>' +
        '<p>' + event.duration_string + ' @ ' + 
        event.venue + ', ' + event.address + '</p>' +
        '<p><a href="' + event.url + '">Buy Ticket</a></p>' +
        '<p>' + event.description + '</p>' +
        '</div>'
      );
    });
  });
});
</script>

<!-- Optionally, embed ticket purchasing process -->
<script src="https://fienta.com/embed.js"></script>