The Piloterr Expedia Scraper API lets you extract public data from Expedia as clean, structured JSON — no proxies, headless browsers or HTML parsing to maintain. Endpoints available in production:
- Expedia Ad API — Fetch one Expedia hotel from its information URL: name, postal address, and amenity groups.
- Expedia Flight API — Search Expedia flights by airport route and dates, or by a flight search URL.
- Expedia Search API — Execute a hotel search on Expedia using a direct search URL and receive structured hotel listings with prices, ratings, and availability.
Use it for price tracking, review and reputation monitoring, local market research or logistics tracking.
| Endpoint | Path | Credits | What you get |
|---|---|---|---|
| Expedia Ad API | /v2/expedia/ad |
2 | Fetch one Expedia hotel from its information URL |
| Expedia Flight API | /v2/expedia/flight |
2 | Search Expedia flights by airport route and dates, or by a flight search URL. Each offer includes the airline, times, stops, and displayed price. |
| Expedia Search API | /v2/expedia/search |
2 | Execute a hotel search on Expedia using a direct search URL and receive structured hotel listings with prices, ratings, and availability. |
- How it works
- Expedia Ad API
- Expedia Flight API
- Expedia Search API
- Code examples in other languages
- Practical use cases
- Why Piloterr?
- FAQ
- Related scrapers
- Support
- Create a free Piloterr account and copy your API key from the dashboard.
- Send a
GET(orPOST) request tohttps://api.piloterr.com/v2/...with the headerx-api-key: YOUR_API_KEY. - Receive structured JSON — Piloterr handles rendering, proxies, retries and parsing.
export PILOTERR_API_KEY="your-api-key"
pip install requests # Python
# TypeScript: Node.js 18+ (native fetch), run with `npx tsx file.ts`Every endpoint accepts both
GET(query string) andPOST(JSON body with the same fields).
Fetch one Expedia hotel from its information URL: name, postal address, and amenity groups.
GET | POST https://api.piloterr.com/v2/expedia/ad · 2 credits per request · Full reference
| Parameter | Type | Required | Description |
|---|---|---|---|
query |
string | ✅ | An Expedia hotel information URL. The response is one flat hotel. hotel_id comes from .h{id}.Hotel-Information when that pattern is in the URL, and is null otherwise. A destination, a non-Expedia URL, or an empty value r… |
import json
import os
import requests
response = requests.get(
"https://api.piloterr.com/v2/expedia/ad",
headers={"x-api-key": os.environ["PILOTERR_API_KEY"]},
params={
"query": "https://www.expedia.com/New-York-Hotels-Hilton-New-York-Fashion-District.h3117215.Hotel-Information",
},
timeout=60,
)
response.raise_for_status()
data = response.json()
print(json.dumps(data, indent=2, ensure_ascii=False)[:2000])type ExpediaAd = {
url?: string;
name?: string;
address?: {
city?: string;
region?: string;
street?: string;
country?: string;
postal_code?: string;
};
hotel_id?: string;
amenities?: {
name?: string;
items?: string[];
}[];
};
const params = new URLSearchParams({
"query": "https://www.expedia.com/New-York-Hotels-Hilton-New-York-Fashion-District.h3117215.Hotel-Information",
});
const response = await fetch(`https://api.piloterr.com/v2/expedia/ad?${params}`, {
headers: { "x-api-key": process.env.PILOTERR_API_KEY! },
});
if (!response.ok) throw new Error(`Piloterr error ${response.status}: ${await response.text()}`);
const data = (await response.json()) as ExpediaAd;
console.log(JSON.stringify(data, null, 2).slice(0, 2000));POST variant
POST https://api.piloterr.com/v2/expedia/ad
x-api-key: YOUR_API_KEY
Content-Type: application/json
{"query": "https://www.expedia.com/New-York-Hotels-Hilton-New-York-Fashion-District.h3117215.Hotel-Information"}Example response from the API reference, abridged — real values depend on the page you scrape.
{
"url": "https://www.expedia.com/New-York-Hotels-Hilton-New-York-Fashion-District.h3117215.Hotel-Information",
"name": "Hilton New York Fashion District",
"address": {
"city": "New York",
"region": "NY",
"street": "152 W 26th Street",
"country": "USA",
"postal_code": "10001"
},
"hotel_id": "3117215",
"amenities": [
{
"name": "Internet",
"items": [
"Available in all rooms: Free WiFi"
]
}
]
}| Field | Type | Description |
|---|---|---|
url |
string | |
name |
string | |
address |
object | |
address.city |
string | |
address.region |
string | |
address.street |
string | |
address.country |
string | |
address.postal_code |
string | |
hotel_id |
string | |
amenities[] |
object[] | |
amenities[].name |
string | |
amenities[].items |
string[] |
Search Expedia flights by airport route and dates, or by a flight search URL. Each offer includes the airline, times, stops, and displayed price.
GET | POST https://api.piloterr.com/v2/expedia/flight · 2 credits per request · Full reference
| Parameter | Type | Required | Description |
|---|---|---|---|
query |
string | ✅ | A route or a full Expedia Flights-Search URL. Empty, a route without two airport codes, or a non-Expedia URL returns 400. A full URL is opened as given. price stays the label on the offer. pagination.next is null. |
departure_date |
string | — | Departure as YYYY-MM-DD for a route. Omit it and the route uses 2026-11-15. A value that is not YYYY-MM-DD returns 400. Ignored when query is a full URL. |
return_date |
string | — | Return date as YYYY-MM-DD. Omit it for a one-way trip. A value that is not YYYY-MM-DD returns 400. Ignored when query is a full URL. |
adults |
number | — | Adult passengers for a route. Omit it and the request uses 1. Ignored when query is a full URL. |
cabin_class |
string | — | Label copied onto every result as cabin_class. Omit it and each result uses economy. It does not add a cabin filter to the Expedia URL. |
region |
string | — | Host for a route. Omit it for www.expedia.com. Allowed: us, ca, uk, au, fr, de, es, it, nl, mx. Any other value returns 400. Ignored when query is a full URL. |
import json
import os
import requests
response = requests.get(
"https://api.piloterr.com/v2/expedia/flight",
headers={"x-api-key": os.environ["PILOTERR_API_KEY"]},
params={
"query": "JFK-LAX",
},
timeout=60,
)
response.raise_for_status()
data = response.json()
print(json.dumps(data, indent=2, ensure_ascii=False)[:2000])type ExpediaFlight = {
results?: {
price?: string;
stops?: string;
origin?: string;
airline?: string;
duration?: string;
cabin_class?: string;
destination?: string;
arrival_time?: string;
departure_time?: string;
}[];
pagination?: {
next?: unknown;
page?: number;
per_page?: number;
total_pages?: unknown;
total_results?: unknown;
};
};
const params = new URLSearchParams({
"query": "JFK-LAX",
});
const response = await fetch(`https://api.piloterr.com/v2/expedia/flight?${params}`, {
headers: { "x-api-key": process.env.PILOTERR_API_KEY! },
});
if (!response.ok) throw new Error(`Piloterr error ${response.status}: ${await response.text()}`);
const data = (await response.json()) as ExpediaFlight;
console.log(JSON.stringify(data, null, 2).slice(0, 2000));POST variant
POST https://api.piloterr.com/v2/expedia/flight
x-api-key: YOUR_API_KEY
Content-Type: application/json
{"query": "JFK-LAX"}Example response from the API reference, abridged — real values depend on the page you scrape.
{
"results": [
{
"price": "$269",
"stops": "Nonstop",
"origin": "JFK",
"airline": "Delta",
"duration": "6h 13m",
"cabin_class": "economy",
"destination": "LAX",
"arrival_time": "6:33pm",
"departure_time": "3:20pm"
}
],
"pagination": {
"next": null,
"page": 1,
"per_page": 1,
"total_pages": null,
"total_results": null
}
}| Field | Type | Description |
|---|---|---|
results[] |
object[] | |
results[].price |
string | |
results[].stops |
string | |
results[].origin |
string | |
results[].airline |
string | |
results[].duration |
string | |
results[].cabin_class |
string | |
results[].destination |
string | |
results[].arrival_time |
string | |
results[].departure_time |
string | |
pagination |
object | |
pagination.next |
object | |
pagination.page |
integer | |
pagination.per_page |
integer | |
pagination.total_pages |
object | |
pagination.total_results |
object |
Execute a hotel search on Expedia using a direct search URL and receive structured hotel listings with prices, ratings, and availability.
GET | POST https://api.piloterr.com/v2/expedia/search · 2 credits per request · Full reference
| Parameter | Type | Required | Description |
|---|---|---|---|
query |
string | ✅ | A valid Expedia hotel search URL. Copy the URL directly from your Expedia search results page. |
import json
import os
import requests
response = requests.get(
"https://api.piloterr.com/v2/expedia/search",
headers={"x-api-key": os.environ["PILOTERR_API_KEY"]},
params={
"query": "https://euro.expedia.net/Hotel-Search?currency=EUR&siteid=4400&destination=Toulouse",
},
timeout=60,
)
response.raise_for_status()
data = response.json()
print(json.dumps(data, indent=2, ensure_ascii=False)[:2000])type ExpediaSearch = {
results?: {
name?: string;
location?: string;
room_info?: string;
taxes_info?: string;
description?: string;
rating_text?: string;
star_rating?: number;
is_sponsored?: boolean;
rating_score?: number;
current_price?: number;
reviews_count?: number;
discount_badge?: unknown;
special_offers?: string[];
taxes_included?: boolean;
rating_category?: string;
current_price_text?: string;
}[];
};
const params = new URLSearchParams({
"query": "https://euro.expedia.net/Hotel-Search?currency=EUR&siteid=4400&destination=Toulouse",
});
const response = await fetch(`https://api.piloterr.com/v2/expedia/search?${params}`, {
headers: { "x-api-key": process.env.PILOTERR_API_KEY! },
});
if (!response.ok) throw new Error(`Piloterr error ${response.status}: ${await response.text()}`);
const data = (await response.json()) as ExpediaSearch;
console.log(JSON.stringify(data, null, 2).slice(0, 2000));POST variant
POST https://api.piloterr.com/v2/expedia/search
x-api-key: YOUR_API_KEY
Content-Type: application/json
{"query": "https://euro.expedia.net/Hotel-Search?currency=EUR&siteid=4400&destination=Toulouse"}Example response from the API reference, abridged — real values depend on the page you scrape.
{
"results": [
{
"name": "Campanile Toulouse Sud - Labege Innopole",
"location": "Labege",
"room_info": "for 1 room",
"taxes_info": "includes taxes & fees",
"description": "Tranquil stay near Citè de l'Espace - Embrace serenity with a garden terrace, French cuisine, and eco-friendly comforts. Enjoy premium be…",
"rating_text": "Very good",
"star_rating": 3,
"is_sponsored": false,
"rating_score": 8.4,
"current_price": 63,
"reviews_count": 497,
"discount_badge": null,
"special_offers": [
"Fully refundable",
"Reserve now, pay later"
],
"taxes_included": true,
"rating_category": "excellent",
"current_price_text": "€63"
},
{
"name": "Appart Hotel Odalys City Centre Compans Caffarelli",
"location": "Toulouse City-Centre",
"room_info": "for 1 room",
"taxes_info": "includes taxes & fees",
"rating_text": "Wonderful",
"star_rating": 3,
"is_sponsored": false,
"rating_score": 9.2,
"current_price": 71,
"reviews_count": 355,
"discount_badge": "26% off",
"original_price": 96,
"special_offers": null,
"taxes_included": true,
"rating_category": "excellent",
"current_price_text": "€71",
"original_price_text": "€96"
}
]
}| Field | Type | Description |
|---|---|---|
results[] |
object[] | |
results[].name |
string | |
results[].location |
string | |
results[].room_info |
string | |
results[].taxes_info |
string | |
results[].description |
string | |
results[].rating_text |
string | |
results[].star_rating |
integer | |
results[].is_sponsored |
boolean | |
results[].rating_score |
number | |
results[].current_price |
integer | |
results[].reviews_count |
integer | |
results[].discount_badge |
object | |
results[].special_offers |
string[] | |
results[].taxes_included |
boolean | |
results[].rating_category |
string | |
results[].current_price_text |
string |
Ready-to-run examples live in the examples/ folder. Each one reads your key from the PILOTERR_API_KEY environment variable.
| Language | Ad | Flight | Search |
|---|---|---|---|
| cURL (Bash) | ad |
flight |
search |
| PHP | ad |
flight |
search |
| C# | ad |
flight |
search |
| Go | ad |
flight |
search |
| Java | ad |
flight |
search |
| Ruby | ad |
flight |
search |
| Node.js | ad |
flight |
search |
- Price tracking — Monitor rates and offers over time.
- Reputation monitoring — Track ratings and reviews of venues and competitors.
- Local market research — Map businesses, venues and events by area.
- Logistics visibility — Follow shipments and statuses where available.
- Travel products — Power comparison tools and alerts with structured data.
- No infrastructure — no proxies, headless browsers or CAPTCHA solving to run yourself.
- Structured JSON — stable, documented fields instead of brittle HTML selectors.
- Pay per request — transparent credit cost per endpoint, failed requests are retried for you.
- One API key, hundreds of sources — Expedia plus many other e-commerce, search and company data endpoints in the Piloterr library.
- Any language — plain HTTPS + JSON, with examples for Python, TypeScript, cURL, PHP, C#, Go, Java, Ruby and Node.js.
Collecting publicly available data is generally allowed in many jurisdictions, but rules depend on your country, the data you collect and how you use it. Avoid personal data unless you have a lawful basis, respect the website's terms where they apply, and get legal advice for your specific use case. This is not legal advice.
No. Piloterr handles rendering, proxy rotation and retries on its side. You only send an HTTPS request with your x-api-key header and receive JSON.
Credits per call: /v2/expedia/ad 2, /v2/expedia/flight 2, /v2/expedia/search 2. See the Piloterr website for plans.
Each endpoint returns structured JSON: Expedia Ad — url, name, address, address.city, address.region, address.street; Expedia Flight — results[], results[].price, results[].stops, results[].origin, results[].airline, results[].duration; Expedia Search — results[], results[].name, results[].location, results[].room_info, results[].taxes_info, results[].description.
Yes, use region — see the parameter tables above for accepted values.
Any language that can make an HTTP request. This README shows Python and TypeScript; the examples/ folder contains cURL, PHP, C#, Go, Java, Ruby and Node.js.
- Auto Europe Scraper API
- Eventbrite Scraper API
- Maersk Scraper API
- TheFork Scraper API
- Yelp Scraper API
- All Piloterr scrapers on GitHub
- 💬 Join the Piloterr Discord to ask questions and share what you build.
- 📚 Browse the API reference (OpenAPI) and the Piloterr library.
- 🔑 Get your API key.
Built by Piloterr — web scraping APIs for e-commerce, search, real estate and more, one API key.
Expedia is a trademark of its respective owner. This repository is not affiliated with or endorsed by Expedia. Examples are released under the MIT license.
