Búsqueda y filtrado

Busca y filtra fácilmente la respuesta de la API de Contenidos Rápidos para obtener resultados más específicos.

Puedes utilizar la función de búsqueda y filtro de la API de Contenidos Rápidos para controlar la información sobre propiedades que recibes en la respuesta. Esto te permite racionalizar los datos que recibes y acceder sólo a la información que necesitan los viajeros, lo que supone una reducción de costes y una mayor flexibilidad.

Buscar

Utiliza la función de búsqueda para encontrar propiedades que ofrezcan una comodidad o servicio concreto a los huéspedes, por ejemplo, propiedades que ofrezcan características de sostenibilidad mejoradas.

Puedes buscar por property-level elementos como

category_id: Categorías
all_inclusive: All-inclusive estado
attribute_id: Atributos
amenity_id: Servicios a nivel de propiedad
spoken_language_id: Lenguas habladas

Nota: Esta funcionalidad no incluye elementos específicos de los planes de tarifas o de las habitaciones.

Ejemplo de solicitud 1

En este ejemplo estamos utilizando el nuevo parámetro de búsqueda amenity_idpara limitar qué propiedades se devuelven.

curl -X GET "https://test.ean.com/v3/properties/content\
?language=en-US\
&supply_source=expedia\
&amenity_id=115\
&include=property_id\
&property_id=1337\
&property_id=1" \
 -H "accept: application/json, application/json"\
 -H "accept-encoding: gzip"\
 -H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1697664047"\
 -H "user-agent: TravelNow/3.30.112"

Ejemplo de respuesta 1

En esta respuesta podemos ver que sólo se devuelve la propiedad 1337 porque la propiedad 1 no tiene el identificador de amenidad 115 disponible.

{
  "1337": {
    "property_id": "1337"
  }
}

Para obtener una lista completa de los atributos, servicios, lenguas habladas y categorías disponibles, consulta las listas de referencia de contenidos de.

Filtrado

Puedes solicitar una parte de la respuesta sin recibir todos los detalles del alojamiento solicitando sólo las secciones de top-level que necesites. Utiliza el parámetro includepara especificar las secciones que desees. Los resultados consistirán en las secciones property_idy solicitadas por propiedad.

Secciones disponibles para filtrar

Nota: Esta lista no debe considerarse exhaustiva, ya que la función de filtro también se aplicará a las nuevas secciones de top-level que se añadan en el futuro.

property_id
name
address
ratings
location
phone
fax
category
rank
business_model
checkin
checkout
fees
policies
attributes
amenities
images
onsite_payments
rooms
rates
dates
descriptions
statistics
airports
themes
all_inclusive
tax_id
chain
brand
spoken_languages
multi_unit
payment_registration_recommended
supply_source
vacation_rental_details

Ejemplo de solicitud 2

En este ejemplo estamos utilizando los valores namey amenitiesen el parámetroinclude.

curl -X GET "https://test.ean.com/v3/properties/content\
?language=en-US\
&supply_source=expedia\
&include=name\
&include=amenities\
&property_id=1337" \
 -H "accept: application/json, application/json"\
 -H "accept-encoding: gzip"\
 -H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1697664047"\
 -H "user-agent: TravelNow/3.30.112"

Ejemplo de respuesta 2

Este ejemplo muestra que property_id, name, y amenitiesse incluyen en la respuesta. Nota: property_idsiempre se incluye en la respuesta; no es necesario que lo especifiques como parámetro de includea menos que sea el único campo que desees.

{
  "1337": {
    "property_id": "1337",
    "name": "Hyatt Regency Paris Etoile",
    "amenities": {
      "8": {
        "id": "8",
        "name": "Elevator"
      },
      "43": {
        "id": "43",
        "name": "Concierge services"
      },
      "115": {
        "id": "115",
        "name": "Bicycle rentals nearby"
      },
      "361": {
        "id": "361",
        "name": "Breakfast available (surcharge)"
      },
      ...
    }
  }
}