API de Expedia
Busca alojamientos y alquileres de vehículos en Expedia, y consulta perfiles o reseñas por URL. País, idioma, moneda y fechas aportan contexto específico a cada acción.
Una mención de servicio no es una garantía contractual y una tarifa observada no queda reservada. Las fechas de estancia y de publicación de una reseña deben mantenerse separadas.
Disponibilidad de la plataforma
- Salud 24 h
- Normal
Últimos 30 días
Funciones disponibles
Cada acción de Expedia, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Buscar hoteles en Expediasearch | Busca hoteles en Expedia para el destino de keyword, con moneda y orden opcionales. | $1.39 por 1.000 solicitudes | Normal |
Revisar menciones de un alojamientoprofile | Analiza la url de la página de un hotel y devuelve estrellas, valoración por categorías, tipo de propiedad, dirección, idiomas y resumen de reseñas. | $1.39 por 1.000 solicitudes | Normal |
Leer reseñas de huéspedesreviews | Recoge reseñas de la url; since acota la fecha y sort fija el orden. | $1.39 por 1.000 solicitudes | Normal |
Comparar alquileres de vehículoscar_rental | Busca alquiler de vehículos con keyword y fechas de recogida y devolución compatibles. | $1.39 por 1.000 solicitudes | Normal |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿Qué acepta cada acción de Expedia?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
searchBuscar hoteles en Expedia Busca hoteles en Expedia para el destino de | keyword | currency, sort | Entrega síncrona | El catálogo declara defaultLimit = 24 y maxLimit = 200 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | hotel_id · name · url · neighborhood · region · rating · rating_scale · rating_label · review_count · star_rating · price_per_night · price_total · discount_percent · vip_access · latitude · longitude · image_url · provider · platform |
profileRevisar menciones de un alojamiento Analiza la | url | — | Entrega síncrona | — | $1.39 por 1.000 solicitudes | hotel_id · hotel_name · hotel_url · rating · rating_scale · rating_label · review_count · star_rating · property_type · address · latitude · longitude · provider · category_ratings · languages · review_summary · platform |
reviewsLeer reseñas de huéspedes Recoge reseñas de la | url | reviews_from, since, sort | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 200 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · text · title · rating · rating_scale · rating_label · posted_at · stay_date · author_name · trip_type · stay_duration · traveled_with · verified · language · hotel_id · hotel_name · hotel_url · hotel_rating · platform · liked · disliked · image_urls · owner_response |
car_rentalComparar alquileres de vehículos Busca alquiler de vehículos con | keyword | check_in, check_out, drop_off_date, pick_up_date | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 100 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · url · title · vehicle_category · vendor_name · price · price_total · rating · rating_scale · rating_label · attributes · pick_up_location · drop_off_location · pick_up_date · drop_off_date · pick_up_time · drop_off_time · image_url · platform |
¿Qué significan los parámetros de Expedia search?
Busca hoteles en Expedia para el destino de keyword, con moneda y orden opcionales. Devuelve barrio, región, estrellas, valoración y los precios por noche y total publicados; no cotiza una estancia concreta ni asegura disponibilidad.
keywordObligatorio- Para
search, indica el destino del hotel. Paracar_rental, indica el lugar de recogida o la URL completa de una búsqueda de coches en Expedia. Si envías una URL completa para el alquiler, se usarán sus condiciones y se ignorarán los parámetros de fecha independientes. No es un término de búsqueda de vuelos.Expedia: categoría por estrellas y clasificaciones locales — Expedia explica que la categoría por estrellas puede coexistir con sistemas de clasificación nacionales y que no garantiza todas las instalaciones enumeradas. `star_rating` no es la media de reseñas de huéspedes ni una certificación universal. · Consultada currencyOpcional- Moneda para mostrar los precios en los resultados de búsqueda de hoteles en
search. El valor por defecto esUSD. No es la moneda de facturación de esta API. No cambia la moneda de los resultados decar_rental. sortOpcional- Orden de los hoteles en
search:distance(distancia),price_asc,price_desc(precio de menor a mayor o de mayor a menor) otop_rated(mejor puntuación). Si se omite, se usa el orden recomendado de Expedia.Valores permitidos:distanceprice_ascprice_desctop_rated
¿Qué significan los parámetros de Expedia profile?
Analiza la url de la página de un hotel y devuelve estrellas, valoración por categorías, tipo de propiedad, dirección, idiomas y resumen de reseñas. No admite páginas de resultados de búsqueda ni prueba que una mención sea una característica contractual.
urlObligatorio- Enlace a la página de un hotel en Expedia o en un sitio compatible como Hotels.com, para obtener el perfil (
profile) o las reseñas (reviews). No es la página de una lista de búsqueda. La URL de consulta de alquiler de coches debe enviarse en el parámetrokeywordde la accióncar_rental.Expedia: diferencia entre la clasificación por estrellas del hotel y la calificación nacional — Expedia explica que la clasificación por estrellas sirve para categorizar el nivel del hotel y que algunas regiones tienen además una calificación nacional. Esta clasificación no garantiza que un hotel disponga de todas las instalaciones mencionadas. El campo `star_rating` no es la media de las opiniones de los huéspedes ni debe interpretarse como una certificación oficial de sus instalaciones. · Consultada
¿Qué significan los parámetros de Expedia reviews?
Recoge reseñas de la url; since acota la fecha y sort fija el orden. Distingue fecha de publicación, fecha de estancia y tipo de viaje; no garantiza todas las opiniones.
urlObligatorio- Enlace a la página de un hotel en Expedia o en un sitio compatible como Hotels.com, para obtener el perfil (
profile) o las reseñas (reviews). No es la página de una lista de búsqueda. La URL de consulta de alquiler de coches debe enviarse en el parámetrokeywordde la accióncar_rental. reviews_fromOpcional- Parámetro compatible con la fecha de inicio para las reseñas (
reviews). Se recomienda el formato YYYY-MM-DD. Si también se proporcionasince, este último tiene prioridad. No es la fecha de entrada al hotel. sinceOpcional- Fecha mínima para las reseñas (
reviews). Se recomienda el formato YYYY-MM-DD y tiene prioridad sobrereviews_from. No se usa para limitar la fecha de apertura del hotel ni las fechas de alquiler de coches.Expedia: puntuaciones de las reseñas, quién puede publicarlas y respuestas existentes — Las directrices oficiales distinguen entre la puntuación de una reseña individual, la puntuación general del hotel que se muestra y los criterios para las opiniones de alquiler de coches. También permiten que dejen reseñas algunos viajeros que intentaron alojarse pero no completaron su estancia. Esta referencia solo aclara la terminología sobre puntuaciones y quién puede opinar, no demuestra que todos los valores devueltos por esta API usen una escala unificada ni que se haya verificado una estancia completa. · Consultada sortOpcional- Orden de las reseñas en
reviews:newest(más recientes),relevance(relevancia),top_rated(mejor puntuación) omost_helpful(más útiles).Valores permitidos:most_helpfulnewestrelevancetop_rated
¿Qué significan los parámetros de Expedia car_rental?
Busca alquiler de vehículos con keyword y fechas de recogida y devolución compatibles. Compara categoría, empresa, precio y valoración mostrados; no reserva el coche ni congela impuestos o extras.
keywordObligatorio- Para
search, indica el destino del hotel. Paracar_rental, indica el lugar de recogida o la URL completa de una búsqueda de coches en Expedia. Si envías una URL completa para el alquiler, se usarán sus condiciones y se ignorarán los parámetros de fecha independientes. No es un término de búsqueda de vuelos. check_inOpcional- Parámetro compatible con la fecha de recogida en
car_rental. Solo se usa si no se proporcionapick_up_date. No es un filtro de fecha de entrada al hotel. check_outOpcional- Parámetro compatible con la fecha de devolución en
car_rental. Solo se usa si no se proporcionadrop_off_date. No es un filtro de fecha de salida del hotel. drop_off_dateOpcional- Fecha de devolución en
car_rental, en formato YYYY-MM-DD. Si proporcionas la fecha de recogida pero no la de devolución, se usará el mismo día. Indica explícitamente una fecha posterior a la de recogida. Si no proporcionas la fecha de recogida, el par de fechas por defecto sobrescribirá la que hayas indicado. pick_up_dateOpcional- Fecha de recogida en
car_rental, en formato YYYY-MM-DD. Tiene prioridad sobrecheck_in. Si omites la fecha de recogida, se usará por defecto una fecha 30 días posterior a la actual y una de devolución 2 días después. La hora de recogida y devolución se fija a las 10:30 AM, por lo que no se puede asumir que los precios sean válidos para cualquier otro horario.
Cómo usar la API de Expedia
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"expedia","action":"search","params":{"keyword":"<keyword>"}}'
Preguntas sobre la API de Expedia
¿Cómo llamo a la API de Expedia?
Envía POST /api/v1/social con platform igual a expedia, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Expedia?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye hotel_id, name, neighborhood y region. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de Expedia?
Expedia explica que la categoría por estrellas puede coexistir con sistemas de clasificación nacionales y que no garantiza todas las instalaciones enumeradas. star_rating no es la media de reseñas de huéspedes ni una certificación universal.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword; profile requiere url; reviews requiere url; consulta las demás acciones en la lista de funciones.
¿Las acciones de Expedia responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.