Información general

Aprovecha la nueva API de merchandising para identificar ofertas más fácilmente y beneficiarte de las recomendaciones basadas en el machine learning-powered

La API de merchandising te da acceso directo a los descuentos de los alojamientos de « Expedia-sourced », a las campañas y recursos asociados, y a clasificaciones personalizadas de ofertas, destinos y establecimientos basadas en el aprendizaje automático. Usa la API de merchandising para crear experiencias de marketing dirigidas a los viajeros o a los usuarios de agent-facing, como correos electrónicos promocionales, widgets de aplicaciones, banners en la web y experiencias de carrusel, y pon en marcha una estrategia de merchandising eficaz en year-long.

Además, tienes acceso a la sección « Marketing » en tu Portal para colaboradores Una cuenta en la que puedes consultar las próximas campañas, exportar listas de ofertas personalizadas, seleccionar los textos e imágenes que quieras usar en las campañas y hacer un seguimiento de las tendencias de viajes y del rendimiento de las campañas. Si no ves la sección « Marketing » en tu portal, envía una Ticket de asistencia.

Punto final del contenido de la campaña

El punto final de contenido de la campaña ofrece detalles sobre las próximas campañas, como el ID de la campaña, las fechas de reserva y de inicio y fin de la estancia, y el número de alojamientos que participan. Tendrás acceso directo a los recursos de la campaña « Expedia-curated », como imágenes temáticas de la campaña, imágenes de los destinos y textos sugeridos, para crear experiencias de merchandising de « traveler-facing » o « agent-facing », incluyendo correos electrónicos promocionales, widgets para aplicaciones y banners para sitios web. Además, recibirás información sobre campañas de ofertas por tiempo limitado (LTO) con un plazo de reserva de hasta seis meses, así como sobre campañas permanentes disponibles durante todo el año.

Puedes usar el punto final «Campaign Content» para buscar las próximas campañas mediante parámetros de solicitud como:

• Periodo de reserva disponible
• Fechas de la estancia
• Igual o superior a los valores del descuento mínimo
• Ofertas LTO frente a ofertas «evergreen»

En el caso de las campañas de LTO con un plazo de reserva superior a seis meses, se excluirán los siguientes campos:

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

Otros detalles

Puedes usar el campo « property_count » de la respuesta «Campaign Content» para averiguar el número más up-to-date de propiedades que ofrecen ofertas dentro de una campaña. Te recomendamos que consultes property_countcuando se acerque la fecha de inicio de la reserva de la campaña, ya que la participación de los alojamientos en las campañas de promoción es dinámica y suele ser más completa y fiable a medida que se acerca el lanzamiento de la campaña.

Puedes usar los campos « min_discount » y « max_discount » de la respuesta «Campaign Content» para determinar el porcentaje mínimo y máximo de descuento disponible en esa campaña. Por ejemplo, si el descuento más alto que ofrece un establecimiento en esa campaña es del 60 %, el valor de « max_discount » en la respuesta de la API sería del 60 %; en cambio, si el descuento más bajo que ofrece un establecimiento en esa campaña es del 4 %, el campo « min_discount » sería del 4 %.

Punto final de promociones

Puedes buscar y filtrar fácilmente los resultados de «Promociones» para encontrar ofertas más específicas, de modo que tengas pleno control sobre las ofertas que les muestras a los viajeros. También puedes seleccionar estas ofertas para crear tus propios temas de campaña, en lugar de usar las campañas de « Expedia-defined » y los recursos asociados.

Con el punto final «Promociones» puedes:

• Buscar ofertas y descuentos relacionados con una campaña concreta
• Busca ofertas y descuentos en , no en, que estén relacionados con una campaña
• Busca y filtra ofertas con la ayuda de varios parámetros de consulta, incluida la posibilidad de solicitar ofertas para una campaña concreta o para varias campañas a la vez
• Encuentra las ofertas inmobiliarias más up-to-date, atractivas para crear una campaña high-converting

Búsqueda y filtrado

Puedes usar el punto final «Promotions» para filtrar y buscar ofertas fácilmente mediante parámetros de solicitud como:

• ID de la campaña y/o ID del alojamiento
• Periodo de reserva disponible
• Fechas de la estancia
• Iguales o superiores a los valores de puntuación mínima de las reseñas, valoración mínima en estrellas y/o descuento mínimo
• La diferencia entre «por tiempo limitado» y «siempre disponible»
• Member-only y las etiquetas de las ofertas de « mobile-only »
• Superregión o destinos concretos
• Orden de clasificación por relevancia del aprendizaje automático

Detalles de la respuesta

En la respuesta de la API de promociones aparecerán los siguientes datos:

• ID de la promoción, ID de la campaña correspondiente e ID del alojamiento
• Periodo de reserva, periodo de estancia, fechas restringidas y plazo de compra anticipada
• La diferencia entre «por tiempo limitado» y «permanente»
• El « learning-powered » automático genera clasificaciones de relevancia específicas para tu negocio en relación con las ofertas, los inmuebles y los destinos que aparecen en la respuesta
• Información sobre destinos concretos e identificadores de cadena
• Enlace tokenizado a la API actual de Rapid Property Content para obtener imágenes de property-level y utilizarlas en tus experiencias de merchandising
• Enlace de «Tokenized Shopping» para realizar una llamada a la API de « deal-specific » y obtener precios y disponibilidad en tiempo real

Otros detalles

• Si quieres buscar ofertas para un periodo de reserva concreto, puedes introducir valores tanto para la fecha de inicio ( bookable_start) como para la fecha de fin ( bookable_end). Por ejemplo, si introduces 2027-10-15 (15 de octubre de 2027) en el campo « bookable_start » y 2027-10-30 (30 de octubre de 2027) 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 una selección más amplia de ofertas, puedes usar bookable_starto bookable_enddate. Por ejemplo:
  • Si introduces «2027-10-15 » (15 de octubre de 2027) en el campo « bookable_start », recibirás todas las ofertas que se puedan reservar a partir del 15 de octubre. Así tendrás una selección más amplia de ofertas.
  • Si solo introduces «2027-10-30 » (30 de octubre de 2027) en el campo « bookable_end », recibirás todas las ofertas que se puedan reservar hasta el 30 de octubre, incluido ese día. Una vez más, esto te dará un abanico más amplio de ofertas.
• Las ofertas se activan (i.e. ) y se pueden reservar según la zona horaria del alojamiento. Así que, si una oferta para una propiedad en Sídney (Australia) empieza el 21 de marzo, estará disponible para reservar a las 00:01, hora de Sídney, para todos los socios del mundo.
• Puedes usar el parámetro de solicitud « include » en el punto final «Promotions» para personalizar el tamaño de la respuesta que recibes. Así que, en lugar de recibir todos los campos de la respuesta, si solo necesitas que se devuelvan unos cuantos, puedes añadir los nombres de esos campos concretos en el parámetro « include ».
• Las ofertas (no) relacionadas con una campaña tienen el mismo aspecto que las ofertas relacionadas con una campaña, pero con algunas diferencias clave:
  • Las ofertas que no forman parte de una campaña no tienen un ID de campaña asociado.
  • La mayoría tiene un descuento mínimo del 10 % y la fecha límite para reservar es en 2079. Las ofertas cuya fecha de finalización de la reserva sea en 2079 se consideran de duración indefinida, mientras que aquellas con fechas de reserva anteriores a 2079 se consideran ofertas por tiempo limitado.
• Puedes empezar a enviar solicitudes a la API de promociones con antelación, pero también deberías enviarlas lo más cerca posible de la fecha de inicio de la campaña en la que se pueden reservar las ofertas, para que la información sobre las ofertas de los alojamientos sea lo más precisa y up-to posible. Te recomendamos que lo hagas unas dos semanas antes de que empiece la campaña. Esto se debe a que la participación de los inmuebles suele ser más completa y fiable a medida que se acerca el lanzamiento de la campaña.
  • También te recomendamos que solicites las promociones unos días después de que empiece la campaña, para que siempre tengas la lista de ofertas más reciente y actualizada. Además, te recomendamos que consultes a diario la API de promociones para obtener una lista actualizada y con las últimas ofertas de los alojamientos.
• Si te interesa crear campañas de merchandising de « destination-based », puedes enviar una solicitud a la API de promociones de « region-specific » utilizando el « region_id » correspondiente de la API de Rapid Geography. El único tipo de región que admite el punto final de promociones es city. Otros tipos de regiones, como multi_city_vicinity, point_of_interest, neighbourhood, etc., devolverán una respuesta vacía.

API de disponibilidad de productos

Si quieres conocer en tiempo real la disponibilidad, los precios, las condiciones de reembolso y los detalles de las comisiones de un alojamiento promocionado, el siguiente paso es llamar a la API de disponibilidad de Rapid Shopping.

Cada respuesta a una promoción incluye un enlace a la tienda con información esencial sobre las ofertas y los datos de los inmuebles, y es único para cada oferta. El token de enlace a la tienda facilita el paso de descubrir una promoción a comprar.

Ejemplo de respuesta sobre promociones

[
  {
    "promotion_id": "123456",
    "campaign_id": "12345",
    "property_id": "123456",
    ...
    "links": {
      "content": {
        "method": "GET",
        "href": "/v3/properties/content?property_id=123456&language=en-US&supply_source=expedia"
      },
      "shop": {
        "method": "GET",
        "href": "/v3/properties/availability?token=XFleAkNUU1YKACg5HcAtdVw8SQVUPUApTAF0CAApdBg==",
        "required_parameters": [
          "checkin",
          "checkout",
          "currency",
          "country_code",
          "occupancy",
          "rate_plan_count",
          "sales_channel",
          "sales_environment"
        ]
      }
    }
  }
]

Cuando elijas una oferta para promocionar, solo tienes que usar el token del enlace de la tienda para hacer una llamada a la API de disponibilidad con los parámetros necesarios. La respuesta de la API de disponibilidad te mostrará entonces toda la información habitual sobre la oferta que hayas elegido, lo que te permitirá realizar una llamada específica a la API de deal-specific Shopping de forma automatizada. Con este token, tienes la flexibilidad de seguir buscando otras propiedades en la misma solicitud de la API de Shopping (se sigue aplicando el límite habitual de un total de 250 propiedades por cada llamada a Shopping), lo que te permite ampliar aún más tu búsqueda en Shopping.

Cuando realices varias solicitudes a la API de disponibilidad, te pedimos que utilices el token del enlace de la tienda en cada una de las llamadas. Cada vez que haces una solicitud a la API de Promociones, se genera un nuevo token para cada uno de los enlaces de la tienda. Esto se debe a que cada token es único y se puede rastrear hasta una llamada concreta a la API de Promociones. Así que, si actualizas a diario los datos de «Promociones», es importante que utilices el último token generado.

Ejemplo de solicitud a la API de compras utilizando el token

curl -X GET "https://test.ean.com/v3/properties/availability\
?token=XFleAkNUU1YKACg5HcAtdVw8SQVUPUApTAF0CAApdBg==\
&checkin=2026-06-01\
&checkout=2026-06-03\
&currency=USD\
&country_code=US\
&occupancy=2\
&rate_plan_count=1\
&sales_channel=website\
&sales_environment=hotel_only" \
 -H "accept: application/json"\
 -H "accept-encoding: gzip"\
 -H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1697664047"\
 -H "user-agent: TravelNow/3.30.112"

Además, usa el nuevo filtro « deal » (Solo ofertas activas), disponible en el punto final «Rapid Shopping Availability», para recibir únicamente tarifas que incluyan promociones activas. Esto te da la flexibilidad de crear una solicitud de compras centrada exclusivamente en el merchandising y asegurarte de que todas las tarifas que se devuelvan tengan el atributo « deal ».

Ejemplo de respuesta

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

Nota: Los campos « id » y « description » que aparecen en la respuesta de la API de Merchandising son distintos de los que se devuelven en la respuesta de la API de Shopping. Te recomendamos encarecidamente que utilices los valores « id » y « description » que te devuelve la API de merchandising.

Recomendaciones basadas en el aprendizaje automático

Las clasificaciones de relevancia generadas por el sistema « learning-powered » que aparecen en la respuesta de «Promociones» son únicas para cada socio, así que las clasificaciones que recibas serán diferentes a las que reciba cualquier otra persona. Puedes usar las recomendaciones del aprendizaje automático para identificar las mejores ofertas, propiedades y destinos que promocionar en tus campañas de merchandising. Higher-scoring Las ofertas, los alojamientos y los destinos pueden tener más posibilidades de generar reservas entre tu base de viajeros habituales.

• Ahora mismo, recibirás clasificaciones por relevancia de las 10 000 mejores ofertas. En nuestras pruebas, nos dimos cuenta de que el valor y el impacto de esta clasificación se volvían insignificantes a partir de las primeras 10 000 operaciones.
• Según tu caso de uso, puedes utilizar el parámetro « sort_by » para definir el orden de clasificación de la respuesta de «Promociones», eligiendo ordenar según la relevancia de la oferta, el alojamiento o el destino, tal y como determina nuestro modelo de aprendizaje automático, para que saques el máximo partido a la comercialización en cuanto a visibilidad y reservas de los viajeros.
  • Si pasas sort_by = promotion, recibirás todos los resultados de las ofertas ordenados high-to-low (del 1 al 10 000) según nuestro algoritmo propio de aprendizaje automático. Puedes usar este filtro para ver las ofertas más recomendadas que, según nuestro modelo, tienen más posibilidades de generar ventas.
  • Si pasas sort_by = property, recibirás todos los resultados de las operaciones de los alojamientos clasificadas high-to-low según nuestro algoritmo propio de aprendizaje automático.
  • Si pasas sort_by = destination, recibirás todos los resultados de 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 la sección « » (Marketing ) del Portal. Ponte en contacto con tu gestor de cuentas para obtener más detalles.

Requisitos de lanzamiento

Responsabilidad en materia de cumplimiento

Eres el único responsable de garantizar el cumplimiento de todas las normas legales y de marketing aplicables a la hora de llevar a cabo campañas.

Integridad del contenido

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

Detalles de la API

Echa un vistazo a las definiciones de los puntos finales de merchandising-related en esta página y, después, usa API Explorer u otro software de pruebas para ver cómo se comparan los ejemplos y las definiciones de esquemas con los resultados reales.

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