# Kayak (Hong Kong SAR China) — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search for flights and compare prices across airlines and routes, including flexible-date searches across multiple origin airports. View monthly price calendars to find the cheapest travel dates and get real-time fare information for any route.

**Category:** Travel | **Website:** [kayak.com.hk/](https://kayak.com.hk/) | **Docs:** [parse.bot/marketplace/592020b1-3843-4100-82ab-37c76ce7cb36/kayak-com-hk-api](https://parse.bot/marketplace/592020b1-3843-4100-82ab-37c76ce7cb36/kayak-com-hk-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-kayak-com-hk-api-592020b1/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_price_calendar

Retrieve the monthly price calendar for a route, showing the lowest available fare for each day of the month.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `destination` | string | Yes | Destination airport IATA code (e.g. CDG, DXB, NRT). |
| `origin` | string | Yes | Origin airport IATA code (e.g. JFK, LHR, SYD). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kayak-com-hk-api-592020b1/get_price_calendar \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"destination":"<string>","origin":"<string>"}'
```

### search_flights

Search for one-way flights between two airports. Returns flight options with pricing in HKD, schedules, stop information, and booking links. Results are sorted by best match. Each request searches a single origin-destination pair on a specific date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `cabin` | string | No | Cabin class. |
| `date` | string | Yes | Departure date in YYYY-MM-DD format. |
| `destination` | string | Yes | Destination airport IATA code (e.g. YVR, SFO, LHR). |
| `limit` | integer | No | Maximum number of flight results to return. |
| `origin` | string | Yes | Origin airport IATA code (e.g. HND, NRT, LAX, JFK). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kayak-com-hk-api-592020b1/search_flights \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cabin":"<string>","date":"<string>","destination":"<string>","limit":"<integer>","origin":"<string>"}'
```

### search_flights_multi_origin

Search for flights from multiple Japanese origin airports (HND, NRT, KIX) to a destination with flexible dates. Returns the top 5 cheapest flights per origin airport across the specified date range. Useful for comparing prices across nearby airports.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Target departure date in YYYY-MM-DD format. Omitting defaults to 30 days from today. |
| `destination` | string | No | Destination airport IATA code (e.g. LHR, JFK, SYD). |
| `flex_days` | integer | No | Flexible date range in days (±N days from the target date). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kayak-com-hk-api-592020b1/search_flights_multi_origin \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","destination":"<string>","flex_days":"<integer>"}'
```