API de plataforma de EveryData

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.

Endpoint
POST /api/v1/social
Funciones
4
Por 1.000
1,389 US$

Funciones disponibles

Compara las acciones de Expedia por sus entradas obligatorias, datos devueltos y precio. Usa el identificador de la acción exactamente como aparece.

AcciónObligatoriosOpcionalesEntregaLímitePor 1.000Campos de respuesta
search

Buscar hoteles en Expedia

Busca hoteles en Expedia con keyword y contexto de país, moneda, idioma u orden. Devuelve barrio, región, estrellas y valoración pública; no cotiza una estancia concreta ni asegura disponibilidad.

keywordcountry, currency, lang, sortEntrega síncronaEl 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 solicitudeshotel_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
profile

Revisar menciones de un alojamiento

Analiza la url de un alojamiento y devuelve categorías, texto y menciones observadas en la ficha. Los filtros compatibles no añaden una búsqueda de hoteles ni prueban que una mención sea una característica contractual.

urlcountry, lang, sortEntrega síncrona$1.39 por 1.000 solicitudescategory · text · mentions
reviews

Leer reseñas de huéspedes

Recoge reseñas de la url y permite acotar mercado, idioma, fecha u orden. Distingue fecha de publicación, fecha de estancia y tipo de viaje; no garantiza todas las opiniones.

urlcountry, lang, reviews_from, since, sortEntrega síncronaEl 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 solicitudesid · 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
car_rental

Comparar alquileres de vehículos

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.

keywordcheck_in, check_out, drop_off_date, pick_up_dateEntrega síncronaEl 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 solicitudesid · 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é 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.

¿Qué significan los parámetros de Expedia search?

Busca hoteles en Expedia con keyword y contexto de país, moneda, idioma u orden. Devuelve barrio, región, estrellas y valoración pública; no cotiza una estancia concreta ni asegura disponibilidad.

keywordObligatorio
Para search, indica el destino del hotel. Para car_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 localesExpedia 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
countryOpcional
Selección de región para la consulta de detalles de la habitación. auto indica automático; para el resto, usa los códigos listados en esta API. No es un filtro por el país del hotel. Actualmente, search, profile y reviews no usan los detalles de habitación, por lo que no se garantiza que este parámetro cambie los resultados.
Valores permitidos:aratauautobebrcachdedkesfifrgrhkidieinitjpkrmxmynlnonzphsesgthtwukusvn
currencyOpcional
Moneda para mostrar los precios en los resultados de búsqueda de hoteles en search. El valor por defecto es USD. No es la moneda de facturación de esta API. Este parámetro no cambia automáticamente la moneda en la URL de alquiler de coches.
langOpcional
Idioma para los detalles de la habitación: english (inglés) o sitedefault (el del sitio por defecto). No son códigos de idioma como en o zh. Esta API no usa los detalles de habitación, por lo que no se puede garantizar la traducción de la descripción del hotel o las reseñas.
Valores permitidos:englishsitedefault
sortOpcional
Orden de búsqueda de hoteles: distance, price_asc, price_desc o top_rated (mejor puntuación). Si se omite, se usa el orden recomendado. Las reseñas en reviews no siguen este orden; este parámetro compartido tiene un comportamiento no definido en este contexto, por lo que no se puede garantizar que estos valores ordenen las reseñas.
Valores permitidos:distanceprice_ascprice_desctop_rated

¿Qué significan los parámetros de Expedia profile?

Analiza la url de un alojamiento y devuelve categorías, texto y menciones observadas en la ficha. Los filtros compatibles no añaden una búsqueda de hoteles ni prueban 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ámetro keyword de la acción car_rental.
Expedia: diferencia entre la clasificación por estrellas del hotel y la calificación nacionalExpedia 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
countryOpcional
Selección de región para la consulta de detalles de la habitación. auto indica automático; para el resto, usa los códigos listados en esta API. No es un filtro por el país del hotel. Actualmente, search, profile y reviews no usan los detalles de habitación, por lo que no se garantiza que este parámetro cambie los resultados.
Valores permitidos:aratauautobebrcachdedkesfifrgrhkidieinitjpkrmxmynlnonzphsesgthtwukusvn
langOpcional
Idioma para los detalles de la habitación: english (inglés) o sitedefault (el del sitio por defecto). No son códigos de idioma como en o zh. Esta API no usa los detalles de habitación, por lo que no se puede garantizar la traducción de la descripción del hotel o las reseñas.
Valores permitidos:englishsitedefault
sortOpcional
Orden de búsqueda de hoteles: distance, price_asc, price_desc o top_rated (mejor puntuación). Si se omite, se usa el orden recomendado. Las reseñas en reviews no siguen este orden; este parámetro compartido tiene un comportamiento no definido en este contexto, por lo que no se puede garantizar que estos valores ordenen las reseñas.
Valores permitidos:distanceprice_ascprice_desctop_rated

¿Qué significan los parámetros de Expedia reviews?

Recoge reseñas de la url y permite acotar mercado, idioma, fecha u 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ámetro keyword de la acción car_rental.
countryOpcional
Selección de región para la consulta de detalles de la habitación. auto indica automático; para el resto, usa los códigos listados en esta API. No es un filtro por el país del hotel. Actualmente, search, profile y reviews no usan los detalles de habitación, por lo que no se garantiza que este parámetro cambie los resultados.
Valores permitidos:aratauautobebrcachdedkesfifrgrhkidieinitjpkrmxmynlnonzphsesgthtwukusvn
langOpcional
Idioma para los detalles de la habitación: english (inglés) o sitedefault (el del sitio por defecto). No son códigos de idioma como en o zh. Esta API no usa los detalles de habitación, por lo que no se puede garantizar la traducción de la descripción del hotel o las reseñas.
Valores permitidos:englishsitedefault
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 proporciona since, 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 sobre reviews_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 existentesLas 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 búsqueda de hoteles: distance, price_asc, price_desc o top_rated (mejor puntuación). Si se omite, se usa el orden recomendado. Las reseñas en reviews no siguen este orden; este parámetro compartido tiene un comportamiento no definido en este contexto, por lo que no se puede garantizar que estos valores ordenen las reseñas.
Valores permitidos:distanceprice_ascprice_desctop_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. Para car_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 proporciona pick_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 proporciona drop_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 sobre check_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

  1. 01Consulta el catálogo público y elige una acción de la plataforma.
  2. 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
  3. 03Procesa el resultado síncrono o consulta el identificador de trabajo devuelto si la acción es asíncrona.
  4. 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
expedia_search.sh
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 de origen contengan 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.