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.
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.
Versión v1, estable. Referencia revisada el 13 de noviembre de 2026.
Qué puedes integrar
Cada recurso devuelve el contenido publicado del destino, con todas sus traducciones y sus imágenes optimizadas.
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.
Los eventos vigentes con sus fechas, zona horaria, repetición, categorías y galería. Filtra por fechas y por categoría.
El directorio activo del destino con tipo, etiquetas, horario por días, contacto, redes y fotos. Filtra por tipo, etiqueta o nombre.
Ficha técnica, dificultad, distancia, duración, desnivel, estado abierto o cerrado y puntos de paso. El trazado completo se pide aparte.
El mismo asistente de la guía, con respuesta en directo palabra a palabra. Contesta solo con el contenido publicado del destino.
Una ruta a pie de 30 minutos a 8 horas, con intereses, categorías, punto de partida y opción de silla de ruedas.
Las sub rutas activas del destino, con su color, idiomas y número de paradas. Plan Avanzado.
Suscribe a una persona desde tu web respetando la doble confirmación del destino y el tope de su plan.
Las categorías de la agenda y los tipos y etiquetas de empresas, para montar filtros en tu web.
Referencia
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.
| Ruta | Qué hace | Permiso |
|---|---|---|
| GET/api/v1/pois | Puntos de interés. Con subroute devuelve solo los de una ruta temática. | pois |
| GET/api/v1/events | Agenda vigente. Filtros from, to y category. | pois |
| GET/api/v1/companies | Empresas activas. Filtros type, tag y q. | pois |
| GET/api/v1/hikes | Senderos, de 100 en 100 con limit y offset. Con geometry=full añade el trazado. | pois |
| GET/api/v1/subroutes | Rutas temáticas activas. | pois |
| GET/api/v1/event-categories | Categorías de la agenda. | pois |
| GET/api/v1/company-types | Tipos y etiquetas de empresas. | pois |
| POST/api/v1/chat | Pregunta al asistente. Respuesta en directo por eventos del servidor. | chat |
| POST/api/v1/itinerary | Genera una ruta a pie y devuelve sus paradas en orden. | itinerary |
| POST/api/v1/newsletter/subscribe | Alta de un suscriptor con doble confirmación. | newsletter |
Autenticación
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.
Todo el catálogo de lectura, es decir puntos, agenda, empresas, senderos, rutas temáticas y los dos catálogos de filtros.
El asistente y el generador de itinerarios, cada uno por separado.
El único que escribe. No va por defecto y hay que pedirlo expresamente.
Desde el navegador solo responde a las webs de la lista. De servidor a servidor basta con la clave.
Ejemplos
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
Los cupos son del mes natural y se renuevan el día 1. Los errores llegan siempre como JSON con un campo error.
| Límite | Valor |
|---|---|
| Peticiones por clave | 60 por minuto |
| Preguntas al asistente | 3.000 al mes |
| Itinerarios con intereses | 500 al mes |
| Lecturas de contenido | 10.000 al mes, compartidas entre puntos, agenda, empresas, senderos y catálogos |
| Altas en el boletín | Sin cupo mensual, con el límite por minuto y el tope de suscriptores del plan |
| Código | Cuándo |
|---|---|
| 400 | Parámetro fuera de rango o cuerpo de la petición mal formado |
| 401 | Clave ausente, inválida o revocada |
| 403 | Origen no permitido, permiso que la clave no tiene o recurso que el destino no incluye |
| 404 | Ruta temática que no existe o no está activa |
| 409 | Boletín lleno, el destino ha llegado a su tope de suscriptores |
| 429 | Límite por minuto o cupo del mes superado. Devuelve lo usado y el límite |
Organismos territoriales
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.
| Ruta | Qué devuelve |
|---|---|
| GET/api/v1/territorio | Los municipios activos del organismo. |
| GET/api/v1/territorio/pois | Lugares de todos los municipios, cada uno con el suyo. |
| GET/api/v1/territorio/hikes | Senderos del territorio. Con geometry=full añade el trazado. |
| GET/api/v1/territorio/events | Agenda de todo el territorio desde hoy. |
| GET/api/v1/territorio/companies | Empresas turísticas de todos los municipios. |
| GET/api/v1/territorio/company-types | Tipos de empresa del territorio. |
| GET/api/v1/territorio/event-categories | Categorías de la agenda del territorio. |
Es la interfaz con la que un destino turístico lleva el contenido que gestiona en Visitea a su propia web, a una app o a una pantalla. Devuelve en JSON los puntos de interés, la agenda, las empresas, los senderos y las rutas temáticas, y deja usar desde fuera el asistente, el generador de itinerarios y el alta en el boletín. Lo que se cambia en el panel cambia a la vez en todas partes.
Es un complemento de los planes Completo, Avanzado y Senderismo, con su propia cuota anual, que aparece como Integración del destino en la página de precios. El plan Esencial no la incluye. Cada tipo de destino accede a los recursos de su producto, y un destino de senderismo trabaja con senderos, asistente y boletín.
La entrega Visitea al activar el servicio, con los permisos y las webs de origen que necesites. La clave completa se ve una sola vez. Si se pierde, se crea otra y se revoca la anterior. Un organismo territorial crea sus propias claves desde su panel.
Sí, desde las webs que estén en la lista de orígenes de la clave. Una petición desde otra web se rechaza. Desde un servidor, sin cabecera de origen, basta con la clave. Lo recomendable es no dejar en el navegador una clave con permiso de escritura.
En todos los idiomas activos del destino a la vez, dentro de cada ficha. La respuesta dice cuáles son y cuál es el principal, así que tu web elige el del visitante sin hacer otra petición.
No. Un listado cuenta como una sola llamada, devuelva un elemento o cien. Las llamadas se ven en las estadísticas del panel, en la pestaña Canales, por recurso y por integración, sin datos personales del visitante.
La API responde con el código 429 y lo usado frente al límite hasta el día 1 del mes siguiente. Si un destino se queda corto, el cupo se amplía.
Necesitas el servicio activo, pero no programar. El plugin oficial de WordPress usa esta misma API y la convierte en bloques que se arrastran en el editor.
La misma API convertida en bloques para Gutenberg y Elementor, sin programar.
Leer la páginaGestiona el destino hablando desde ChatGPT, Claude, Gemini o Grok.
Leer la páginaQué apartados pedir, la integración con la web incluida, y cómo comprobar cada requisito.
Leer el artículoLa app nativa parecía la opción premium hace diez años. Hoy es el camino largo, caro y con peor retorno para casi cualquier destino. Aquí están las razones.
Leer el artículoUna ruta inteligente no es una audioguía con app. Es una capa que el visitante recorre solo, con IA, mapa y narración. Aquí están las diferencias reales.
Leer el artículoUn destino puede aprender mucho del visitante sin instalar app, sin pedir login y sin chocar con el RGPD. Aquí está la lista práctica de qué se puede medir y qué se puede deducir.
Leer el artículo