Skip to main content
POST
Search hotels, restaurants and attractions
Searches hotels, restaurants and attractions.

Request

query is required.

Response

If successful, the response body contains the standard envelope. data.results[] contains the places, each with its type, address and link. The following example is a real response, truncated: each list shows one item and long strings are cut.
For every field, see the response schema on this page.

Optional parameters

Billing

Each successful request consumes 1 credit, regardless of the number of items returned. Requests that fail, or that return no items, are not billed.

Pagination

This method is not paginated. A single request returns the complete result.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
query
string
required
Required string length: 2 - 200
type
enum<string>
default:all
Available options:
all,
hotels,
restaurants,
attractions,
geos
location
string
Required string length: 2 - 200

Response

The data, and the credits this call used.

success
any
required
data
object
required
creditsUsed
integer
required
requestId
string
required