O feed de eventos Come Alone

O feed são todos os eventos da comealone.app, em JSON e RSS simples: eventos selecionados para ir sozinho, a partir de dados abertos das cidades, resumidos por palavras nossas, cada um com uma capa original. Sem chave, sem login, CORS aberto. É gratuito para uso não comercial com atribuição; planos comerciais e white-label para produtos, media e cidades.

Os endpoints respondem sem qualquer chave ou conta e enviam Access-Control-Allow-Origin: *, por isso uma página de browser no seu próprio domínio pode chamá-los diretamente. Não há limite de pedidos para os ficheiros estáticos; ainda assim, guarde em cache do seu lado durante pelo menos 15 minutos.

Neste momento o feed tem 5838 eventos em 748 cidades. Estes números mudam, por isso leia o próprio meta.count e meta.generated_at quando precisar do valor atual.

Há dois planos. Open — €0, CC BY 4.0: sites pessoais, comunitários, de investigação e não comerciais; JSON, RSS e widget; atribuição e uma ligação para a página oficial de cada evento; disponibilidade em regime de melhor esforço (best-effort), o esquema pode mudar com aviso nesta página. Commercial & white-label — desde €49 por mês: utilização em produtos pagos, apps, sites de media e portais de cidades; widget sem a nossa marca, as suas cores; versão de esquema fixada, registo de alterações por e-mail, suporte em 48 horas; campos extra a pedido (moradas, coordenadas, as suas categorias), prioridade para novas cidades.

Cidades, entidades de turismo e redações: digam-nos de que cidades e línguas precisam e nós preparamos um feed e um orçamento. Os contactos estarão nesta página em breve — por agora, contacte a equipa Meet & Mint através de meetmint.app.

Todo o feed está sob CC BY 4.0. O próprio feed indica-o no campo meta.license, que diz: CC BY 4.0 — attribution 'Come Alone / Meet & Mint'. As capas fazem parte da mesma licença: as ilustrações são imagens originais geradas por IA, criadas pela Meet & Mint, e fazem parte do feed licenciado.

A atribuição é a condição da licença no plano gratuito, não um favor que pedimos. Essa é toda a licença (CC BY 4.0).

Note que a CC BY 4.0 abrange os dados do feed e as capas. Por si só, não lhe dá o direito de usar os nomes Meet & Mint ou Come Alone como a sua própria marca, nem cobre um produto comercial: dentro de um produto pago precisa do plano comercial (pergunta 1).

Mostre este texto, de forma visível, junto à lista: Events by Come Alone / Meet & Mint — e, juntamente com ele, uma ligação para comealone.app.

São, portanto, duas ligações:

1. comealone.app junto à lista (a atribuição).
2. A página oficial de cada evento que mostrar — o campo source_url. É onde as pessoas se inscrevem, confirmam preços e veem alterações de última hora. Nunca o esconda.

O feed usa o mesmo texto noutra ordem em meta.license — attribution 'Come Alone / Meet & Mint'. Para o crédito visível, use o texto acima. O HTML pronto está no bloco de atribuição.

Os ficheiros são estáticos e reconstruídos: são regenerados quando acrescentamos eventos (normalmente todos os dias) e ficam em cache durante 30 minutos no edge. Os ficheiros só contêm eventos futuros — os passados saem automaticamente.

Guarde em cache durante 15–30 minutos. Reconstruímos os ficheiros após cada lote; o edge guarda em cache durante 30 minutos. Consultar mais vezes devolve apenas o mesmo ficheiro.

Todas as respostas do feed trazem Cache-Control: public, max-age=1800 (30 minutos). O campo meta.generated_at diz-lhe quando foi gerado o ficheiro que tem em mãos. Se fizer uma newsletter ou um resumo, agende a sua própria reconstrução para depois de essa data e hora mudar, e não com um temporizador fixo de hora a hora.

Sim. De duas formas:

• Feed da cidade: https://comealone.app/feed/v1/city/<slug>.json — uma cidade. Os slugs são ASCII em minúsculas com hífenes: madrid, san-sebastian, new-taipei.
• RSS da cidade: https://comealone.app/feed/v1/city/<slug>.rss — adicione-o a um leitor ou a uma ferramenta de newsletters, ou coloque-o num <link rel="alternate">.

Não precisa de adivinhar o slug. https://comealone.app/feed/v1/cities.json lista todas as cidades com país, fuso horário, contagens de eventos e os respetivos URLs de feed, e cada entrada traz slug, count, free_count, next_start, feed_json, feed_rss e page_url. O widget aceita o mesmo slug em data-city (ver a secção Widget acima).

Quantos eventos tem a cidade que lhe interessa, e quantos são gratuitos, está em count e free_count em cities.json: estes valores mudam a cada reconstrução.

Eventos gratuitos e categoria, no widget: os atributos do widget data-free="true" e data-category="Music" fazem exatamente isso (predefinições: data-free false, data-category todas as categorias). As categorias são Music, Culture, Learning, Social, Outdoors, Food and drink, Nightlife, Arts & crafts, Sports — category é exatamente uma dessas strings.

No JSON ou RSS em bruto, os endpoints não aceitam parâmetros de consulta. Não existe ?city=, ?category=, ?from= ou ?to= documentado. No caminho JSON, a filtragem fica a seu cargo, com base nos próprios campos:

• gratuito: is_free (boolean) — price é a versão em string da mesma informação: "free", um montante encontrado na descrição, como "€2.50", ou "low-cost".
• categoria: category, compare com a string exata acima.
• datas: start (e end, quando existe) estão em ISO 8601 com desvio UTC, p. ex. 2026-10-14T17:30:00+02:00, por isso compará-los é seguro em qualquer linguagem. O próprio feed já contém apenas eventos futuros.

Não há parâmetros de intervalo de datas documentados, por isso proceda assim: leia um feed e filtre o array do seu lado. Se precisar de algo que os endpoints não oferecem, isso é uma conversa a ter com a equipa Meet & Mint (pergunta 1, plano comercial).

Uma única tag script apresenta os próximos eventos de uma cidade com miniaturas das capas, ligações para as páginas oficiais e uma ligação “Open in Meet & Mint”. Sem dependências, ~4 KB, os estilos estão limitados ao widget e seguem o tipo de letra da sua página. Todos os atributos estão na tabela da secção Widget.

Cores personalizadas e remoção da nossa marca são funcionalidades do plano comercial: o plano Open recebe o widget padrão, e o plano Commercial & white-label inclui “widget sem a nossa marca, as suas cores”. Não publicamos tokens de tema nem uma lista de variáveis CSS, por isso alterações de estilo para além de data-theme não estão documentadas.

Não temos plugin. O que incorpora é uma única tag script HTML (ou um URL de feed); não há plugins nem módulos específicos para nenhum CMS. Eis como colocá-lo nas plataformas mais comuns.

HTML simples — cole isto onde a lista deve aparecer:

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

WordPress — use um bloco HTML personalizado (Custom HTML, no editor de blocos) ou o widget “Custom HTML” (temas clássicos/antigos); ambos guardam tags <script>. Para uma colocação pontual num modelo de página, acrescente a mesma tag ao ficheiro do modelo. Evite o bloco Parágrafo simples: o editor pode remover a tag.

Squarespace — adicione um bloco de código (Add Block → Code) à secção da página, ou coloque a tag em Settings → Advanced → Code Injection para a ter em todo o site. Cole a tag tal como está.

Sem JavaScript nenhum — use antes o feed RSS:

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

Todas as respostas do feed são um GET simples com Access-Control-Allow-Origin: *, por isso uma página estática ou uma tarefa do lado do servidor também pode obter o JSON e apresentar a lista por si. Os passos por plataforma acima são uma colocação padrão, não orientações do fornecedor da plataforma.

Não há dados pessoais nem qualquer informação sobre participantes. Os ficheiros do feed são ficheiros estáticos públicos, sem chave, sem login e com Access-Control-Allow-Origin: *; o esquema não tem nenhum campo para um nome, um e-mail ou uma lista de participantes.

• Não existe no feed nenhum campo de conta, nenhuma lista de convidados nem dados de “quem vai”. O único campo com aspeto de pessoa é organizer, e corresponde ao nome do host da página oficial (p. ex. nycgovparks.org); os nomes dos organizadores ainda não estão nos dados.
• address é null em todos os eventos do conjunto de dados atual: reservado, as moradas não estão no conjunto de dados atual. O feed indica locais e pontos de encontro, não moradas.
• As descrições são duas ou três frases por palavras nossas, nunca o texto do organizador — um resumo nosso, não uma cópia da página de origem.
• A ter em conta: uma descrição pode citar um contacto que o organizador publicou na sua própria página pública — por exemplo, um e-mail na linha de reserva. Se mostrar as descrições sem as editar, mostra também esse e-mail. Trate as descrições como texto de terceiros, mantenha a atribuição e, se precisar de uma superfície sem dados pessoais, filtre ou reescreva as descrições.

Também nunca está no feed:

• O texto integral da página de origem. As descrições são resumos nossos.
• Moradas. address está reservado e é null.
• Eventos passados. Os eventos mais antigos saem automaticamente.
• Garantias de preço. price é “um montante encontrado na descrição” — para o valor total real, a fonte de verdade é a página oficial.

A versão do esquema está fixada em v1 no URL: tudo fica em https://comealone.app/feed/v1/. O próprio meta do feed confirma-o (version: "1", docs_url: https://comealone.app/developers/).

O que prometemos:

• Plano gratuito (Open): disponibilidade em regime de melhor esforço (best-effort), o esquema pode mudar com aviso nesta página.
• Plano Commercial & white-label: versão de esquema fixada, registo de alterações por e-mail.

Assim, no plano gratuito, trate o esquema como estável na prática, mas não garantido: construa com base nos campos documentados, tolere campos desconhecidos e não falhe quando um campo opcional estiver ausente. Para tornar mais robusta uma integração no plano gratuito:

1. Leia meta.version e meta.docs_url a partir dos próprios dados, em vez de os presumir.
2. Proteja cada campo documentado como | null (end, timezone, venue, description, cover_url, languages, country, organizer).
3. Use como chave de armazenamento o id, estável entre reconstruções, em vez da posição no array.
4. Consulte esta página (https://comealone.app/developers/) após uma reconstrução se um campo de que depende mudar — é aí que os avisos são dados.