Pesquisa e filtragem

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

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

Buscar

Utilize a função de busca para encontrar propriedades que ofereçam uma determinada comodidade ou serviço aos hóspedes, por exemplo, propriedades que ofereçam recursos de sustentabilidade aprimorados.

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

category_idCategorias
all_inclusive: All-inclusive status
attribute_idAtributos
amenity_id: propriedade comodidades de nível
spoken_language_idLí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 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 obter uma lista completa dos 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 todos os detalhes de propriedade, solicitando apenas as seções de top-level que você precisa. Use o parâmetro includepara especificar as seções desejadas. Os resultados consistirão no property_ide nas seções solicitadas por propriedade.

Seções disponíveis para filtragem

É possível filtrar por mais de 200 parâmetros em Rapid API, incluindo top-level e subcampos. Esta lista mostra as seções top-level atualmente disponíveis, em ordem alfabética. Tanto os campos top-level quanto seus subcampos podem ser filtrados pela API, e as futuras seções top-level também serão filtráveis.

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

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_idestá sempre incluído na resposta; você não precisa especificá-lo como um parâmetro includea 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)"
      },
      ...
    }
  }
}