DondeGo API

API pública para eventos, lugares y noticias de Barcelona y Madrid

DondeGo publica una capa de descubrimiento para que desarrolladores, medios, newsletters, guías locales, productos turísticos y asistentes de IA puedan entender e integrar información estructurada sobre eventos, lugares y noticias culturales de Barcelona y Madrid.

Nuestro objetivo es que la información cultural local no viva solo como páginas web, sino que también pueda ser descubierta, citada y utilizada de forma clara por herramientas técnicas, clientes API y proyectos editoriales.

Ver OpenAPI · Documentación Postman · Repositorio en GitHub

Recursos públicos de descubrimiento

La API de DondeGo cuenta con varios recursos públicos para facilitar su uso por desarrolladores, herramientas de documentación, clientes API y asistentes de inteligencia artificial.

• OpenAPI 3.1: https://dondego.es/openapi.json
• llms.txt: https://dondego.es/llms.txt
• API Catalog linkset: https://dondego.es/.well-known/api-catalog
• JSON de descubrimiento de DondeGo: https://dondego.es/api-catalog.json
• Agent Skills, solo documentación: https://dondego.es/.well-known/agent-skills/index.json
• Documentación pública en Postman: https://documenter.getpostman.com/view/55094507/2sBXwjvZRZ
• Repositorio, ejemplos y colección Postman: https://github.com/revanbcn/DondeGo-API

Qué cubre la versión actual

La primera versión pública es deliberadamente conservadora. Documenta solo las familias de endpoints que hemos verificado y que podemos describir con claridad.

• Ubicaciones
• Eventos y detalle de eventos
• Lugares y detalle de lugares
• Noticias y detalle de noticias
• Eventos del día
• Búsqueda mixta

La especificación OpenAPI v0.1 no intenta cubrir todo lo que podría existir en el futuro. Preferimos publicar una base precisa, útil y verificable antes que una documentación inflada o especulativa.

Ejemplos para desarrolladores

El repositorio público incluye ejemplos de uso para curl, Python y Node, además de una colección de Postman lista para importar.

Ver ejemplos para desarrolladores

Ver colección Postman en GitHub

Uso responsable y atribución

Cualquier web, app, newsletter, bot, asistente de IA o integración de terceros que muestre descripciones de eventos o datos sustanciales de DondeGo debe incluir un enlace visible a la página canónica del evento en DondeGo.es como fuente.

Para renderizar eventos públicamente, recomendamos un flujo detail-first: consultar la lista de eventos, obtener después el detalle del evento y usar EventDetail.site_url como enlace visible a DondeGo.

Esta regla protege el contexto editorial, facilita la verificación por parte del usuario y ayuda a construir un ecosistema de datos más sano.

Para qué puede servir

La API pública de DondeGo puede ser útil para proyectos relacionados con:

• guías culturales y agendas locales
• newsletters sobre ocio, cultura y vida urbana
• mapas y productos turísticos
• aplicaciones de recomendaciones locales
• medios y proyectos editoriales
• asistentes de IA que necesiten una fuente local estructurada
• integraciones para Barcelona y Madrid

Lo que esta API no anuncia

DondeGo no anuncia OAuth/OIDC, MCP, WebMCP ni metadatos de recursos protegidos por OAuth en esta versión. Tampoco documenta filtros de fecha, el parámetro limit ni ejemplos de navegador como capacidades verificadas.

Preferimos publicar metadatos de descubrimiento honestos y verificables antes que prometer compatibilidades que todavía no existen.

Contacto

Si estás construyendo una app local, una guía cultural, una newsletter, un mapa, un producto turístico, un asistente de IA o una integración editorial relacionada con Barcelona o Madrid, podemos hablar.

Contacto para integraciones y colaboraciones: [email protected]