# Expedia Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/expedia/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 2 credits per call |
| **Documentation** | https://www.piloterr.com/library/expedia-search |

## Description

Execute a hotel search on Expedia using a direct search URL and receive structured hotel listings with prices, ratings, and availability.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/expedia/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search hotels in Toulouse, France

```json
{
  "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 bedding and free WiFi.",
      "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"
    },
    {
      "name": "The Social Hub Toulouse",
      "location": "Toulouse City-Centre",
      "room_info": "for 1 room",
      "taxes_info": "includes taxes & fees",
      "rating_text": "Wonderful",
      "star_rating": 4,
      "is_sponsored": false,
      "rating_score": 9,
      "current_price": 93,
      "reviews_count": 275,
      "discount_badge": "33% off",
      "original_price": 139,
      "special_offers": null,
      "taxes_included": true,
      "rating_category": "excellent",
      "current_price_text": "€93",
      "original_price_text": "€139"
    }
  ]
}
```

## Documentation

## Overview
The Expedia Search endpoint takes any Expedia hotel search URL and returns structured hotel listings from the search results, including prices, ratings, and availability.

## Quickstart
```
GET https://api.piloterr.com/v2/expedia/search?query=https://euro.expedia.net/Hotel-Search?currency=EUR%26siteid=4400
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | A valid Expedia hotel search URL |

## Response fields
| Field | Type | Description |
|---|---|---|
| `results[].name` | string | Hotel name |
| `results[].star_rating` | number | Star rating (1–5) |
| `results[].rating_score` | number | Guest review score |
| `results[].current_price` | number | Price per night |
| `results[].discount_badge` | string \| null | Discount label |
| `results[].special_offers` | array \| null | Available offers |

## Notes
- URL-encode `&` as `%26` when passing Expedia URLs.
- Results reflect real-time availability.

## Main use cases
- Build travel comparison tools aggregating hotel prices from Expedia
- Monitor competitor hotel pricing for travel industry analytics
- Automate travel expense reporting with structured hotel data
- Power travel recommendation engines with live Expedia listings