Priceline API: Search hotels (v1)

Returns one page of up to 30 hotels for a location, dates and guests, with star rating, guest score, address, nightly price, stay total and cancellation terms. An unknown location is rejected with a 400.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

location*string

location_id from the Locations endpoint (a city, landmark or airport such as CDG), or a priceline.com hotel search link such as https://www.priceline.com/relax/in/3000035827.

Lengthlength <= 1000

checkin*string

Arrival date, YYYY-MM-DD; today or later.

checkout*string

Departure date, YYYY-MM-DD; after checkin and at most 30 nights later.

adults?integer

Adults across all rooms.

Range1 <= value <= 16

Default2

rooms?integer

Rooms to book.

Range1 <= value <= 8

Default1

children?string

Each child's age (0-17), separated by commas. Omit for no children.

Match^(?:\d{1,2}(?:\s*,\s*\d{1,2})*)?$

Lengthlength <= 60

Default""

currency?string

ISO 4217 currency for every price, such as USD, EUR or GBP.

Match^[A-Z]{3}$

Default"USD"

sort?string

recommended (as on priceline.com, with promoted hotels), price (lowest nightly price first), rating (guest rating and review count) or savings (largest discount first).

Default"recommended"

Value in

"recommended"
"price"
"rating"
"savings"

page?integer

One-based page of up to 30 hotels. Prices are live, so a hotel can move between pages from one request to the next.

Range1 <= value <= 200

Default1

curl -X GET "https://example.com/v1/priceline/search?location=3000035827&checkin=2026-12-10&checkout=2026-12-12" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "location": "3000035827",    "checkin": "2026-12-10",    "checkout": "2026-12-12",    "adults": 0,    "rooms": 0,    "children": [      0    ],    "currency": "USD",    "sort": "recommended",    "page": 1,    "page_size": 30,    "total": 2986,    "summary": "2986 hotels in Paris, France",    "has_more": true,    "count": 0,    "express_deals_skipped": 3,    "results": [      {        "hotel_id": "291003",        "name": "Crowne Plaza Paris République By IHG",        "url": "https://www.priceline.com/relax/at/291003/from/20261210/to/20261212/rooms/1/adults/2",        "star_rating": 4,        "star_rating_scale_max": 5,        "brand": "Crowne Plaza",        "brand_owner": "InterContinental Hotels Group",        "street_address": "10, Place De La Republique",        "city": "Paris",        "state_code": null,        "country_code": "FR",        "neighborhood": "Le Marais  - Republique - Hotel de Ville - 3rd Arr.- 11th Arr.",        "latitude": 48.867338,        "longitude": 2.364926,        "review_score": 8.1,        "review_score_scale_max": 10,        "review_count": 525,        "subscores": [          {            "type": "CLEANLINESS",            "label": "Cleanliness",            "score": 8.2          }        ],        "amenities": [          "Free Internet Access",          "Fitness Center",          "Restaurant"        ],        "short_description": "string",        "photo_url": "string",        "is_ad": true,        "price": {          "per_night": 256.35,          "stay_total_amount": 601.94,          "strike_price": null,          "currency": "USD",          "cancellation": "Fully Refundable Rates",          "payment": "Pay Later Available"        }      }    ]  },  "details": {    "reason": "string",    "message": "string"  }}