# Skyscanner (India) — 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 worldwide and compare prices with autocomplete suggestions for airports and destinations. View price calendars to find the cheapest travel dates and explore real-time flight availability and pricing.

**Category:** Travel | **Website:** [skyscanner.co.in/](https://skyscanner.co.in/) | **Docs:** [parse.bot/marketplace/d41780f4-e213-4f2e-8a1a-650f34d90aaf/skyscanner-co-in-api](https://parse.bot/marketplace/d41780f4-e213-4f2e-8a1a-650f34d90aaf/skyscanner-co-in-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-skyscanner-co-in-api-d41780f4/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### autocomplete

Autocomplete airport/city name search to get GeoIds (entityIds) and IATA codes for use in other endpoints. Returns matching airports and cities based on the query string. Results include place_id, place_name, city_name, country_name, iata_code, entity_id, and resulting_phrase for each match.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `is_destination` | boolean | No | Whether the search is for a destination airport/city |
| `query` | string | Yes | Search query for airport or city name (e.g. 'London', 'New York', 'Tokyo') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-skyscanner-co-in-api-d41780f4/autocomplete \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"is_destination":"<boolean>","query":"<string>"}'
```

### get_price_calendar

Retrieve the cheapest available flight prices for a route across a date range. Returns daily prices with price groupings (low/medium/high). The API returns prices starting from the current date regardless of the month specified. Requires origin and destination entity IDs (from autocomplete) plus their IATA codes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `dest_id` | string | Yes | Destination entity ID from the autocomplete endpoint (e.g. '27544008' for London) |
| `dest_sky_id` | string | Yes | IATA code of the destination airport (e.g. 'LHR' for London Heathrow) |
| `month` | string | Yes | Month for the calendar, 1-12 (e.g. '7' for July) |
| `origin_id` | string | Yes | Origin entity ID from the autocomplete endpoint (e.g. '95565050' for London Heathrow) |
| `origin_sky_id` | string | Yes | IATA code of the origin airport (e.g. 'DEL' for Delhi, 'JFK' for New York JFK) |
| `year` | string | Yes | Year for the calendar in YYYY format (e.g. '2026') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-skyscanner-co-in-api-d41780f4/get_price_calendar \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"dest_id":"<string>","dest_sky_id":"<string>","month":"<string>","origin_id":"<string>","origin_sky_id":"<string>","year":"<string>"}'
```

### search_flights

Search for one-way or return flights between two airports. Returns up to 20 results sorted by score with pricing and leg details. Requires origin and destination entity IDs from the autocomplete endpoint and a future departure date. Optionally accepts a return date for round-trip searches.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `adults` | integer | No | Number of adult passengers |
| `cabin_class` | string | No | Cabin class for the flight search |
| `departure_date` | string | Yes | Departure date in YYYY-MM-DD format (must be a future date) |
| `dest_id` | string | Yes | Destination entity ID from the autocomplete endpoint (e.g. '95565050' for London Heathrow) |
| `origin_id` | string | Yes | Origin entity ID from the autocomplete endpoint (e.g. '95673498' for New Delhi) |
| `return_date` | string | No | Return date in YYYY-MM-DD format. Omit for one-way flights. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-skyscanner-co-in-api-d41780f4/search_flights \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"adults":"<integer>","cabin_class":"<string>","departure_date":"<string>","dest_id":"<string>","origin_id":"<string>","return_date":"<string>"}'
```