Перейти к содержимому
API для партнёров

OffersService_GetResults

GET
/api/json/hotels/propertyId/getResults
curl --request GET \
--url 'https://dictionary.example.invalid/api/json/hotels/propertyId/getResults?propertyId=DEMO_VALUE&currency=DEMO_VALUE&maxGuests=1&guestsChildrens=1&dateBegin=DEMO_VALUE&dateEnd=DEMO_VALUE&distributionType=DEMO_VALUE&distributionPlatform=DEMO_VALUE&distributionCustomerType=DEMO_VALUE&offset=1&count=1&sortings=DEMO_VALUE&cheap=1&fast=1&filters.bbox.ne.lat=1&filters.bbox.ne.lng=1&filters.bbox.sw.lat=1&filters.bbox.sw.lng=1&filters.maxGuests=1&filters.guestsChildrens=1&filters.relevance=DEMO_VALUE&filters.dateBegin=DEMO_VALUE&filters.dateEnd=DEMO_VALUE&filters.currencyId=DEMO_VALUE&filters.isFavorites=true&filters.useBonuses=1&filters.distributionType=DEMO_VALUE&filters.distributionPlatform=DEMO_VALUE&filters.distributionCustomerType=DEMO_VALUE&filters.price=DEMO_VALUE&filters.pets=true&filters.isSuperguest=true&filters.bookingNow=1&filters.hasDiscount=1&filters.superguestFeatures=1&filters.fireplace=1&filters.christmasTree=1&filters.isApartment=1&filters.isHouse=1&filters.isRoom=1&filters.isHotel=1&filters.isAparthotel=1&filters.isMini=1&filters.isGuesthouse=1&filters.isGlRec=1&filters.isBed=1&filters.separateBedrooms=1&filters.isStudio=1&filters.distanceToSea=1&filters.countAllBeds=1&filters.countDoubleBeds=1&filters.smoking=1&filters.party=1&filters.freeBabies=1&filters.withoutDeposit=1&filters.wifi=1&filters.condition=1&filters.kitchen=1&filters.refrigerator=1&filters.balcony=1&filters.babyBed=1&filters.washmachine=1&filters.tv=1&filters.kettle=1&filters.crockery=1&filters.microwave=1&filters.oven=1&filters.stove=1&filters.towels=1&filters.iron=1&filters.hairdryer=1&filters.jacuzzi=1&filters.sauna=1&filters.dishwasher=1&filters.multicooker=1&filters.terrace=1&filters.wheater=1&filters.parking=1&filters.arbor=1&filters.barbecue=1&filters.pool=1&filters.playground=1&filters.lastFloor=1&filters.notLastFloor=1&filters.notFirstFloor=1&filters.notGroundFloor=1&filters.viewSeas=1&filters.viewMountains=1&filters.viewRiverLake=1&filters.viewCity=1&filters.hasBreakfast=1&filters.hasHalfBoard=1&filters.hasFullBoard=1&filters.hasAllInclusive=1&filters.ownBathroom=1&filters.ownToilet=1&filters.shower=1&filters.lift=1&filters.isDis=1&filters.faster=1&filters.superhost=1&filters.transfer=1&filters.hasReview=1&filters.checkInEarly=1&filters.checkOutLate=1&filters.fullPrecost=1&filters.isSelfIn=1&filters.documents=1&filters.withoutIntermediaries=1&filters.isolation=1&filters.hasVideo=1&filters.propertyIds=DEMO_VALUE&filters.stars=1&filters.metro=1&filters.ropewayDistance=1&filters.placeId=DEMO_VALUE&filters.area=1&filters.floor=1&filters.reviewScore=1&filters.pricePer=1&filters.locationId=DEMO_VALUE&filters.locationType=DEMO_VALUE'

GetResults retrieves all offers for a property by property-page search filters This is used for the Property Detail Page (PDP)

propertyId
string

Property_id (string, required) - ID of the property/apartment

Example

DEMO_VALUE
currency
string

Currency (string, required) - Currency for price display

Example

DEMO_VALUE
maxGuests
integer format: int32

Example

1
guestsChildrens
Array<integer>

Example

[
1
]
dateBegin
string

Example

DEMO_VALUE
dateEnd
string

Example

DEMO_VALUE
distributionType
string

Example

DEMO_VALUE
distributionPlatform
string

Example

DEMO_VALUE
distributionCustomerType
string

Example

DEMO_VALUE
offset
integer format: int32

Example

1
count
integer format: int32

Example

1
sortings
string

Example

DEMO_VALUE
cheap
integer format: int32

Example

1
fast
integer format: int32

Example

1
filters.bbox.ne.lat
number format: double

Example

1
filters.bbox.ne.lng
number format: double

Example

1
filters.bbox.sw.lat
number format: double

Example

1
filters.bbox.sw.lng
number format: double

Example

1
filters.maxGuests
integer format: int32

Example

1
filters.guestsChildrens
Array<integer>

Example

[
1
]
filters.relevance
string

Example

DEMO_VALUE
filters.dateBegin
string

Example

DEMO_VALUE
filters.dateEnd
string

Example

DEMO_VALUE
filters.currencyId
string

Example

DEMO_VALUE
filters.isFavorites
boolean

Example

true
filters.useBonuses
number format: float

Example

1
filters.distributionType
string

Example

DEMO_VALUE
filters.distributionPlatform
string

Example

DEMO_VALUE
filters.distributionCustomerType
string

Example

DEMO_VALUE
filters.price
string

Example

DEMO_VALUE
filters.pets
boolean

Example

true
filters.isSuperguest
boolean

Example

true
filters.bookingNow
integer format: int32

Example

1
filters.hasDiscount
integer format: int32

Example

1
filters.superguestFeatures
integer format: int32

Example

1
filters.fireplace
integer format: int32

Example

1
filters.christmasTree
integer format: int32

Example

1
filters.isApartment
integer format: int32

Example

1
filters.isHouse
integer format: int32

Example

1
filters.isRoom
integer format: int32

Example

1
filters.isHotel
integer format: int32

Example

1
filters.isAparthotel
integer format: int32

Example

1
filters.isMini
integer format: int32

Example

1
filters.isGuesthouse
integer format: int32

Example

1
filters.isGlRec
integer format: int32

Example

1
filters.isBed
integer format: int32

Example

1
filters.separateBedrooms
integer format: int32

Example

1
filters.isStudio
integer format: int32

Example

1
filters.distanceToSea
integer format: int32

Example

1
filters.countAllBeds
integer format: int32

Example

1
filters.countDoubleBeds
integer format: int32

Example

1
filters.smoking
integer format: int32

Example

1
filters.party
integer format: int32

Example

1
filters.freeBabies
integer format: int32

Example

1
filters.withoutDeposit
integer format: int32

Example

1
filters.wifi
integer format: int32

Example

1
filters.condition
integer format: int32

Example

1
filters.kitchen
integer format: int32

Example

1
filters.refrigerator
integer format: int32

Example

1
filters.balcony
integer format: int32

Example

1
filters.babyBed
integer format: int32

Example

1
filters.washmachine
integer format: int32

Example

1
filters.tv
integer format: int32

Example

1
filters.kettle
integer format: int32

Example

1
filters.crockery
integer format: int32

Example

1
filters.microwave
integer format: int32

Example

1
filters.oven
integer format: int32

Example

1
filters.stove
integer format: int32

Example

1
filters.towels
integer format: int32

Example

1
filters.iron
integer format: int32

Example

1
filters.hairdryer
integer format: int32

Example

1
filters.jacuzzi
integer format: int32

Example

1
filters.sauna
integer format: int32

Example

1
filters.dishwasher
integer format: int32

Example

1
filters.multicooker
integer format: int32

Example

1
filters.terrace
integer format: int32

Example

1
filters.wheater
integer format: int32

Example

1
filters.parking
integer format: int32

Example

1
filters.arbor
integer format: int32

Example

1
filters.barbecue
integer format: int32

Example

1
filters.pool
integer format: int32

Example

1
filters.playground
integer format: int32

Example

1
filters.lastFloor
integer format: int32

Example

1
filters.notLastFloor
integer format: int32

Example

1
filters.notFirstFloor
integer format: int32

Example

1
filters.notGroundFloor
integer format: int32

Example

1
filters.viewSeas
integer format: int32

Example

1
filters.viewMountains
integer format: int32

Example

1
filters.viewRiverLake
integer format: int32

Example

1
filters.viewCity
integer format: int32

Example

1
filters.hasBreakfast
integer format: int32

Example

1
filters.hasHalfBoard
integer format: int32

Example

1
filters.hasFullBoard
integer format: int32

Example

1
filters.hasAllInclusive
integer format: int32

Example

1
filters.ownBathroom
integer format: int32

Example

1
filters.ownToilet
integer format: int32

Example

1
filters.shower
integer format: int32

Example

1
filters.lift
integer format: int32

Example

1
filters.isDis
integer format: int32

Example

1
filters.faster
integer format: int32

Example

1
filters.superhost
integer format: int32

Example

1
filters.transfer
integer format: int32

Example

1
filters.hasReview
integer format: int32

Example

1
filters.checkInEarly
integer format: int32

Example

1
filters.checkOutLate
integer format: int32

Example

1
filters.fullPrecost
integer format: int32

Example

1
filters.isSelfIn
integer format: int32

Example

1
filters.documents
integer format: int32

Example

1
filters.withoutIntermediaries
integer format: int32

Example

1
filters.isolation
integer format: int32

Example

1
filters.hasVideo
integer format: int32

Example

1
filters.propertyIds
Array<string>

Example

[
"DEMO_VALUE"
]
filters.stars
Array<integer>

Example

[
1
]
filters.metro
Array<integer>

Example

[
1
]
filters.ropewayDistance
Array<integer>

Example

[
1
]
filters.placeId
Array<string>

Example

[
"DEMO_VALUE"
]
filters.area
Array<integer>

Example

[
1
]
filters.floor
Array<integer>

Example

[
1
]
filters.reviewScore
Array<integer>

Example

[
1
]
filters.pricePer
integer format: int32

Example

1
filters.locationId
string

Example

DEMO_VALUE
filters.locationType
string

Example

DEMO_VALUE

OK

Media typeapplication/json

GetPropertyOffersResponse - response with property offers

object
offers

Offers - Array of offers for the property

Array<object>

Offer - Property offer with all details

object
id

Identifiers

string
roomId
string
instantBooking

Main parameters

boolean
labels

Labels

Array<object>

Label - Tariff labels

object
type
string
title
string
price

Price - Array of prices

object
prices
Array<object>

PricesConvertation - Price conversion information

object
amount
number format: double
currencyId
string
type
string
details

LabelDetails - Label details

object
nights
integer format: int32
mbBeforeHours
integer format: int32
prices

Links to objects

object
priceTotal

Price - Array of prices

object
prices
Array<object>

PricesConvertation - Price conversion information

object
amount
number format: double
currencyId
string
type
string
priceBeforeDiscounts

Price - Array of prices

object
prices
Array<object>

PricesConvertation - Price conversion information

object
amount
number format: double
currencyId
string
type
string
bonus

Price - Array of prices

object
prices
Array<object>

PricesConvertation - Price conversion information

object
amount
number format: double
currencyId
string
type
string
meal
Array<object>

Meal - Meal information

object
code
string
externalCode
string
title
string
description
string
mealType

MealType - Meal type information

object
code
string
externalCode
string
title
string
description
string
cancellationPolicies
Array<object>

CancellationPolicy - Cancellation policy

object
type
string
dateBegin
string format: date-time
dateEnd
string format: date-time
price

Price - Array of prices

object
prices
Array<object>

PricesConvertation - Price conversion information

object
amount
number format: double
currencyId
string
type
string
noShowPolicy

NoShowPolicy - No-show policy

object
price

Price - Array of prices

object
prices
Array<object>

PricesConvertation - Price conversion information

object
amount
number format: double
currencyId
string
type
string
dateBegin
string
prePaymentPolicy

PrePaymentPolicy - Prepayment policy

object
required
boolean
effectiveFrom
string
percent
integer format: int32
deadline
string format: date-time
price

Price - Array of prices

object
prices
Array<object>

PricesConvertation - Price conversion information

object
amount
number format: double
currencyId
string
type
string
cashback

Cashback - Cashback information

object
title
string
value
number format: double
surcharges
Array<object>

Surcharge - Individual surcharge

object
name
string
included
boolean
price

Price - Array of prices

object
prices
Array<object>

PricesConvertation - Price conversion information

object
amount
number format: double
currencyId
string
type
string
details

SurchargesDetails - Surcharges details

object
guests
integer format: int32
freeCancellationBefore
string format: date-time
isNonRefundable
boolean

Example

{
"offers": [
{
"id": null,
"roomId": null,
"instantBooking": null,
"labels": null,
"prices": null,
"meal": null,
"cancellationPolicies": null,
"noShowPolicy": null,
"prePaymentPolicy": null,
"cashback": null,
"surcharges": null,
"freeCancellationBefore": null,
"isNonRefundable": null
}
]
}

Default error response

Media typeapplication/json

The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC. Each Status message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the API Design Guide.

object
code

The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].

integer format: int32
message

A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.

string
details

A list of messages that carry the error details. There is a common set of message types for APIs to use.

Array<object>

Contains an arbitrary serialized message along with a @type that describes the type of the serialized message.

object
@type

The type of the serialized message.

string
key
additional properties
any

Example

{
"code": 1,
"message": "DEMO_VALUE",
"details": [
{
"@type": null
}
]
}