API de turismo de Visitea. El contenido de tu destino, en tu web, tu app o tu pantalla.

Lo que tu equipo publica en Visitea, disponible para cualquier sistema. Puntos de interés, agenda, empresas, senderos y rutas en JSON, y el asistente, los itinerarios y el boletín listos para usar desde fuera. Una clave por destino, permisos por recurso y todo en todos los idiomas a la vez.

Se escribe una vez en el panel y aparece en la web municipal, en la app del visitante y en la pantalla de la oficina. Cambias un horario y cambia en todos los sitios a la vez.

Versión v1, estable. Referencia revisada el 13 de noviembre de 2026.

Qué puedes integrar

Todo el destino, por recursos.

Cada recurso devuelve el contenido publicado del destino, con todas sus traducciones y sus imágenes optimizadas.

Puntos de interés.

Textos y traducciones, fotos, coordenadas, audioguía por idioma, vídeo y modelo 3D de cada lugar. Se pueden pedir todos o solo los de una ruta temática.

Agenda de eventos.

Los eventos vigentes con sus fechas, zona horaria, repetición, categorías y galería. Filtra por fechas y por categoría.

Empresas turísticas.

El directorio activo del destino con tipo, etiquetas, horario por días, contacto, redes y fotos. Filtra por tipo, etiqueta o nombre.

Senderos.

Ficha técnica, dificultad, distancia, duración, desnivel, estado abierto o cerrado y puntos de paso. El trazado completo se pide aparte.

Asistente del destino.

El mismo asistente de la guía, con respuesta en directo palabra a palabra. Contesta solo con el contenido publicado del destino.

Itinerarios.

Una ruta a pie de 30 minutos a 8 horas, con intereses, categorías, punto de partida y opción de silla de ruedas.

Rutas temáticas.

Las sub rutas activas del destino, con su color, idiomas y número de paradas. Plan Avanzado.

Alta en el boletín.

Suscribe a una persona desde tu web respetando la doble confirmación del destino y el tope de su plan.

Catálogos para filtros.

Las categorías de la agenda y los tipos y etiquetas de empresas, para montar filtros en tu web.

Referencia

Endpoints de la versión 1.

La dirección base es la del destino, su subdominio de Visitea o su dominio propio. Todas las respuestas son JSON salvo el asistente, que responde en directo. La última columna es el permiso que necesita la clave.

RutaQué hacePermiso
GET/api/v1/poisPuntos de interés. Con subroute devuelve solo los de una ruta temática.pois
GET/api/v1/eventsAgenda vigente. Filtros from, to y category.pois
GET/api/v1/companiesEmpresas activas. Filtros type, tag y q.pois
GET/api/v1/hikesSenderos, de 100 en 100 con limit y offset. Con geometry=full añade el trazado.pois
GET/api/v1/subroutesRutas temáticas activas.pois
GET/api/v1/event-categoriesCategorías de la agenda.pois
GET/api/v1/company-typesTipos y etiquetas de empresas.pois
POST/api/v1/chatPregunta al asistente. Respuesta en directo por eventos del servidor.chat
POST/api/v1/itineraryGenera una ruta a pie y devuelve sus paradas en orden.itinerary
POST/api/v1/newsletter/subscribeAlta de un suscriptor con doble confirmación.newsletter

Autenticación

Una clave por destino, con permisos.

Cada petición lleva la clave en la cabecera Authorization, con el prefijo Bearer. La clave va atada a un destino, a una lista de webs de origen y a unos permisos.

Permiso pois.

Todo el catálogo de lectura, es decir puntos, agenda, empresas, senderos, rutas temáticas y los dos catálogos de filtros.

Permisos chat e itinerary.

El asistente y el generador de itinerarios, cada uno por separado.

Permiso newsletter.

El único que escribe. No va por defecto y hay que pedirlo expresamente.

Orígenes permitidos.

Desde el navegador solo responde a las webs de la lista. De servidor a servidor basta con la clave.

Ejemplos

Así se ve una petición.

Dos ejemplos reales del contrato. Cambia la dirección por la de tu destino y la clave por la tuya.

Leer los puntos de interés desde JavaScript

const respuesta = await fetch('https://tu-destino.visitea.es/api/v1/pois', {
  headers: { Authorization: 'Bearer rtk_tu_clave' },
})
const { tenant, pois } = await respuesta.json()

// tenant.languages  idiomas activos del destino
// pois[0].translations.es.name  nombre del primer lugar en español
// pois[0].audioByLang.en  audioguía en inglés, si la tiene

Pedir un itinerario de hora y media accesible en silla de ruedas

POST https://tu-destino.visitea.es/api/v1/itinerary
Authorization: Bearer rtk_tu_clave
Content-Type: application/json

{
  "timeMinutes": 90,
  "interests": "historia, gastronomía",
  "categories": ["monument", "food"],
  "accessibility": "wheelchair",
  "language": "es"
}

Respuesta

{
  "poiIds": ["catedral", "plaza-mayor", "mirador"],
  "reasoning": "Ruta de 3 paradas, unos 90 minutos a pie",
  "durationMin": 90,
  "warning": null,
  "accessibilityNote": "Ruta adaptada evitando tramos no accesibles."
}

Las paradas llegan por su nombre corto, el mismo de /api/v1/pois, para pintarlas con su ficha completa.

Límites y errores

Cupos incluidos y códigos de respuesta.

Los cupos son del mes natural y se renuevan el día 1. Los errores llegan siempre como JSON con un campo error.

LímiteValor
Peticiones por clave60 por minuto
Preguntas al asistente3.000 al mes
Itinerarios con intereses500 al mes
Lecturas de contenido10.000 al mes, compartidas entre puntos, agenda, empresas, senderos y catálogos
Altas en el boletínSin cupo mensual, con el límite por minuto y el tope de suscriptores del plan
CódigoCuándo
400Parámetro fuera de rango o cuerpo de la petición mal formado
401Clave ausente, inválida o revocada
403Origen no permitido, permiso que la clave no tiene o recurso que el destino no incluye
404Ruta temática que no existe o no está activa
409Boletín lleno, el destino ha llegado a su tope de suscriptores
429Límite por minuto o cupo del mes superado. Devuelve lo usado y el límite

Organismos territoriales

Una API para todo el territorio.

Una diputación, un cabildo o una mancomunidad tiene su propia API con el contenido de todos sus municipios activos, y cada pieza dice de qué municipio viene. Usa claves propias que crea el organismo en su panel, con paginación de hasta 100 elementos, filtro por municipio y por idioma, y 100.000 lecturas al mes por defecto. Lo contamos en organismos territoriales.

RutaQué devuelve
GET/api/v1/territorioLos municipios activos del organismo.
GET/api/v1/territorio/poisLugares de todos los municipios, cada uno con el suyo.
GET/api/v1/territorio/hikesSenderos del territorio. Con geometry=full añade el trazado.
GET/api/v1/territorio/eventsAgenda de todo el territorio desde hoy.
GET/api/v1/territorio/companiesEmpresas turísticas de todos los municipios.
GET/api/v1/territorio/company-typesTipos de empresa del territorio.
GET/api/v1/territorio/event-categoriesCategorías de la agenda del territorio.

Lo que nos suelen preguntar

Para saber más

Para saber más