# Skyscanner (Germany) — 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 across multiple airlines, view real-time pricing, and discover the cheapest travel dates with daily and monthly price calendars. Autocomplete destination suggestions to quickly find and compare flight options for your next trip.

**Category:** Travel | **Website:** [skyscanner.de/](https://skyscanner.de/) | **Docs:** [parse.bot/marketplace/48cdd1db-622d-49a5-a1ba-53aaa861f612/skyscanner-de-api](https://parse.bot/marketplace/48cdd1db-622d-49a5-a1ba-53aaa861f612/skyscanner-de-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-de-api-48cdd1db/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_price_calendar

Get a daily price calendar showing the cheapest flight price for each day on a given route. Returns prices grouped into low/medium/high categories with exact EUR amounts. Covers approximately the next 2-3 months of dates from today. The origin and destination accept Skyscanner place codes from the autocomplete endpoint.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `destination` | string | Yes | Destination airport or city place code from autocomplete (e.g. 'LOND', 'PARI', 'NYCA') |
| `origin` | string | Yes | Origin airport or city place code from autocomplete (e.g. 'BER', 'FRA', 'MUC') |

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

### get_price_calendar_month

Get a monthly overview of cheapest flight prices for a given route across approximately the next 12 months. Each month shows the lowest available price and a price category (LOW, LOWEST, or UNSPECIFIED). Internally resolves place codes to city-level entity IDs. The origin and destination accept Skyscanner place codes from the autocomplete endpoint.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `destination` | string | Yes | Destination airport or city place code from autocomplete (e.g. 'LOND', 'PARI', 'NYCA') |
| `origin` | string | Yes | Origin airport or city place code from autocomplete (e.g. 'BER', 'FRA', 'MUC') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-skyscanner-de-api-48cdd1db/get_price_calendar_month \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"destination":"<string>","origin":"<string>"}'
```

### search_flights

Search for one-way flights for a given origin, destination, and departure date. Resolves place codes to entity IDs internally and queries the Skyscanner unified search API. Returns all available flight itineraries with airline, price, departure/arrival times, duration, and booking options. Results include filter statistics (cheapest direct/stopover prices, available airlines, layover airports). The origin and destination accept Skyscanner place codes from the autocomplete endpoint (e.g. 'BER' for Berlin Brandenburg airport, 'LOND' for London city).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | Yes | Departure date in YYYY-MM-DD format (e.g. '2026-07-15') |
| `destination` | string | Yes | Destination airport or city place code from autocomplete (e.g. 'LOND', 'PARI', 'NYCA') |
| `origin` | string | Yes | Origin airport or city place code from autocomplete (e.g. 'BER', 'FRA', 'MUC') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-skyscanner-de-api-48cdd1db/search_flights \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","destination":"<string>","origin":"<string>"}'
```

### search_flights_autocomplete

Autocomplete airport, city, or country names from a partial text query. Returns matching places with Skyscanner place codes, city names, country information, and Geo IDs usable as entity identifiers in other endpoints. Results are localized to German (de-DE). The response is a flat list ordered by relevance; no pagination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Partial name of a location to search for (e.g. 'Ber', 'Lond', 'Par') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-skyscanner-de-api-48cdd1db/search_flights_autocomplete \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```
