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íasall_inclusive
: All-inclusive estadoattribute_id
: Atributosamenity_id
: Servicios a nivel de propiedadspoken_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_id
para 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 include
para especificar las secciones que desees. Los resultados consistirán en las secciones property_id
y 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 name
y amenities
en 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 amenities
se incluyen en la respuesta. Nota: property_id
siempre se incluye en la respuesta; no es necesario que lo especifiques como parámetro de include
a 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)"
},
...
}
}
}