APIs de Smartvel
para destinos y contenido turístico
Contenido de destino curado y actualizado a diario para inspirar y convertir en tus páginas de destino, emails y apps.
Qué es la API de Smartvel y qué resuelve
La Destination Content API de Smartvel permite a marcas turísticas integrar contenido de destinos, eventos y puntos de interés directamente en sus propios canales digitales. Con ella, tu equipo de producto o marketing puede crear experiencias digitales más ricas, inspiradoras y personalizadas, sin necesidad de desarrollar contenido desde cero.
Gracias a la API, cada cliente puede desarrollar su propia solución «web, app, CRM, chatbot, o microsite» con el soporte técnico y estratégico del equipo de producto de Smartvel, y acceder a documentación clara y ejemplos de uso listos para implementar.
Tipos de APIs
Contamos con diferentes tipos de API diseñadas para cubrir necesidades y objetivos distintos dentro del ecosistema de contenidos de viaje:
Tipos de contenidos disponibles
Casos de uso por sector
OTAs: landings de destino a escala
Crea múltiples páginas de destino con contenido único y relevante sin esfuerzo editorial. Mejora tu posicionamiento orgánico con contenido dinámico y multilenguaje. Enriquece tus páginas de destino y aumenta el tiempo de permanencia en la web y la intención de visita.
Aerolíneas: inspiración y conversión
Utiliza el contenido a lo largo del customer journey, para inspirar con tus destinos y para fidelizarles con qué hacer, dónde comer o qué eventos habrá en destino. Enriquece tus campañas con contenido tematizado. Haz retargeting usando el contenido y los eventos del destino.
Hoteles: guías de barrio
Convierte tu web en una guía local con recomendaciones, eventos cercanos, itinerarios y experiencias. Aprovecha el contenido único para atraer tráfico orgánico. Incrementa las reservas directas y el engagement. La API de Smartvel es una buena opción cuando los widgets no son viables, por ejemplo para tótems de hotel o televisores.
Cruceros: contenido por puertos y experiencias alrededor del viaje
Inspira a tus viajeros antes y después del crucero con ideas sobre qué hacer en las ciudades de embarque y desembarque. Enriquece cada puerto de escala con contenido curado y ofrece consejos prácticos.
DMOs: inspiración y calendario de eventos
Ofrece una agenda viva de eventos y lugares imprescindibles para visitantes y locales. Ten siempre la agenda completa y actualizada.
Historias de éxito y ROI
Numerosas aerolíneas, OTAs y grupos hoteleros ya utilizan la API de Smartvel para mejorar su rendimiento digital. Algunos de los beneficios obtenidos incluyen mayor retención de usuarios, mejora del tráfico orgánico y reducción de costes de contenido. Ejemplos de integraciones de API en clientes:
Integración técnica y rendimiento
La API de Smartvel ha sido diseñada para ofrecer una integración sencilla, segura y altamente personalizable. A través de autenticación mediante API Key y endpoints REST, los desarrolladores pueden acceder a un amplio conjunto de datos actualizados sobre eventos, lugares, restaurantes y regiones, todo ello optimizado para ofrecer un rendimiento ágil gracias a su sistema de caché.
La documentación técnica proporciona ejemplos claros de endpoints, parámetros y respuestas JSON, facilitando la conexión con distintos sistemas y plataformas. Además, la API permite ajustar los resultados por destino, idioma o tipo de contenido, adaptándose a las necesidades específicas de cada mercado o aplicación.
Con un único desarrollo, es posible reutilizar la misma configuración para diferentes marcas, campañas o mercados, integrando la información de Smartvel en widgets, Trip Planner o interfaces personalizadas.
En las siguientes secciones se detallarán los principales endpoints, los tipos de contenido disponibles y los parámetros de personalización que permiten ajustar la información a cada caso de uso.
Autenticación y endpoints
Para realizar solicitudes HTTP a nuestros endpoints, necesitas autenticarte. Para ello, simplemente añade un parámetro llamado key a la solicitud, cuyo valor debe ser la API Key que te proporcionaremos.
Los endpoints están páginados por lo que hay que especificar tanto el tamaño de página como la página que se quiere. Por defecto se devuelven 25 elementos con un máximo de 50. Salvo en regiones, cuya paginación incluye un largo número de elementos por defecto.
La respuesta de los endpoints siguen la siguiente estructura:
{pyth
«count»: 100,
«next»: «https://api.smartvel.com/v4/ENDPOINT?page=3»,
«previous»: «https://api.smartvel.com/v4/ENDPOINT?page=1»,
«results»: [
{
…
}
]
}
Siendo:
- count: número total de elementos disponibles
- next: URL de la siguiente página de resultados
- previous: URL de la página anterior de resultados
- results: array con los resultados del endpoint
Endpoints principales:
- Eventos: datos dinámicos del destino, ordenados por relevancia y que admite distintos filtros como region_id, in_bbox, iata, taxonomies, profile_tags, etc…
- Places: puntos de interés ordenados por relevancia y que admite distintos filtros como region_id, in_bbox, iata, profile_tags, etc…
- Restaurantes: restaurantes ordenados por relevancia y que admite distintos filtros como region_id, in_bbox, iata, profile_tags, score, price_types, etc…
- Regiones: regiones disponibles en la cuenta. Se puede extender con la API de Travel Tips y admite filtros como profile_tags.
Ejemplos de uso
En esta sección se proporcionan distintos ejemplos usando CURL:



curl -X GET «https://api.smartvel.com/v1/events?apikey=YOUR_API_KEY&destination=MADRID&language=es&type=music&from=2025-10-22&to=2025-10-30» -H «accept: application/json»
{
«count»: 775,
«next»: «https://api.smartvel.com/v4/events?ends=2025-12-20&fallback_lang=en&key=API_KEY&lang=en&page=2&page_size=2®ion_id=9694&starts=2025-01-05»,
«previous»: null,
«results»: [
{
«id»: 4371246,
«name»: «Radiohead»,
«description»: «After seven years of absence, the acclaimed British alternative rock band Radiohead begins their new European tour that will stop at the Movistar Arena in Madrid with four concerts scheduled for November 4, 5, 7 and 8. It is the first series of live performances by the British group after a seven-year hiatus.\r\n\r\nThe announcement comes in parallel with the release of the album Hail to the Thief (Live Recordings 2003–2009), a compilation of recordings made during several of their tours at the turn of the century.\r\n\r\nThe band has explained that they resumed rehearsals last year with the intention of reconnecting musically after a long hiatus. This meeting led to the decision to offer a series of live performances, without further confirmation as to whether there will be more dates in the future.\r\n\r\nRadiohead, formed in 1985 in Abingdon-on-Thames, is one of the leading contemporary alternative rock acts, with such iconic albums as OK Computer and Kid A. Her last studio work, A Moon Shaped Pool, was published in 2016. Since then, its members have been involved in different side projects, such as the band The Smile.»,
«place»: {
«id»: 1184482,
«name»: «Movistar Arena»,
«address»: «Felipe II, 28009 Madrid, Spain»,
«location»: {
«type»: «Point»,
«coordinates»: [
-3.671776437996498,
40.42392466234322
]
},
«region»: 9694
},
«external_link»: true,
«starts»: «2025-11-04»,
«ends»: «2025-11-08»,
«public_link»: «http://www.esmadrid.com/agenda/radiohead-movistar-arena»,
«purchase_link»: «https://www.radiohead.com/»,
«taxonomies»: [
{
«id»: 173,
«name»: «Music»,
«slug»: «music»
},
{
«id»: 205,
«name»: «Concert»,
«slug»: «concert»
}
],
«cover»: null,
«cc_photo»: [
{
«id»: 174740,
«title»: «Radiohead | Flickr»,
«author»: «Raph_PH»,
«author_link»: «https://www.flickr.com/photos/raph_ph/»,
«license»: «CC BY 2.0»,
«license_link»: «https://creativecommons.org/licenses/by/2.0/»,
«modifications»: «»,
«path»: «https://www.flickr.com/photos/raph_ph/29730184138/»,
«cc_photo»: «https://cdn.smartvel.com/ccpictures/place/29730184138_931c1d375f_o.jpg»,
«alt_text»: «»,
«picture_type»: «place»
}
],
«video»: null,
«price»: 97.0,
«currency»: «EUR»,
«is_highlight»: true,
«recommendation_weight»: 97,
«recommended_by»: false,
«sessions»: [
{
«starts»: «2025-11-04T00:00:00Z»,
«ends»: «2025-11-08T23:59:00Z»
}
],
«rating»: «»,
«reviews»: «»,
«profile_tags»: [
{
«id»: 24,
«slug»: «music»,
«name»: «Music»
},
{
«id»: 11,
«slug»: «nightlife_and_party»,
«name»: «Nightlife and Party»
}
]
},
{
«id»: 4166765,
«name»: «Calum Scott»,
«description»: «Calum Scott is an English singer and songwriter who rose to prominence after competing on the ITV talent contest Britain’s Got Talent in 2015. He performed his version of Robyn’s hit “Dancing on My Own” which became a huge hit.\r\n\r\nScott is known for his soulful voice and emotional performances. His music is a blend of pop and soul with lyrics that are relatable and heartfelt. He has released several singles and one album, Only Human.\r\n\r\nIf you are a fan of pop or soul music, you should definitely go to Calum Scott’s concert. His live performances are known for their energy and emotional intensity which will leave you feeling inspired and uplifted.»,
«place»: {
«id»: 1126993,
«name»: «Sala la Riviera»,
«address»: «P.º Bajo de la Virgen del Puerto, S/N, Arganzuela, 28005 Madrid, Spain»,
«location»: {
«type»: «Point»,
«coordinates»: [
-3.7221514,
40.4129999
]
},
«region»: 9694
},
«external_link»: true,
«starts»: «2025-10-17»,
«ends»: «2025-10-17»,
«public_link»: «https://www.songkick.com/concerts/42532413-calum-scott-at-la-riviera?2025-10-17-00:00:00»,
«purchase_link»: «https://www.songkick.com/tickets/33121604»,
«taxonomies»: [
{
«id»: 173,
«name»: «Music»,
«slug»: «music»
},
{
«id»: 205,
«name»: «Concert»,
«slug»: «concert»
}
],
«cover»: null,
«cc_photo»: [
{
«id»: 154225,
«title»: «Calum scott»,
«author»: null,
«author_link»: «https://commons.wikimedia.org/wiki/File:2018-05-21_Calum_Scott-9264.jpg»,
«license»: «CC BY-SA 3.0 DE»,
«license_link»: «https://creativecommons.org/licenses/by-sa/3.0/de/deed.en»,
«modifications»: null,
«path»: «»,
«cc_photo»: «https://cdn.smartvel.com/ccpictures/event/calum_scott.jpg»,
«alt_text»: «»,
«picture_type»: «event»
}
],
«video»: null,
«price»: 39.5,
«currency»: «EUR»,
«is_highlight»: false,
«recommendation_weight»: 96,
«recommended_by»: false,
«sessions»: [
{
«starts»: «2025-10-17T00:00:00Z»,
«ends»: «2025-10-17T23:59:00Z»
}
],
«rating»: «»,
«reviews»: «»,
«profile_tags»: [
{
«id»: 24,
«slug»: «music»,
«name»: «Music»
},
{
«id»: 11,
«slug»: «nightlife_and_party»,
«name»: «Nightlife and Party»
}
]
}
]
}

Widgets y Trip Planner
Toda esta información está disponible también mediante nuestro Widget de Planificador de Viajes, una solución sencilla que permite integrar datos de forma rápida y fiable para mejorar la experiencia del usuario en cualquier plataforma, como puedes comprobar fácilmente aquí mismo.
Caché y CDN
Todas las peticiones se almacenan en caché durante horas para que las solicitudes repetidas se respondan casi instantáneamente. Los archivos estáticos, incluidas imágenes, se sirven desde nuestro CDN distribuido con caché adicional para asegurar una respuesta rápida, estable y eficiente.
SEO y conversión: cómo el contenido impulsa tu funnel
El contenido clásico y dinámico de Smartvel mejora las métricas clave que impactan en señales positivas de experiencia de usuario para Google:
- Incremento del tiempo medio en página
- Un mayor número de visitas recurrentes
- Mejora los ratios de conversión
- Aporta entidades relevantes ligadas al contenido
Además, al actualizarse automáticamente, el contenido mantiene las páginas relevantes y vivas, mejorando el SEO semántico y la experiencia de usuario.
+ Contenido relevante → – Coste editorial → ↑ SEO → ↑ Conversión.
FAQ sobre las APIs de Smartvel
¿Qué necesito para integrar la API?
Solo una clave de autenticación y acceso al entorno de pruebas (sandbox).
¿Cada cuánto se actualiza el contenido?
Las actualizaciones son constantes y automáticas o revisadas por el equipo de contenidos. Con cobertura global.
¿Puedo personalizar los contenidos?
Sí, puedes filtrar y mostrar información por tipo de contenido, idioma, mercado o campaña.
¿Cómo garantiza Smartvel la calidad del contenido?
Nuestro sistema combina IA con revisión editorial humana, validando fuentes oficiales y locales.
Precios y planes
El precio de la API depende de variables como número de destinos, idiomas y nivel de personalización. No se factura por volumen de llamadas (API calls). Solicita una demo y nuestro equipo te ayudará a definir el plan que mejor se adapte a tus necesidades.
