Фид событий Come Alone

Эндпоинты

Статические файлы, пересобираемые после каждой партии

Всё находится под https://comealone.app/feed/v1/. Файлы генерируются заново, когда мы добавляем события (обычно ежедневно), и кешируются на edge на 30 минут. Включены только предстоящие события — прошедшие выпадают автоматически.

/feed/v1/events.jsonВсе предстоящие события, отсортированные по start, плюс meta (count, cities, license, generated_at, docs_url).
/feed/v1/cities.jsonВсе города со страной, часовым поясом, количеством событий и собственными URL фидов.
/feed/v1/city/<slug>.jsonОдин город. Слаги — строчные ASCII-символы с дефисами: madrid, san-sebastian, new-taipei.
/feed/v1/events.rssRSS 2.0 со всеми предстоящими событиями — название, официальная ссылка, описание, pubDate (= начало), guid, обложка как enclosure.
/feed/v1/city/<slug>.rssRSS по городу. Добавьте его в RSS-ридер или инструмент для рассылок либо поместите в <link rel="alternate">.
/feed/v1/widget.jsГотовый виджет, который выводит ближайшие события города на вашей странице (см. ниже).

Ответы содержат Access-Control-Allow-Origin: * и Cache-Control: public, max-age=1800. Для статических файлов ограничения частоты запросов нет; но всё равно, пожалуйста, кешируйте у себя хотя бы на 15 минут.

Города, где сейчас больше всего событий

Полный список со слагами — в cities.json.

Схема

Одно событие, нормализованное

Каждый фид имеет вид { "meta": {…}, "events": [ … ] }. В meta есть generated_at, count, cities, license и docs_url; фиды городов добавляют city, slug, country и timezone. Поля с пометкой | null у некоторых событий могут отсутствовать.

Поле	Тип	Значение
`id`	string	Стабильный ключ события (а также имя файла обложки). Используйте его для дедупликации.
`title`	string	Название события на английском, написанное нашей командой.
`description`	string \| null	Два-три предложения нашими словами. Никогда не текст организатора.
`start`	string	Местное время начала в ISO 8601 со смещением UTC, например `2026-10-14T17:30:00+02:00`.
`end`	string \| null	Местное время окончания, тот же формат.
`timezone`	string \| null	Пояс IANA, например `Europe/Madrid`. Определяется по городу.
`city`	string	Название города, как на сайте.
`city_slug`	string	Слаг из строчных ASCII-символов; фид города — `/feed/v1/city/{slug}.json`.
`country`	string \| null	Название страны; `country_code` — код ISO 3166-1 alpha-2.
`venue`	string \| null	Площадка или место встречи.
`address`	null	Зарезервировано. Почтовых адресов в текущем наборе данных нет.
`category`	string	Одно из: Music, Culture, Learning, Social, Outdoors, Food and drink, Nightlife, Arts & crafts, Sports.
`price`	string	`"free"`, сумма, найденная в описании (например, `"€2.50"`), или `"low-cost"`. `is_free` — булево значение.
`source_url`	string	Официальная страница организатора. Всегда ставьте на неё ссылку.
`organizer`	string \| null	Имя хоста официальной страницы (например, `barcelona.cat`); имён организаторов в данных пока нет.
`cover_url`	string \| null	Оригинальная иллюстрация, 960×600 WebP, CC BY 4.0, как и остальной фид.
`languages`	string[] \| null	Коды ISO 639-1, если в описании сказано, что событие проходит на определённом языке.
`updated_at`	string	Когда в последний раз изменялся исходный набор данных (UTC).
`url`	string	Страница города с событием на comealone.app.

Пример ответа

{
  "meta": {
    "generated_at": "2026-10-16T14:00:00+00:00",
    "count": 1179,
    "cities": [
      "Barcelona",
      "Madrid",
      "…"
    ],
    "license": "CC BY 4.0 — attribution 'Come Alone / Meet & Mint'",
    "docs_url": "https://comealone.app/developers/"
  },
  "events": [
    {
      "id": "h02-certosa-boari",
      "title": "Guided visit: 20th-century marble sculpture in the Certosa",
      "description": "A field lecture with Marco Marchesini among the sculptures of Bologna's monumental Certosa cemetery, comparing works by Bruno Boari with other 20th-century funerary art. Linked to the Boari exhibition at the Museo civico del Risorgimento. Paid; see the official page.",
      "start": "2026-10-18T10:00:00+02:00",
      "end": "2026-10-18T11:30:00+02:00",
      "timezone": "Europe/Rome",
      "city": "Bologna",
      "city_slug": "bologna",
      "country": "Italy",
      "country_code": "IT",
      "venue": "Cimitero della Certosa di Bologna",
      "address": null,
      "category": "Culture",
      "price": "low-cost",
      "is_free": false,
      "source_url": "https://culturabologna.it/events/569205",
      "organizer": "culturabologna.it",
      "cover_url": "https://mm-covers.pages.dev/m/h02-certosa-boari.webp",
      "languages": null,
      "updated_at": "2026-10-18T18:32:26+00:00",
      "url": "https://comealone.app/#bologna"
    }
  ]
}

Даты указаны в местном времени события с явным смещением UTC, поэтому new Date(e.start) всегда корректен; показывайте их в e.timezone, а не в поясе зрителя, если только вы не задумали иначе.

Быстрый старт

Пара строк — и первое событие

curl + jq

# The feed is free to read — no key, no login
curl -s https://comealone.app/feed/v1/events.json | jq '.events[0:3] | .[] | {title, start, city, source_url}'

# The currently live event count for one city
curl -s https://comealone.app/feed/v1/city/madrid.json | jq '.meta.count'

# Check how fresh the file you got is
curl -s https://comealone.app/feed/v1/events.json | jq '.meta.count, .meta.generated_at'

# RSS
curl -s https://comealone.app/feed/v1/events.rss | head -20

JavaScript (browser / Node 18+)

// JavaScript (browser or Node 18+)
const r = await fetch('https://comealone.app/feed/v1/city/madrid.json');
const { meta, events } = await r.json();
console.log(meta.count, 'events in', meta.city);
for (const e of events.slice(0, 5)) {
  console.log(new Date(e.start).toLocaleString(), e.title, e.venue, e.source_url);
}

Автообнаружение RSS

<link rel="alternate" type="application/rss+xml"
      title="Come Alone — Madrid"
      href="https://comealone.app/feed/v1/city/madrid.rss">

Добавьте фид города в RSS-ридер или инструмент для рассылок либо поместите его в <link rel="alternate">.

Блок указания авторства (скопируйте)

<p>Events by <a href="https://comealone.app/">Come Alone / Meet &amp; Mint</a></p>

Указание авторства для бесплатного тарифа: видимая надпись «Events by Come Alone / Meet & Mint» рядом со списком и ссылка на source_url каждого события. Вот и вся лицензия (CC BY 4.0).

Встраиваемый виджет

Один тег script — и список сегодняшних вечерних событий

Поставьте тег там, где должен появиться список. Он выводит ближайшие события города с миниатюрами обложек, ссылками на официальные страницы и ссылкой «Open in Meet & Mint». Без зависимостей, ~4 КБ, стили ограничены виджетом и используют шрифт вашей страницы.

<script src="https://comealone.app/feed/v1/widget.js"
        data-city="madrid"
        data-limit="5"></script>

Атрибут	По умолчанию	Значение
`data-city`	(все города)	Слаг города из cities.json. Не указывайте для списка по всем городам.
`data-limit`	5	Сколько событий показывать (1–50).
`data-category`	(все)	Только эта категория, например `Music`.
`data-free`	false	`true` показывает только бесплатные события.
`data-theme`	light	`light`, `dark` или `auto` (следует системной теме посетителя).
`data-title`	Go alone in <city>	Текст заголовка; пустая строка скрывает его.
`data-target`	(после скрипта)	CSS-селектор элемента, в который нужно выводить вместо этого.

Вывод в заданный контейнер

<!-- Render into a specific container instead of inline -->
<div id="come-alone-events"></div>
<script src="https://comealone.app/feed/v1/widget.js"
        data-city="helsinki"
        data-limit="8"
        data-free="true"
        data-theme="auto"
        data-target="#come-alone-events"></script>

Живой предпросмотр

Предпросмотр выше — настоящий виджет, который получает данные из собственного фида этого сайта.

Тарифы

Читать — бесплатно, строить — честно

Фид открыт. Платите вы за право использовать его внутри коммерческого продукта, без нашего имени, с поддержкой и стабильной схемой.

Open

€0CC BY 4.0

Личные, общественные, исследовательские и некоммерческие сайты
JSON, RSS и виджет
Указание авторства «Come Alone / Meet & Mint» и ссылка на официальную страницу каждого события
Доступность по мере возможностей (best-effort), схема может меняться с уведомлением на этой странице

Начать

Commercial & white-label

от €49/ месяц

Использование в платных продуктах, приложениях, медиасайтах и городских порталах
Виджет без нашего брендинга, ваши цвета
Закреплённая версия схемы, журнал изменений по e-mail, поддержка в течение 48 часов
Дополнительные поля по запросу (адреса, координаты, ваши категории), приоритет для новых городов

Написать нам

Города, туристические офисы и редакции: скажите нам, какие города и языки вам нужны, и мы настроим фид и подготовим предложение. Контактные данные скоро появятся на этой странице — пока свяжитесь с командой Meet & Mint через meetmint.app.

Хорошие практики

Как пользоваться правильно

Ставьте ссылку на официальную страницу. source_url — это место, где люди регистрируются, проверяют цены и видят изменения в последний момент. Никогда не скрывайте его.
Показывайте время в часовом поясе события. У каждого события есть timezone; концерт в Тайбэе в 19:30 не начинается в 13:30.
Кешируйте на 15–30 минут. Мы пересобираем файлы после каждой партии; edge кеширует на 30 минут. Более частый опрос просто вернёт тот же файл.
Сохраняйте указание авторства. На бесплатном тарифе — «Events by Come Alone / Meet & Mint» со ссылкой на comealone.app, на видном месте рядом со списком.
Используйте id для дедупликации. Он стабилен между пересборками; updated_at сообщает, когда в последний раз менялся набор данных.

Вопросы и ответы

FAQ для разработчиков и небольших партнёров

Что такое фид событий Come Alone и сколько он стоит?

Фид — это все события на comealone.app в виде простого JSON и RSS: отобранные события, на которые можно прийти одному, из открытых городских данных, пересказанные нашими словами, каждое с оригинальной обложкой. Без ключа, без логина, CORS открыт. Он бесплатен для некоммерческого использования с указанием авторства; коммерческие и white-label-тарифы — для продуктов, медиа и городов.

Эндпоинты отвечают без какого-либо ключа или аккаунта и отправляют Access-Control-Allow-Origin: *, поэтому браузерная страница на вашем собственном домене может обращаться к ним напрямую. Для статических файлов ограничения частоты запросов нет; но всё равно, пожалуйста, кешируйте у себя хотя бы на 15 минут.

Сейчас в фиде 1179 событий в 250 городах. Эти цифры меняются, поэтому, когда вам нужно текущее значение, читайте meta.count и meta.generated_at сами.

Тарифов два. Open — €0, CC BY 4.0: личные, общественные, исследовательские и некоммерческие сайты; JSON, RSS и виджет; указание авторства и ссылка на официальную страницу каждого события; доступность по мере возможностей (best-effort), схема может меняться с уведомлением на этой странице. Commercial & white-label — от €49 в месяц: использование в платных продуктах, приложениях, медиасайтах и городских порталах; виджет без нашего брендинга, ваши цвета; закреплённая версия схемы, журнал изменений по e-mail, поддержка в течение 48 часов; дополнительные поля по запросу (адреса, координаты, ваши категории), приоритет для новых городов.

Какая лицензия действует и что нужно сделать, чтобы пользоваться фидом?

Весь фид распространяется под CC BY 4.0. Это указано в собственном поле фида meta.license, где написано: CC BY 4.0 — attribution 'Come Alone / Meet & Mint'. Обложки входят в ту же лицензию: иллюстрации — это оригинальные AI-изображения, созданные Meet & Mint, и они являются частью лицензированного фида.

Указание авторства — это условие лицензии для бесплатного тарифа, а не просьба об одолжении. Вот и вся лицензия (CC BY 4.0).

Учтите, что CC BY 4.0 распространяется на данные фида и обложки. Сама по себе она не даёт права использовать названия Meet & Mint или Come Alone как ваш собственный бренд и не покрывает коммерческий продукт: внутри платного продукта нужен коммерческий тариф (вопрос 1).

Какую именно формулировку указания авторства нужно показывать?

Покажите этот текст на видном месте рядом со списком: Events by Come Alone / Meet & Mint — и вместе с ним дайте ссылку на comealone.app.

Итого две ссылки:

comealone.app рядом со списком (указание авторства).
Официальная страница каждого показываемого события — поле source_url. Это место, где люди регистрируются, проверяют цены и видят изменения в последний момент. Никогда не скрывайте его.

В meta.license фид использует ту же формулировку в другом порядке — attribution 'Come Alone / Meet & Mint'. Для видимой подписи используйте формулировку выше. Готовый HTML — в блоке указания авторства.

Как часто обновляется фид и как часто его стоит опрашивать?

Файлы статические и пересобираются: они генерируются заново, когда мы добавляем события (обычно ежедневно), и кешируются на edge на 30 минут. В файлах только предстоящие события — прошедшие выпадают автоматически.

Кешируйте на 15–30 минут. Мы пересобираем файлы после каждой партии; edge кеширует на 30 минут. Более частый опрос просто вернёт тот же файл.

Каждый ответ фида содержит Cache-Control: public, max-age=1800 (30 минут). Поле meta.generated_at сообщает, когда был собран файл, который у вас на руках. Если вы делаете рассылку или дайджест, запускайте собственную пересборку после того, как изменится эта метка времени, а не по фиксированному ежечасному таймеру.

Можно получить только один город?

Да. Двумя способами:

Фид города: https://comealone.app/feed/v1/city/<slug>.json — один город. Слаги — строчные ASCII-символы с дефисами: madrid, san-sebastian, new-taipei.
RSS города: https://comealone.app/feed/v1/city/<slug>.rss — добавьте его в RSS-ридер или инструмент для рассылок либо поместите в <link rel="alternate">.

Угадывать слаг не нужно. https://comealone.app/feed/v1/cities.json перечисляет все города со страной, часовым поясом, количеством событий и собственными URL фидов, и в каждой записи есть slug, count, free_count, next_start, feed_json, feed_rss и page_url. Виджет принимает тот же слаг в data-city (см. раздел «Виджет» выше).

Сколько событий в нужном городе и сколько из них бесплатных, смотрите в count и free_count в cities.json: эти значения меняются с каждой пересборкой.

Как отфильтровать бесплатные события, категорию или диапазон дат?

Бесплатные события и категория — в виджете: именно это делают атрибуты виджета data-free="true" и data-category="Music" (по умолчанию: data-free false, data-category — все категории). Категории: Music, Culture, Learning, Social, Outdoors, Food and drink, Nightlife, Arts & crafts, Sports — category в точности равно одной из этих строк.

Сырые JSON и RSS эндпоинты не принимают параметров запроса. Документированных ?city=, ?category=, ?from= или ?to= нет. При работе с JSON фильтруете вы сами, по самим полям:

бесплатность: is_free (boolean) — price выражает то же самое строкой: "free", сумма, найденная в описании, например "€2.50", или "low-cost".
категория: category, сравнивайте с точной строкой из списка выше.
даты: start (и end, где он есть) — в формате ISO 8601 со смещением UTC, например 2026-10-14T17:30:00+02:00, поэтому их сравнение безопасно в любом языке. Сам фид уже содержит только предстоящие события.

Параметры диапазона дат не документированы, поэтому исходите из следующего: прочитайте фид и отфильтруйте массив сами. Если вам нужно что-то, чего эндпоинты не предлагают, это тема для разговора с командой Meet & Mint (вопрос 1, коммерческий тариф).

Что умеет виджет и можно ли изменить его оформление?

Один тег script выводит ближайшие события города с миниатюрами обложек, ссылками на официальные страницы и ссылкой «Open in Meet & Mint». Без зависимостей, ~4 КБ, стили ограничены виджетом и используют шрифт вашей страницы. Все атрибуты — в таблице в разделе «Виджет».

Собственные цвета и удаление нашего брендинга — функции коммерческого тарифа: тариф Open получает стандартный виджет, а в тарифе Commercial & white-label указано «виджет без нашего брендинга, ваши цвета». Токены темы и список CSS-переменных не публикуются, поэтому изменение оформления сверх data-theme не документировано.

Есть ли плагин для WordPress или Squarespace?

Плагина от нас нет. Встраивается один HTML-тег script (или URL фида), плагинов или модулей для конкретных CMS нет. Вот как добавить его на распространённые платформы.

Обычный HTML — вставьте это там, где должен появиться список:

<script src="https://comealone.app/feed/v1/widget.js"
        data-city="madrid"
        data-limit="5"></script>

WordPress — используйте блок «Произвольный HTML» (Custom HTML) в блочном редакторе или виджет «Custom HTML» (классические/старые темы); оба сохраняют теги <script>. Для разового размещения в шаблоне страницы добавьте тот же тег в файл шаблона. Избегайте обычного блока «Абзац»: редактор может вырезать тег.

Squarespace — добавьте блок кода (Add Block → Code) в раздел страницы или поместите тег в Settings → Advanced → Code Injection для размещения на всём сайте. Вставьте тег как есть.

Совсем без JavaScript — используйте вместо этого RSS-фид:

<link rel="alternate" type="application/rss+xml"
      title="Come Alone — Madrid"
      href="https://comealone.app/feed/v1/city/madrid.rss">

Каждый ответ фида — это обычный GET с Access-Control-Allow-Origin: *, поэтому статическая страница или серверная задача также могут сами загрузить JSON и вывести список. Шаги для платформ выше описывают стандартное размещение, а не рекомендации производителя CMS.

Чего никогда нет в фиде? Есть ли в нём персональные данные?

Персональных данных нет, и нет никакой информации об участниках. Файлы фида — публичные статические файлы без ключа, без логина и с Access-Control-Allow-Origin: *; в схеме нет поля для имени, e-mail или списка участников.

В фиде нет поля аккаунта, списка гостей и данных о том, «кто идёт». Единственное поле, похожее на человека, — organizer, и это имя хоста официальной страницы (например, nycgovparks.org); имён организаторов в данных пока нет.
address равен null у каждого события в текущем наборе данных: зарезервировано, почтовых адресов в текущем наборе данных нет. Фид даёт площадки и места встречи, а не почтовые адреса.
Описания — это два-три предложения нашими словами, никогда не текст организатора: наш пересказ, а не копия исходной страницы.
О чём нужно знать: описание может приводить контактные данные, которые организатор опубликовал на своей публичной странице — например, e-mail в строке о бронировании. Если вы показываете описания без редактирования, вы показываете и этот e-mail. Относитесь к описаниям как к тексту третьих лиц, сохраняйте указание авторства, а если вам нужна поверхность без персональных данных, фильтруйте или переписывайте описания.

Также в фиде никогда нет:

Полного текста исходной страницы. Описания — наши собственные пересказы.
Почтовых адресов. address зарезервирован и равен null.
Прошедших событий. Старые события выпадают автоматически.
Гарантий цены. price — это «сумма, найденная в описании»; для реальной итоговой суммы источником истины служит официальная страница.

Насколько стабильна схема и что делать, если поле исчезнет?

Версия схемы закреплена как v1 в URL: всё находится под https://comealone.app/feed/v1/. Собственный meta фида это подтверждает (version: "1", docs_url: https://comealone.app/developers/).

Что мы обещаем:

Бесплатный тариф (Open): доступность по мере возможностей (best-effort), схема может меняться с уведомлением на этой странице.
Тариф Commercial & white-label: закреплённая версия схемы, журнал изменений по e-mail.

Поэтому на бесплатном тарифе считайте схему стабильной на практике, но не гарантированной: стройте интеграцию на документированных полях, допускайте неизвестные поля и не ломайтесь, когда необязательного поля нет. Чтобы сделать интеграцию на бесплатном тарифе надёжнее:

Читайте meta.version и meta.docs_url из самих данных, а не предполагайте их.
Проверяйте каждое поле, документированное как | null (end, timezone, venue, description, cover_url, languages, country, organizer).
Используйте в качестве ключа хранения id, стабильный между пересборками, а не позицию в массиве.
Если меняется поле, на которое вы опираетесь, после пересборки проверьте эту страницу (https://comealone.app/developers/) — именно там публикуются уведомления.

Устранение неполадок

Если что-то не работает

Симптом	Причина	Что делать
Пустая область виджета	Тег стоит не там, где должен выводиться список, или контейнер из `data-target` ещё не существует	Поставьте тег `<script>` в то место, где должен появиться список, или добавьте `<div>` перед тегом.
Виджет показывает меньше событий, чем `data-limit`	В этом городе меньше предстоящих событий, чем лимит, или лимит вне диапазона 1–50	Проверьте `count` для города в `cities.json`; `data-limit` принимает только значения 1–50.
У некоторых событий нет какого-то поля	Поля, документированные как `\| null`, необязательны	Проверяйте на `null` поля `end`, `timezone`, `venue`, `description`, `cover_url`, `languages`, `country`, `organizer`. `address` сегодня всегда `null` — он зарезервирован.
Цифры отличаются от вчерашних	Файлы пересобираются по мере добавления событий и выпадения прошедших; кеши живут до 30 минут	Сравнивайте `meta.generated_at`, а не свои часы, и перечитайте эндпоинт.
Время выглядит сдвинутым	Вы вывели `start` в поясе зрителя	Выводите в `timezone` события. Каждый `start` уже содержит своё смещение UTC.
Ваша страница блокирует запрос	Вы проксируете фид через бэкенд, который отбрасывает сторонние запросы	Эндпоинты отправляют `Access-Control-Allow-Origin: *` и не требуют ключа, поэтому прямой `fetch` из браузера работает.
Слаг города возвращает 404	Слаги — строчные ASCII-символы с дефисами, и фид есть только у городов из `cities.json`	Берите слаг из `cities.json` (`san-sebastian`, `new-taipei`), а не набирайте название города.