Skip to main content
mapping.travel is a hotel mapping API for reconciling partner hotel inventory against a global reference dataset. Upload your inventory, run a mapping job, and get back a structured set of matches. Use them to deduplicate suppliers, normalize hotel data, and power downstream search and booking.

​
What you can do

The API covers the full mapping lifecycle: ingest raw inventory from any supplier, run configurable mapping jobs, query results, and export matched data.

Quickstart

Upload your first inventory file and run a mapping job in under five minutes.

Authentication

Learn how to get your API token and authenticate every request.

Inventory uploads

Upload CSV, JSON, Excel, or Parquet files and track their processing status.

Mapping jobs

Start mapping jobs, choose a mapping mode, and retrieve matched results.

​
Key capabilities

Inventory ingestion. Upload hotel inventory in CSV, JSON, Excel (.xlsx), or Parquet format. Uploads are idempotent: sending the same file twice returns the same upload ID. Flexible mapping modes. Choose from three modes depending on your data:
  • STANDARD: fuzzy name and location matching against the reference dataset
  • ID_TO_ID: match by supplier hotel ID when you have a known supplier code
  • HYBRID: combine ID-based and fuzzy matching in a single pass
Reference hotel dataset. Every mapping job runs against a continuously updated global reference dataset. You can search and browse reference hotels independently of your own inventory. Supplier connections. Associate inventory with a specific supplier code (for example, expedia or booking) to enable ID-to-ID mapping against that supplier’s reference IDs. Result export. After a mapping job completes, download the results or trigger a manual export to downstream systems. Billing and usage. Track mapping usage against your plan quota. Free plans include a daily mapping allowance; paid plans offer higher limits and credit-based overages.

​
Base URL

All API requests use the following base URL:
All endpoints are versioned under /api/v1.