Partner-Event-Feed – Anforderungen
Die folgende Spezifikation ist auf Englisch (technische Dokumentation für Partner).
To have your events promoted on visitalex.de (events calendar and, when applicable, on your venue’s page), your data must comply with the following.
Accepted delivery methods
- ICS feed (iCalendar) – A public URL that returns a
.icsfile (calendar feed). We fetch this URL periodically. - JSON feed – A public URL that returns a JSON array of events (see schema below).
- CSV – For partners without a feed: provide a CSV that we can import manually; columns must match the required/optional fields below.
Event schema (canonical shape)
Every event we display is normalized to this shape. Your feed must provide at least the required fields; recommended and optional fields improve display and linking.
Required
| Field | Type | Description |
|---|---|---|
title |
string | Event name. |
start |
string | Start date/time in ISO 8601 (e.g. 2025-02-15T19:00:00 or 2025-02-15T19:00:00+01:00). |
location |
string | Full address or "Venue name, Street, Berlin" so we can match to the Alexanderplatz area. |
url |
string | Link to the event page, ticket shop, or registration. |
Recommended
| Field | Type | Description |
|---|---|---|
end |
string | End date/time in ISO 8601. |
description |
string | Short description (plain text or HTML). |
venue_name |
string | Name of the venue; helps us link the event to a business page on our site. |
Optional
| Field | Type | Description |
|---|---|---|
image |
string | URL of a cover image. |
source_id |
string | Your own event ID (for deduplication or updates). |
We add internally: source (your feed id), and when we can match the event to a known venue, venue_slug (so it appears on that venue’s page).
Area filter
We only list events in and around Alexanderplatz (Berlin). We match events using:
- The address in
location: we keep events whose address contains one of the streets we know in the area. - Optionally the venue name: if it matches a business already listed on our site, we also set the link to that venue’s page.
Please use a clear, consistent address or venue name (e.g. full street name and city) so we can include your events.
ICS feed requirements
If you provide an ICS URL:
- Each event must have at least:
SUMMARY→ maps totitleDTSTART→ maps tostart(we support date-time or date)LOCATION→ maps tolocationURL→ maps tourl
- Recommended:
DTEND,DESCRIPTION.
Example snippet:
BEGIN:VEVENT
SUMMARY:Live Music Night
DTSTART:20250215T190000
DTEND:20250215T230000
LOCATION:Electric Social, Karl-Liebknecht-Straße 9, 10178 Berlin
URL:https://www.electric-social.com/events/123
DESCRIPTION:An evening of live bands.
END:VEVENT
JSON feed requirements
If you provide a JSON URL, the response must be a JSON array of objects. Each object must have the required fields; property names can match the schema above or be mapped by us (if you use different names, tell us).
Example:
[
{
"title": "Live Music Night",
"start": "2025-02-15T19:00:00+01:00",
"end": "2025-02-15T23:00:00+01:00",
"location": "Karl-Liebknecht-Straße 9, 10178 Berlin",
"venue_name": "Electric Social",
"url": "https://www.electric-social.com/events/123",
"description": "An evening of live bands."
}
]
Questions / onboarding
If you want to become a partner and list your events, contact us (see site footer / imprint). We will add your feed URL to our pipeline and ensure your events appear on the calendar and, when applicable, on your venue’s page.