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 qué información sobre propiedades 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 parámetro de búsqueda amenity_idpara limitar las propiedades que 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.

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

Puedes filtrar sobre más de 200 parámetros en Rapid API, incluyendo top-level y subcampos. Esta lista muestra las secciones de top-level actualmente disponibles, por orden alfabético. Tanto los campos top-level como sus subcampos son filtrables a través de la API y las futuras secciones top-level también serán filtrables.

address
airports
all_inclusive
amenities
attributes
brand
business_model
catalog
category
chain
checkin
checkout
descriptions
fax
fees
images
location
multi_unit
name
onsite_payments
payment_registration_recommended
phone
policies
property_id
property_ids
rank
rates
ratings
registry_number
rooms
spoken_languages
statistics
supply_source
tax_id
themes
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)"
      },
      ...
    }
  }
}