Hotelinsight API Documentation

Full reference documentation for the Hotelinsight REST API — normalized Asia-Pacific tourism data from official government sources, delivered as clean JSON or CSV.

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 any dataset endpoint with flexible date-range and country/region filters.

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

• Singapore — STB visitor arrivals by nationality and purpose, hotel supply and occupancy benchmarks, quarterly tourism receipts.
• Japan — e-Stat CPI rent index by region and city-size group (CC BY 4.0).
• South Korea — KTO monthly visitor arrivals by nationality.
• Cross-market — daily SGD-based exchange rates versus Asia-Pacific currencies.

Rate Limits

Rate limits depend on your plan: Starter includes 50K requests/month, Professional 500K requests/month, and Enterprise is unlimited. Exceeding your quota returns 429 Too Many Requests with a Retry-After header.

Response Format

Responses are JSON by default with consistent field names across all markets; append format=csv for CSV export. Every response includes the source agency, reference period, and last-updated timestamp so data lineage is always clear.

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