Pesquisa e filtragem

Pesquise e filtre facilmente a resposta da Rapid Content API para obter resultados mais direcionados.

Você pode usar a funcionalidade de pesquisa e filtragem da Rapid Content API para controlar quais informações propriedade você recebe na resposta. Isso permite que você simplifique os dados recebidos e acesse apenas as informações que os viajantes precisam, o que significa redução de custos e mais flexibilidade.

Buscar

Use a funcionalidade de pesquisa para encontrar propriedades que oferecem uma comodidade ou serviço específico aos hóspedes, por exemplo, propriedades que oferecem recursos aprimorados de sustentabilidade.

Você pode pesquisar por elementos property-level, incluindo:

category_id: Categorias
all_inclusive: All-inclusive status
attribute_id: Atributos
amenity_id: propriedade comodidades de nível
spoken_language_id: Línguas faladas

Observação: essa funcionalidade não inclui elementos específicos de quarto ou plano tarifário.

Exemplo de solicitação 1

Neste exemplo, estamos usando o novo parâmetro de pesquisa amenity_idpara limitar quais propriedades são retornadas.

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"

Exemplo de resposta 1

Nesta resposta, podemos ver que apenas propriedade 1337 é retornado porque propriedade 1 não tem o ID de comodidade 115 disponível.

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

Para uma lista completa de atributos, comodidades, idiomas falados e categorias disponíveis, consulte as listas de referência de conteúdo.

Filtrar

Você pode solicitar uma parte da resposta sem receber detalhes completos do propriedade, solicitando apenas as seções top-level necessárias. Use o parâmetro includepara especificar as seções desejadas. Os resultados consistirão nas seções property_ide solicitadas por propriedade.

Seções disponíveis para filtragem

Observação: esta lista não deve ser considerada exaustiva, pois a funcionalidade do filtro também se aplicará a quaisquer novas seções top-level adicionadas no 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

Exemplo de solicitação 2

Neste exemplo, estamos usando os valores namee amenitiesno 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"

Exemplo de resposta 2

Este exemplo mostra que property_id, namee amenitiesestão incluídos na resposta. Observação: property_idé sempre incluído na resposta; você não precisa especificá-lo como um parâmetro include, a menos que seja o único campo desejado.

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