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]
    }
    }
        

4. 送信(Send)ボタンをクリック