Búsqueda y filtrado

Busca y filtra fácilmente la respuesta de la API de Rapid Content para obtener resultados más específicos.

Puedes usar la función de búsqueda y filtrado de la API de Rapid Content para controlar qué información sobre la propiedad recibes en la respuesta. Esto te permite optimizar los datos que recibes y acceder solo a la información que necesitan los viajeros, lo que se traduce en una reducción de costes y una mayor flexibilidad.

Buscar

Usa la función de búsqueda para encontrar alojamientos que ofrezcan una comodidad o un servicio concreto a los huéspedes; por ejemplo, alojamientos que cuenten con características de sostenibilidad mejoradas.

Puedes buscar por elementos de « property-level », entre los que se incluyen:

category_id: Categorías
all_inclusive: Estado de « All-inclusive »
attribute_id: Atributos
amenity_id: Servicios del edificio
spoken_language_id: Idiomas que se hablan

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

Ejemplo de solicitud 1

En este ejemplo usamos el parámetro de búsqueda « amenity_id » para limitar las propiedades que se muestran.

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 solo aparece la propiedad 1337 porque la propiedad 1 no tiene el ID de servicio 115 disponible.

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

En las listas de referencia de contenidos encontrarás una lista completa de los atributos, servicios, idiomas que se hablan y categorías disponibles.

>> Ver listas de referencias del contenido

Filtrado

Puedes solicitar solo una parte de la respuesta sin recibir todos los detalles del alojamiento, pidiendo únicamente las secciones de « top-level » que necesites. Usa el parámetro « include » para especificar las secciones que quieras. Los resultados incluirán el informe « property_id » y las secciones solicitadas para cada propiedad.

Secciones disponibles para filtrar

En Rapid API puedes filtrar por más de 200 parámetros, entre los que se incluyen « top-level » y subcampos. En esta lista aparecen las secciones de « top-level » que hay disponibles ahora mismo, ordenadas alfabéticamente. Tanto los campos de « top-level » como sus subcampos se pueden filtrar a través de la API, y en el futuro también se podrán filtrar las secciones de « top-level ».

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 usando los valores « name » y « amenities » en el parámetro « include ».

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 amenities aparecen en la respuesta. Nota: « property_id » siempre aparece en la respuesta; no hace falta que lo especifiques como parámetro de « include » a menos que sea el único campo que quieras.

{
  "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)"
      },
      ...
    }
  }
}