Hotel Search API

amadeus · Company

Company No Auth Free & Open API

Before using this API, we recommend you read our **[Authorization Guide](https://developers.amadeus.com/self-service/apis-docs/guides/authorization-262)** for more information on how to generate an access token. Please also be aware that our test environment is based on a subset of the production for this API it may change dynamically. For your tests, use big cities like LON (London) or NYC (New-York).

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET getMultiHotelOffers

getMultiHotelOffers

https://api.apis.guru/v2/specs/amadeus.com/amadeus-hotel-search/3.0.8/shopping/hotel-offers?lang=en&adults=1&currency=USD&hotelIds=example&boardType=ROOM_ONLY&priceRange=example&checkInDate=example&bestRateOnly=true&checkOutDate=example&roomQuantity=1&includeClosed=true&paymentPolicy=NONE&countryOfResidence=example

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/amadeus.com/amadeus-hotel-search/3.0.8/shopping/hotel-offers?lang=en&adults=1&currency=USD&hotelIds=example&boardType=ROOM_ONLY&priceRange=example&checkInDate=example&bestRateOnly=true&checkOutDate=example&roomQuantity=1&includeClosed=true&paymentPolicy=NONE&countryOfResidence=example"

import requests
params = {
    "lang": "en",
    "adults": "1",
    "currency": "USD",
    "hotelIds": "example",
    "boardType": "ROOM_ONLY",
    "priceRange": "example",
    "checkInDate": "example",
    "bestRateOnly": "true",
    "checkOutDate": "example",
    "roomQuantity": "1",
    "includeClosed": "true",
    "paymentPolicy": "NONE",
    "countryOfResidence": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/amadeus.com/amadeus-hotel-search/3.0.8/shopping/hotel-offers",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/amadeus.com/amadeus-hotel-search/3.0.8/shopping/hotel-offers');
url.searchParams.set('lang', 'en');
url.searchParams.set('adults', '1');
url.searchParams.set('currency', 'USD');
url.searchParams.set('hotelIds', 'example');
url.searchParams.set('boardType', 'ROOM_ONLY');
url.searchParams.set('priceRange', 'example');
url.searchParams.set('checkInDate', 'example');
url.searchParams.set('bestRateOnly', 'true');
url.searchParams.set('checkOutDate', 'example');
url.searchParams.set('roomQuantity', '1');
url.searchParams.set('includeClosed', 'true');
url.searchParams.set('paymentPolicy', 'NONE');
url.searchParams.set('countryOfResidence', 'example');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/amadeus.com/amadeus-hotel-search/3.0.8/shopping/hotel-offers")
	q := baseURL.Query()
	q.Set("lang", "en")
	q.Set("adults", "1")
	q.Set("currency", "USD")
	q.Set("hotelIds", "example")
	q.Set("boardType", "ROOM_ONLY")
	q.Set("priceRange", "example")
	q.Set("checkInDate", "example")
	q.Set("bestRateOnly", "true")
	q.Set("checkOutDate", "example")
	q.Set("roomQuantity", "1")
	q.Set("includeClosed", "true")
	q.Set("paymentPolicy", "NONE")
	q.Set("countryOfResidence", "example")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/amadeus.com/amadeus-hotel-search/3.0.8/shopping/hotel-offers")
uri.query = URI.encode_www_form({
  "lang" => "en",
  "adults" => "1",
  "currency" => "USD",
  "hotelIds" => "example",
  "boardType" => "ROOM_ONLY",
  "priceRange" => "example",
  "checkInDate" => "example",
  "bestRateOnly" => "true",
  "checkOutDate" => "example",
  "roomQuantity" => "1",
  "includeClosed" => "true",
  "paymentPolicy" => "NONE",
  "countryOfResidence" => "example"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/amadeus.com/amadeus-hotel-search/3.0.8/shopping/hotel-offers?" . http_build_query([
    "lang" => "en",
    "adults" => "1",
    "currency" => "USD",
    "hotelIds" => "example",
    "boardType" => "ROOM_ONLY",
    "priceRange" => "example",
    "checkInDate" => "example",
    "bestRateOnly" => "true",
    "checkOutDate" => "example",
    "roomQuantity" => "1",
    "includeClosed" => "true",
    "paymentPolicy" => "NONE",
    "countryOfResidence" => "example"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET getOfferPricing

https://api.apis.guru/v2/specs/amadeus.com/amadeus-hotel-search/3.0.8/shopping/hotel-offers/{offerId}?lang=en

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/amadeus.com/amadeus-hotel-search/3.0.8/shopping/hotel-offers/{offerId}?lang=en"

import requests
params = {
    "lang": "en"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/amadeus.com/amadeus-hotel-search/3.0.8/shopping/hotel-offers/{offerId}",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/amadeus.com/amadeus-hotel-search/3.0.8/shopping/hotel-offers/{offerId}');
url.searchParams.set('lang', 'en');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/amadeus.com/amadeus-hotel-search/3.0.8/shopping/hotel-offers/{offerId}")
	q := baseURL.Query()
	q.Set("lang", "en")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/amadeus.com/amadeus-hotel-search/3.0.8/shopping/hotel-offers/{offerId}")
uri.query = URI.encode_www_form({
  "lang" => "en"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/amadeus.com/amadeus-hotel-search/3.0.8/shopping/hotel-offers/{offerId}?" . http_build_query([
    "lang" => "en"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗

See official documentation for authentication and setup.

What can you build with Hotel Search API?

Hotel Search API is a Company API. Developers commonly use company APIs for:

enriching CRM records with company firmographics
building lead-generation and prospecting tools
verifying business identity and registration details
monitoring competitors and market intelligence
powering B2B data enrichment pipelines

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Hotel Search API is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide · Learn about API keys · What is REST?

Open documentation ↗