検索と絞り込み

Rapid Content APIのレスポンスを簡単に検索・フィルタリングして、より的確な結果を得ることができます。

Rapid Content APIの検索およびフィルタ機能を使用することで、レスポンスで受け取る施設に関する情報を制御することができます。これにより、受け取るデータを整理し、旅行者に必要な情報のみにアクセスできるようになります。その結果、コストの削減と柔軟性の向上が図れます。

検索

検索機能を利用して、ゲストに特定の設備やサービスを提供している宿泊施設、例えば、環境に配慮した機能を充実させている宿泊施設などを探してみてください。

property-levelの要素（以下を含む）で検索することができます：

category_id: カテゴリ
all_inclusive:All-inclusiveの状況
attribute_id: 属性
amenity_id: 施設レベルの設備
spoken_language_id: 使用されている言語

注 : この機能には、特定の客室や料金プランの要素は含まれていません。

リクエスト例1

この例では、amenity_id という検索パラメータを使用して、返されるプロパティを絞り込んでいます。

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"

回答例1

この応答から、施設1にはアメニティID 115がありませんので、施設1337のみが返されていることがわかります。

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

利用可能な属性、設備、対応言語、およびカテゴリーの完全な一覧は、コンテンツ参照リストに記載されています。

>> コンテンツの参照リストを表示する

絞り込み

施設の詳細をすべて受け取ることなく、必要なtop-levelセクションのみをリクエストすることで、応答の一部を取得することができます。includeパラメータを使用して、必要なセクションを指定してください。結果には、property_id および施設で指定されたセクションが含まれます。

フィルタリング可能なセクション

Rapid APIでは、「top-level」やサブフィールドなど、200以上のパラメータでフィルタリングを行うことができます。このリストには、現在利用可能なtop-levelのセクションが、アルファベット順に表示されています。top-levelの各フィールドとそのサブフィールドは、APIを通じてフィルタリングが可能です。また、今後追加される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

リクエスト例2

この例では、name パラメータにamenities および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"

回答例2

この例では、property_id、name、およびamenities がレスポンスに含まれていることがわかります。注：property_id は常にレスポンスに含まれます。取得したいフィールドがこれのみの場合を除き、include パラメータとして指定する必要はありません。

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