Фид событий 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": 5838,
    "cities": [
      "Barcelona",
      "Madrid",
      "…"
    ],
    "license": "CC BY 4.0 — attribution 'Come Alone / Meet & Mint'",
    "docs_url": "https://comealone.app/developers/"
  },
  "events": [
    {
      "id": "dd56-brisbane-morning-yoga-drevesen-park-manly",
      "title": "Yoga session at Drevesen Park, Manly, Brisbane",
      "description": "On Sunday 15 November 2026 at 07:30 Drevesen Park in Manly, Brisbane, hosts a yoga class listed in the council's What's on guide under fitness and well-being. The session focuses on a range of movements to relax the mind and body. According to the listing it includes stretching, breathing, strength and balance exercises, worked through by combining standing poses with mat work. The class runs from 07:30 to 08:30 at 83 Lower Esplanade. The meeting point is at the end of Stewart Parade near the rotunda. The listing gives the cost as free and states that no bookings are required. For more information, people can phone John on 0403 676 435. The listing tags the class as suitable for all ages. A morning yoga class like this is easy to join alone, since everyone is focused on their own mat and breathing, and you can simply arrive and start.\n\n«Focus on a range of movements to relax the mind and body.»\n\nStarts 07:30, ends about 08:30. Source: Brisbane City Council events (data.brisbane.qld.gov.au, CC BY 4.0). The listing gives the cost as free, with no bookings required, from 7:30 to 8:30.",
      "start": "2026-11-15T07:30:00+10:00",
      "end": "2026-11-15T08:30:00+10:00",
      "timezone": "Australia/Brisbane",
      "city": "Brisbane",
      "city_slug": "brisbane",
      "country": "Australia",
      "country_code": "AU",
      "venue": "Drevesen Park, Manly",
      "address": null,
      "category": "Outdoors",
      "price": "free",
      "is_free": true,
      "source_url": "https://www.brisbane.qld.gov.au/trumba?trumbaEmbed=view%3Devent%26eventid%3D203638520",
      "organizer": "brisbane.qld.gov.au",
      "cover_url": "https://mm-covers.pages.dev/m/dd56-brisbane-morning-yoga-drevesen-park-manly.webp",
      "languages": null,
      "updated_at": "2026-11-15T21:24:41+00:00",
      "url": "https://comealone.app/#brisbane"
    }
  ]
}

Даты указаны в местном времени события с явным смещением 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 минут.

Сейчас в фиде 5838 событий в 748 городах. Эти цифры меняются, поэтому, когда вам нужно текущее значение, читайте 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`), а не набирайте название города.