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ón | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
searchBuscar hoteles en Expedia Busca hoteles en Expedia con | keyword | country, currency, lang, 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 | country, lang, sort | Entrega síncrona | — | $1.39 por 1.000 solicitudes | category · text · mentions |
reviewsLeer reseñas de huéspedes Recoge reseñas de la | url | country, lang, 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 |
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é 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. 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 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.
autoindica 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,profileyreviewsno 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 esUSD. 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) ositedefault(el del sitio por defecto). No son códigos de idioma comoenozh. 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_descotop_rated(mejor puntuación). Si se omite, se usa el orden recomendado. Las reseñas enreviewsno 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ámetrokeywordde la accióncar_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.
autoindica 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,profileyreviewsno 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) ositedefault(el del sitio por defecto). No son códigos de idioma comoenozh. 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_descotop_rated(mejor puntuación). Si se omite, se usa el orden recomendado. Las reseñas enreviewsno 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ámetrokeywordde la accióncar_rental. countryOpcional- Selección de región para la consulta de detalles de la habitación.
autoindica 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,profileyreviewsno 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) ositedefault(el del sitio por defecto). No son códigos de idioma comoenozh. 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 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 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_descotop_rated(mejor puntuación). Si se omite, se usa el orden recomendado. Las reseñas enreviewsno 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. 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 devuelto si la acción es 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 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.