Información general

Aprovecha la nueva Merchandising API para identificar ofertas más fácilmente y beneficiarte de las recomendaciones de la máquina learning-powered

La API de Merchandising proporciona acceso directo a los descuentos de los alojamientos de Expedia-sourced, a sus campañas y activos asociados, y a clasificaciones personalizadas de ofertas, destinos y establecimientos basadas en el aprendizaje automático. Utiliza la API de Merchandising para rellenar experiencias de marketing para viajeros o agent-facing, como correos electrónicos promocionales, widgets de aplicaciones, banners de sitios web y experiencias de carrusel, y ejecuta una estrategia de merchandising ganadora en year-long.

También tienes acceso a una sección de Marketing en tu Portal para colaboradores Donde puedes examinar las próximas campañas, exportar listas de ofertas personalizadas, seleccionar el texto y las imágenes de la campaña, y seguir las tendencias de los viajes y el rendimiento de la campaña. Si no ves la sección Marketing en tu Portal, envía un Ticket de asistencia.

Punto final del contenido de la campaña

El punto final de contenido de la campaña proporciona detalles de la próxima campaña, como el ID de la campaña, las fechas de inicio y fin de la reserva y la estancia, y el número de propiedades participantes. Obtendrás acceso directo a los activos de campaña de Expedia-curated, como imágenes temáticas de campaña, imágenes de destino y textos sugeridos, para crear experiencias de merchandising en traveler-facing o agent-facing, incluidos correos electrónicos promocionales, widgets de aplicaciones y banners de sitios web. Además, recibirás información sobre las campañas de ofertas por tiempo limitado (LTO) con una ventana de reserva dentro de los próximos seis meses, así como sobre las campañas evergreen disponibles durante todo el año.

Puedes utilizar el punto final Contenido de la campaña para buscar las próximas campañas utilizando parámetros de solicitud como:

• Intervalo de fechas reservable
• Intervalo de fechas de estancia
• En o por encima de los valores de descuento mínimo
• LTO frente a ofertas perennes

Para las campañas LTO con una ventana de reserva superior a seis meses, se excluirán los siguientes campos:

• Fechas de reserva y de viaje
• % de descuento mínimo y máximo

Otros datos

Puedes utilizar el campo property_count de la respuesta Contenido de la campaña para determinar el número más up-to-date de propiedades que ofrecen ofertas dentro de una campaña. Te recomendamos que consultes property_count cerca de la fecha de inicio de la reserva de la campaña, ya que la participación de los alojamientos en las campañas de merchandising es dinámica y la participación de los alojamientos tiende a ser más completa y fiable a medida que se acerca el lanzamiento de la campaña.

Puedes utilizar los campos min_discount y max_discount de la respuesta Contenido de la campaña para determinar el porcentaje de descuento mínimo y máximo disponible en esa campaña. Por ejemplo, si el mayor descuento ofrecido por una propiedad en esa campaña es del 60%, el valor de max_discount en la respuesta de la API sería 60%, mientras que, si el menor descuento ofrecido por una propiedad en esa campaña es 4%, el campo min_discount sería 4%.

Punto final de promociones

Puedes buscar y filtrar fácilmente la respuesta de Promociones para obtener ofertas más específicas, de modo que tengas un control total sobre las ofertas que muestras a los viajeros. También puedes curar estas ofertas para construir tus propios temas de campaña en lugar de utilizar las campañas de Expedia-defined y los activos asociados.

• Ofrece ofertas y descuentos asociados a una campaña específica.
• Capacidad para buscar y filtrar ofertas con la ayuda de múltiples parámetros de solicitud, incluida la posibilidad de solicitar ofertas para una campaña específica o a través de múltiples campañas.
• Te permite sacar siempre a la superficie las ofertas inmobiliarias más atractivas de up-to-date, para construir una campaña en high-converting.

Puedes utilizar el punto final Promociones para filtrar y buscar fácilmente ofertas utilizando parámetros de solicitud como:

• ID de la campaña y/o ID del alojamiento
• Intervalo de fechas reservable
• Intervalo de fechas de estancia
• En o por encima de los valores de puntuación mínima de las opiniones, puntuación mínima de estrellas y/o descuento mínimo
• Distinción entre tiempo limitado y perenne
• Member-only y mobile-only banderas de trato
• Superregión o destinos específicos
• Orden de clasificación por relevancia del aprendizaje automático

Los siguientes detalles se devolverán en la respuesta de la API de Promociones:

• ID de la promoción, ID de la campaña correspondiente e ID del alojamiento
• Intervalo de fechas reservables, intervalo de fechas de estancia, fechas restringidas y ventana de compra anticipada
• Distinción entre tiempo limitado y perenne
• Máquina learning-powered clasificaciones de relevancia exclusivas para tu negocio para las ofertas, propiedades y destinos devueltos en la respuesta
• Destinos específicos e información de identificación de la cadena
• Enlace tokenizado a la API de contenido de propiedad de Rapid existente para extraer imágenes de property-level y presentarlas en tus experiencias de merchandising

Otros datos

• Si quieres buscar ofertas para una ventana de reserva determinada, puedes pasar valores para las fechas bookable_start y bookable_end. Por ejemplo, pasando 2025-10-15 (15 de octubre de 2025) en el campo bookable_start y pasando 2025-10-30 (30 de octubre de 2025) en el campo bookable_end, recibirás todas las ofertas que se puedan reservar entre el 15 y el 30 de octubre, ambos inclusive. Sin embargo, si quieres ver un conjunto más amplio de ofertas, puedes utilizar bookable_start o bookable_end fecha. Por ejemplo:
  • Pasando 2025-10-15 (15 de octubre de 2025) en el campo bookable_start, recibirás todas las ofertas que se puedan reservar a partir del 15 de octubre. Esto proporcionará un conjunto más amplio de tratos.
  • Con sólo pasar 2025-10-30 (30 de octubre de 2025) en el campo bookable_end, recibirás todas las ofertas que se puedan reservar el 30 de octubre o antes. De nuevo, esto te proporcionará un conjunto más amplio de ofertas.
• Las ofertas se activan (i.e. está disponible para reservar) según la zona horaria del alojamiento. Así, si una oferta comienza el 21 de marzo para una propiedad en Sídney (Australia), se podrá reservar a las 12:01 de la mañana, hora de Sídney, para todos los socios del mundo.
• Puedes utilizar el parámetro de solicitud include en el punto final Promociones para personalizar el tamaño de la respuesta que recibes. Así, en lugar de recibir todos los campos de la respuesta, si sólo necesitas que te devuelvan unos pocos, puedes añadir esos nombres de campo concretos en el parámetro include.
• Puedes empezar a hacer peticiones a la API de promociones con antelación, pero también debes hacerlas lo más cerca posible de la fecha de inicio reservable de la campaña para obtener la representación más precisa y up-to fecha de las ofertas de los alojamientos. Sugerimos aproximadamente dos semanas antes del inicio de la campaña. Esto se debe a que la participación de los alojamientos tiende a ser más completa y fiable a medida que se acerca el lanzamiento de la campaña.
  • También te sugerimos que solicites las promociones unos días después del inicio de la campaña, para que siempre recibas la lista de ofertas más recientes actualizada. Además, te sugerimos que solicites diariamente la API de promociones para obtener una lista actualizada y más reciente de las ofertas proporcionadas por los alojamientos.
• Si estás interesado en crear campañas de merchandising en destination-based, puedes hacer una solicitud a la API de promociones region-specific utilizando la dirección region_id correspondiente de la API de geografía rápida. El único tipo de región aceptado por el punto final de las promociones es city. Otros tipos de región como multi_city_vicinity, point_of_interest, neighbourhood, etc. devolverán una respuesta en blanco.

Recomendaciones de aprendizaje automático

Las clasificaciones de relevancia de la máquina learning-powered entregadas en la respuesta Promociones son exclusivas de cada socio, por lo que las clasificaciones que recibas diferirán de las que reciba cualquier otra persona. Puedes utilizar las recomendaciones del aprendizaje automático para identificar las mejores ofertas, propiedades y destinos que promocionar en tus campañas de merchandising. Higher-scoring ofertas, propiedades y destinos pueden tener una mayor probabilidad de impulsar la conversión entre tu base única de viajeros.

• Actualmente, recibirás clasificaciones de relevancia para las 10.000 mejores ofertas de cada campaña. En nuestras pruebas, descubrimos que el valor y el impacto de este rango eran insignificantes más allá de las primeras 10.000 operaciones.
• En función de tu caso de uso, puedes utilizar el parámetro sort_bypara definir el orden de clasificación de la respuesta Promociones, eligiendo ordenar en función de la relevancia de la oferta, la propiedad o el destino, según determine nuestro modelo de aprendizaje automático, para que obtengas el máximo valor del merchandising en términos de visibilidad y reservas de los viajeros.
  • Si pasas sort_by = promotion, recibirás todos los resultados de acuerdos clasificados en high-to-low (de 1 a 10.000) según nuestro algoritmo propio de aprendizaje automático. Puedes utilizar esta clasificación para obtener las mejores ofertas recomendadas que nuestro modelo espera que conviertan más.
  • Si pasas sort_by = propertyrecibirás todos los resultados de las ofertas de los alojamientos clasificadas en high-to-low según nuestro algoritmo propio de aprendizaje automático.
  • Si pasas sort_by = destinationrecibirás todos los resultados de las ofertas de los destinos clasificados high-to-low según nuestro algoritmo propio de aprendizaje automático.

Nota: Las recomendaciones de aprendizaje automático también están disponibles en Marketing en el Portal. Para más información, ponte en contacto con tu gestor de cuenta.

Cambios realizados en la API de Disponibilidad de Compras

Para obtener los últimos detalles sobre disponibilidad, precios en tiempo real, posibilidad de reembolso, información sobre comisiones, etc., debes hacer una solicitud estándar a la API de compras de Rapid. Hemos realizado los siguientes cambios en la API de Compras para dar soporte a los flujos de merchandising y hacer que tu integración de la API de Merchandising sea lo más fluida posible:

• Utiliza el nuevo filtro dealdisponible en el punto final Disponibilidad de Compras Rápidas para recibir sólo las tarifas que incluyan promociones activas. Esto te da flexibilidad para crear una solicitud de compra con un enfoque exclusivamente de merchandising y asegurarte de que todas las tarifas devueltas tienen un atributodeal.

Nota: Puedes solicitar detalles de la API de Disponibilidad de Compras para un máximo de 250 propiedades a la vez.

Ejemplo de respuesta

"promotions": {
. "deal": {
.   "id": "999abc",
.   "description": "Book early and save 15%"
. }
}

Nota: Los idy descriptiondisponibles en la respuesta de la API de merchandising son diferentes de los devueltos en la respuesta de la API de compras. Te recomendamos encarecidamente que utilices las direcciones idy descriptiondevueltas por la API de merchandising.

Requisitos de lanzamiento

Responsabilidad de cumplimiento

Eres el único responsable de garantizar el cumplimiento de todas las directrices legales y de marketing aplicables cuando realices campañas.

Integridad del contenido

Expedia-provided las imágenes no deben modificarse. Si lo prefieres, puedes utilizar tus propios recursos creativos; sin embargo, eres el único responsable de garantizar el cumplimiento de todas las leyes aplicables sobre derechos de autor y propiedad intelectual.

Detalles de la API

Explora las definiciones de los puntos finales de merchandising-related en esta página y, a continuación, utiliza API Explorer u otro programa de pruebas para saber cómo se comparan los ejemplos y las definiciones de los esquemas con la salida real.

Recursos adicionales

Tanto si lo que quieres es probar todos los puntos de conexión de Rapid API como si quieres descargar las especificaciones de OpenAPI o nuestra colección de Postman, tenemos lo que necesitas.

Ir a API Explorer