API Reference

Endpoint documentation, filters, pagination, freshness, attribution, and code examples for the four approved government datasets in API v1. Documentation is public; API requests require a valid API key.

Quick Start

1. Request an API key by contacting data@hotelinsight.io or via the Developers page.
2. Authenticate each request with a Bearer token in the Authorization header.
3. Query an approved dataset endpoint using its documented filters and pagination.

Authentication

All API requests require a Bearer token: Authorization: Bearer YOUR_API_KEY. Keys are scoped per plan and can be rotated at any time. Requests without a valid key receive 401 Unauthorized.

Available Datasets

• JNTO Arrivals — Inbound visitor arrivals by market and period (Japan).
• JTA Inbound Consumption — Inbound tourism consumption indicators (Japan).
• Minpaku Registration — Registered private lodging supply and status (Japan).
• MLIT Lodging Capacity — Lodging facilities and room capacity (Japan).

Rate Limits

The API plan includes 500,000 requests/month and a burst limit of 60 requests/minute. Enterprise limits are contractual. Exceeding a limit returns 429 Too Many Requests.

Response Format

Responses use the documented v1 JSON format with pagination, source attribution, and freshness information. See the reference for each dataset's fields and filters.

See plans and pricing for full dataset coverage, or read data-driven market analysis on the Hotelinsight Blog.