API Services

Integrate SmoothQ's Wait Time Prediction Data into Your Application

Overview

SmoothQ API is a RESTful API for programmatic access to wait time prediction data for 130,000+ facilities nationwide. We offer various features including facility search, wait time prediction, and congestion status retrieval.

# Base URL

https://api.smoothq.jp/v1

REST

RESTful Design

JSON

JSON Format

99.9%

Uptime Guaranteed

Endpoints

GET/facilities

Get a list of facilities. Filter by prefecture or facility type.

Parameters

prefecture: string - Filter by prefecture name

type: string - Filter by facility type (hospital, clinic, government, etc.)

limit: number - Number of results (default: 20, max: 100)

offset: number - Offset for pagination

GET/facilities/{id}

Get detailed information for a specific facility by ID. Includes address, hours, and available services.

GET/predictions/{facility_id}

Get wait time predictions for a specific facility. Includes current prediction, hourly forecast, and confidence level.

Response Example

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

GET/search

Search facilities by keyword or location.

Parameters

q: string - Search keyword

lat: number - Latitude (for location search)

lng: number - Longitude (for location search)

radius: number - Search radius in meters (default: 5000)

Authentication

An API key is required to access the API. Include your API key in the Authorization header of all requests.

# Request Example

curl -H "Authorization: Bearer YOUR_API_KEY" \

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

Enterprise API Solutions

SmoothQ API is available for businesses and enterprises with fully customized solutions. Contact us to get a plan tailored to your specific needs.

Free Support

Dedicated staff provides free support from implementation to operation.

Dedicated Server

Dedicated server environment for maximum security and performance.

Custom Pricing

We offer optimal pricing plans based on your scale and requirements.

Getting Started
If you're interested in using our API, please contact us through the inquiry form. Our team will respond within 3 business days.

SDKs

We provide SDKs for major programming languages to make API integration easier.

JavaScript / TypeScript

npm install @smoothq/sdk

Python

pip install smoothq

Ready to Get an API Key?

Start with our free plan. Contact us to get started.