APIを試す
情報や条件をターミナル、プロンプトに入力するだけで最適な観光地をAPIが返します。
リクエストボディの作成
本APIでは、以下の情報を含む JSON形式のリクエストボディ を入力として受け取ります。 リクエスト内容の詳細仕様は、リクエストボディ仕様書をご確認ください。 テスト用のデータ(JSON)テストユーザーデータ ご用意しています。
{
"basic_info": {
"age": 24,
"gender": "female"
},
"user_dynamic_info": {
"discovery_status": 3,
"group_size": 1,
"region": "JP-40",
"stay_duration": 3,
"stay_datetime": "2025-09-10"
},
"user_static_info": {
"categories": [3, 4, 8],
"tags": [304, 305, 402, 404, 801, 805]
}
}
エンドポイント一覧
本APIでは、複数のエンドポイントを提供しています。 目的や精度・速度のバランスに応じて、適切なエンドポイントをご利用ください。 以下に、各エンドポイントの概要と使い分けの目安を示します。モデルの詳細はこちら
| エンドポイント | 説明 |
|---|---|
| https://api.ekiraku.net/verbose_psm_v2507 | すべての観光地情報(詳細)を含むフルモデル |
実行コマンド (例)
以下は、本APIエンドポイントに対してリクエストを送信するための 実行コマンド です。 ターミナルやコマンドラインにて入力・実行することで、指定されたパラメータを使ってAPIと通信を行います。 ※ ご利用の環境に応じて、PowerShell・curl・Postmanなどに置き換えてご利用ください。
PowerShell(Windows)の場合
Invoke-RestMethod -Uri "https://api.ekiraku.net/verbose_psm_v2507" -Method POST -Headers @{ "X-API-KEY" = "your-api-key"; "Content-Type" = "application/json" } -Body '{"basic_info":{"age":24,"gender":"female"},"user_dynamic_info":{"discovery_status":3,"group_size":1,"region":"JP-40","stay_duration":3,"stay_datetime":"2025-09-10"},"user_static_info":{"categories":[3,4,8],"tags":[304,305,402,404,801,805]}}'
Postmanの場合
1. メソッドとURLの設定
Method:POST
URL:https://api.ekiraku.net/verbose_psm_v2507
2. Headers タブ
以下のキーを追加
X-API-KEY:自身のAPIキー
Content-Type:application/json
3. Body タブ
rawを選択
以下のJSONを貼り付け
{
"basic_info": {
"age": 24,
"gender": "female"
},
"user_dynamic_info": {
"discovery_status": 3,
"group_size": 1,
"region": "JP-40",
"stay_duration": 3,
"stay_datetime": "2025-09-10"
},
"user_static_info": {
"categories": [3, 4, 8],
"tags": [304, 305, 402, 404, 801, 805]
}
}