API提供

SmoothQの待ち時間予測データをあなたのアプリケーションに統合

概要

SmoothQ APIは、全国13万以上の施設の待ち時間予測データにプログラマティックにアクセスするためのRESTful APIです。施設検索、待ち時間予測、混雑状況の取得など、多彩な機能を提供しています。

# Base URL

https://api.smoothq.jp/v1

REST

RESTful設計

JSON

JSON形式

99.9%

稼働率保証

エンドポイント

GET/facilities

施設一覧を取得します。都道府県や施設タイプで絞り込みが可能です。

パラメータ

prefecture: string - 都道府県名で絞り込み

type: string - 施設タイプで絞り込み（hospital, clinic, government等）

limit: number - 取得件数（デフォルト: 20、最大: 100）

offset: number - オフセット（ページネーション用）

GET/facilities/{id}

指定したIDの施設詳細情報を取得します。住所、営業時間、対応サービスなどを含みます。

GET/predictions/{facility_id}

指定した施設の待ち時間予測を取得します。現在の予測値、時間帯別予測、信頼度などを含みます。

レスポンス例

{
  "facility_id": "tokyo_hospital_001",
  "predicted_wait_time": 25,
  "confidence": 0.85,
  "congestion_level": "medium",
  "prediction_tier": "verified",
  "hourly_forecast": [...]
}

GET/search

キーワードや位置情報で施設を検索します。

パラメータ

q: string - 検索キーワード

lat: number - 緯度（位置検索用）

lng: number - 経度（位置検索用）

radius: number - 検索半径（メートル、デフォルト: 5000）

認証

APIへのアクセスにはAPIキーが必要です。すべてのリクエストのAuthorizationヘッダーにAPIキーを含めてください。

# リクエスト例

curl -H "Authorization: Bearer YOUR_API_KEY" \

https://api.smoothq.jp/v1/facilities

企業・事業者向けAPI提供

SmoothQ APIは、企業・事業者様向けに完全カスタマイズ対応で提供しています。お問い合わせいただいた上で、御社のニーズに最適なプランをご提案いたします。

無料サポート付き

導入から運用まで、専任スタッフが無料でサポートいたします。

完全独立サーバー

セキュリティと性能を最大化する専用サーバー環境をご用意。

料金は個別相談

利用規模や要件に応じて、最適な料金プランをご提案します。

ご利用について
API利用をご検討の方は、お問い合わせフォームよりご連絡ください。担当者より3営業日以内にご連絡いたします。

SDK

主要なプログラミング言語向けのSDKを提供しています。APIの統合をより簡単に行えます。

JavaScript / TypeScript

npm install @smoothq/sdk

Python

pip install smoothq

APIキーを取得しませんか？

無料プランから始められます。お問い合わせください。

お問い合わせ