Partner event feed requirements
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.