Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

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

Query Parameters

location
string
required

Destination text

Minimum string length: 1
check_in
string
required

Check-in date (YYYY-MM-DD)

Pattern: ^\d{4}-\d{2}-\d{2}$
check_out
string
required

Check-out date (YYYY-MM-DD)

Pattern: ^\d{4}-\d{2}-\d{2}$
adults
string

Number of adults (default 2)

Pattern: ^\d+$
children
string

Number of children (default 0)

Pattern: ^\d+$
children_ages
string

Comma-separated child ages; length must match children

Pattern: ^\d+(,\d+)*$
rooms
string

Number of rooms (default 1)

Pattern: ^\d+$
currency
string

Display currency (ISO 4217)

Pattern: ^[A-Za-z]{3}$
pos_country
string

Point-of-sale market (ISO country code)

Pattern: ^[A-Za-z]{2}$
device
enum<string>

Device profile to emulate

Available options:
desktop,
mobile,
tablet
sort_by
string

Sort order for results

Minimum string length: 1
min_price
string

Minimum per-night price

Pattern: ^\d+$
max_price
string

Maximum per-night price

Pattern: ^\d+$
stars
string

Comma-separated star ratings to include

Pattern: ^[1-5](,[1-5])*$
min_review_score
string

Minimum review score, 1-10

Pattern: ^(10(\.0)?|\d(\.\d)?)$
page
string

Result page number

Pattern: ^\d+$
pages
string

Number of pages to fetch, max 5

Pattern: ^\d+$
timeout_ms
string

Max time to wait, in ms

Pattern: ^\d+$

Response

Structured Agoda search results.

provider
enum<string>
required
Available options:
agoda
page_type
enum<string>
required
Available options:
search
snapshot_at
string<date-time>
required
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
meta_data
object
required
stay
object
required
occupancy
object
required
currency
string | null
required
pos_country
string | null
required
properties
object[]
required
applied_filters
object
required