Query type offers returns a list of all offers that meet search conditions. You can download the first maximum of 1000 items.
| Filed name | Type | Length | Contains |
|---|---|---|---|
| calc_found | int | minimum number of offers returned in count (maximum 1000) | |
| excludeFromRules | text | rule name | |
| external_search_id | text | external search id | |
| extraData | xml | Additional info about offers | |
| geo_xCircle | int | Search in max radius='dstance' (in kilometers) from lat,long | |
| geo_xPolygon | int | Search in polygon described by at least 3 pairs of lat,long | |
| includeFromRules | text | rule name | |
| limit_count | int | Number of records per page (default 10, max 100) | |
| limit_from | int | first record (default 1, max 1000) | |
| maxPrice | int | maximum price for an adult | |
| minPrice | int | minimum price per adult | |
| obj_bookBeds | bool | If reservation on individual beds is possible | |
| obj_category | int | Category of the object multiplied by 10 | |
| obj_xCityFts | text | String allows searching offers by town name | |
| obj_codeNameFts | text | Enabling search of offers based by string name of the hotel | |
| obj_code | char | 20 | hotel code |
| obj_luggage | char | 1 | Info if main baggage is included |
| obj_name | text | The name of the object (the hotel / cruise / circuit / package) | |
| obj_room | char | 5 | Room code/ accommodation |
| obj_tourOpAndCode | char | ${kod_operatora}_${kod_obiektu} | |
| obj_type | char | 3 | Object type (hotel/round trip/cruise /...) |
| obj_xAttributesCount | int | Minimum number of required attributes that match the offer | |
| obj_xAttributesNotIn | bitmask | 64 | Object's attributes / flag offer |
| obj_xAttributes | bitmask | 64 | Object's attributes / flag offer |
| obj_xCityId | text | The city in which the object is assigned by MerlinX (original or revised) | |
| obj_xCode | int | ID assigned to the hotel by MerlinX | |
| obj_xDistBeach | int | Distance from beach | |
| obj_xDistSki | int | Distance from ski lift | |
| obj_xName | text | Object's name that is assigned by MerlinX (original or revised) | |
| obj_xRoomDescCount | int | Minimum number of required Room description that match the offer | |
| data:fields:names:obj_xroomdesc | char | 3 | Room description processed by MerlinX |
| obj_xServiceId | int | ID meal/service assigned by MerlinX | |
| obj_zScoreCnt | int | search based of amount of Zoover opinions | |
| obj_zScore | int | search based of Zoover rating | |
| ofr_candy | bitmask | 64 | Candy (bonus) |
| ofr_catalog | char | 4 | Catalog code |
| ofr_refundable | char | 1 | Offer have some flex rules or not |
| ofr_resident | char | 1 | Resident is available or not |
| ofr_tourOp | char | 4 | touroperator code |
| ofr_transferType | char | 1 | Info if transfer is included |
| ofr_type | char | 2 | Type of offer |
| ofr_xCatalog | char | catalogs unified by MerlinX | |
| ofr_xStatus | char | offer availability | |
| order_by | char | number for sorting | |
| par_adt | int | number of adults | |
| par_chdAge | text | age of children or children bitrh dates | |
| par_chd | int | Number of children | |
| par_inf | int | number of infants | |
| selectAnswerFields | text | fields name | |
| totalPrice | bool | returns the total price for the asked product | |
| trp_depCode | char | 3 | Code of departure location/airport ( IATA Code ) |
| trp_depDate | date | Date of departure / departure / start of trip | |
| trp_depName | text | place of departure / start | |
| trp_depName | text | place of departure / start | |
| trp_destination | int | Region of the trip/event | |
| trp_durationM | int | number of days | |
| trp_duration | int | number of days | |
| trp_flightChangeCount | int | Number of stops for ongoing flight | |
| trp_rDepCode | char | 3 | departure code of the return place |
| trp_rDesCode | char | 3 | destination code of the return trip |
| trp_retDate | date | possible late date of the return trip | |
| trp_rFlightChangeCount | int | Number of stops for return flight | |
| trp_skiDestination | int | Destination regions for ski. | |
| wtr_bi | int | search by forecast biking activities score (1-10) | |
| wtr_b | int | search by forecast beach activities score (1-10) | |
| wtr_c | int | search by forecast camping activities score (1-10) | |
| wtr_pc | int | search by forecast precipitation chance (%) | |
| wtr_p | int | search by forecast precipitation (mm) | |
| wtr_sd | int | search by sun hours duration | |
| wtr_tn | int | search by forecast tennis score (1-10) | |
| wtr_tr | int | search by forecast terrace activities score (1-10) | |
| wtr_t | int | search by forecast temperature ( in degrees Celsius ) | |
| wtr_uv | int | search by UV index | |
| wtr_wk | int | search by forecast walking activities score (1-10) | |
| wtr_wt | int | search by forecast water sports activities score (1-10) | |
| ofr_paxDef | char | All definitions of pax for which a given offer is available | |
| useMerlinMargin | bool | returns price with agency margin |
<?xml version='1.0'?> <mds> <auth> <login>login</login> <pass>pass</pass> </auth> <request> <type>offers</type> <conditions> <ofr_type>F</ofr_type> <par_adt>2</par_adt> <trp_depDate>20101122:20101124</trp_depDate> <obj_codeNameFts>Resort</obj_codeNameFts> </conditions> </request> </mds>
| Field name | Type | Contains | containing |
|---|---|---|---|
| count | int | number of matching results for the given query | |
| extraData | xml | Additional info about offers | |
| obj_acomodation | char | DEPRECIATED! Code assignment, unites the value of the code room and board, used by the booking system | |
| obj_bookBeds | bool | If reservation on individual beds is possible | |
| obj_category | int | Category of the object multiplied by 10 | |
| obj_city | text | The city in which the object is located | |
| obj_code | char | 20 | hotel code |
| obj_country | text | Country | |
| obj_desCode | char | 3 | Usually the airport code serving the area where hotel is located |
| obj_luggage | char | 1 | Info if main baggage is included |
| obj_maxAdt | int | Maximum number of adults [DEPRECATED] | |
| obj_maxPax | int | Maximum number of people [DEPRECATED] | |
| obj_minAdt | int | The minimum number of adults [DEPRECATED] | |
| obj_minPax | int | The minimum number of people [DEPRECATED] | |
| obj_name | text | The name of the object (the hotel / cruise / circuit / package) | |
| obj_rating !!! not available anymore !!! | text | Hotel rating by Zoover system | |
| obj_region | text | The name of the region in which the object is located | |
| obj_roomDesc | text | Description of room / accommodation | |
| obj_room | char | 5 | Room code/ accommodation |
| obj_serviceDesc | text | description of the meals / service | |
| obj_service | char | 2 | Service code/board |
| obj_type | char | 3 | Object type (hotel/round trip/cruise /...) |
| obj_xAttributes | bitmask | 64 | Object's attributes / flag offer |
| obj_xCity | text | The city in which the object is assigned by MerlinX (original or revised) | |
| obj_xCode | int | ID assigned to the hotel by MerlinX | |
| obj_xCountryId | int | ID assigned to a country by MerlinX | |
| obj_xLat | float | Latitude location of the object | |
| obj_xLong | float | Longitude position of the object | |
| obj_xName | text | Object's name that is assigned by MerlinX (original or revised) | |
| obj_xRegionId | int | ID assigned to a region by MerlinX | |
| data:fields:names:obj_xroomdesc | char | 3 | Room description processed by MerlinX |
| obj_xServiceId | int | ID meal/service assigned by MerlinX | |
| obj_xskiregpath | text | Information about ski regions | |
| ofr_candy | bitmask | 64 | Candy (bonus) |
| ofr_catalog | char | 4 | Catalog code |
| ofr_id | char | up to 1 KB | offer identifier. ** IMPORTANT: ** Do not assume that there will always be a hexadecimal string |
| ofr_operCurr | char | 3 | currency used by the operator |
| ofr_operPrice | int | Price per adult in the currency of the operator | |
| ofr_price | int | Price per adult (in the case ofr_operCurr pathologist from PLN should be taken as approximate this value!) | |
| ofr_refundable | char | 1 | Offer have some flex rules or not |
| ofr_resident | char | 1 | Resident is available or not |
| ofr_status | char | 2 | last known status/availability of offers |
| ofr_sweet | bool | Candy - promoted flag ads (provided by the operator) | |
| ofr_TFGincluded | bool | returns the price including TFG | |
| ofr_tourOp | char | 4 | touroperator code |
| ofr_transferType | char | 1 | Info if transfer is included |
| ofr_type | char | 2 | Type of offer |
| ofr_xCatalog | char | catalogs unified by MerlinX | |
| room_hash | char | Hotel room id | |
| trp_desDesc | text | place of trip/ directions | |
| trp_arrTime | time | times of trip / directions | |
| trp_busStopDesc | text | Description of the bus stop | |
| trp_busStop | text | ||
| trp_carrierCode | text | carrier code and flight number (if both of the information is available) | |
| trp_carrierDesc | text | Name of carrier | |
| trp_depCode | char | 3 | Code of departure location/airport ( IATA Code ) |
| trp_depDate | date | Date of departure / departure / start of trip | |
| trp_depName | text | place of departure / start | |
| trp_depName | text | place of departure / start | |
| trp_depTime | time | time of departure / start | |
| trp_desCode | char | 3 | Code of destination location/airport ( IATA Code ) |
| trp_desDate | date | date of reach the destination | |
| trp_durationM | int | number of days | |
| trp_duration | int | number of days | |
| trp_flightCode | char | 20 | service code for flight / transport |
| trp_flightOp | text | flight operator name | |
| trp_flightChangeCount | int | Number of stops for ongoing flight | |
| trp_rArrTime | time | time of arrival of the return trip | |
| trp_rCarrierCode | text | carrier code and flight number of return (if both information is available) | |
| trp_rDepCode | char | 3 | departure code of the return place |
| trp_rDepDate | date | Departure date of the return trip | |
| trp_rDepTime | time | Departure time of the return trip | |
| trp_rDesCode | char | 3 | destination code of the return trip |
| trp_rDesDate | date | Date of return | |
| trp_rFlightCode | char | 20 | service code of the return flight / transport (information can be included also in the field trp_flightCode) |
| trp_rFlightChangeCount | int | Number of stops for return flight | |
| trp_season | char | 2 | |
| trp_startDate | date | Tour start date | |
| trp_stay | int | number of nights | |
| trp_tourCode | char | 20 | |
| trp_type2 | char | 2 | supplement field trp_type |
| trp_type | char | 2 | service type of transport (plane / bus /...) |
| wtr_val | text | weather value | |
| wtr | text | Weather information | |
| ofr_paxDef | char | All definitions of pax for which a given offer is available |
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <response> <ofr id="cafc9c55c61765013b70f7c3fa763f2e219a9fdeb566ece37793980eba3ab128" catalog="MADA" tourOp="MADA" type="H" sweet="0" status="BA" operPrice="25" operCurr="PLN" price="25"> <obj name="Tatralandia - tydzień w aquaparku" city="Liptov" category="30" code="193" room="193" service="I" roomDesc="Apartament 2+2" minPax="1" maxPax="4" minAdt="1" maxAdt="4" xCode="-924" region="Kotlina Liptowska" acomodation="" attributes="(nil)" type="H" serviceDesc="śniadania kolacje" serviceId="1" country="Słowacja" bookBeds="0" rating="" desCode="a59" xName="Tatralandia - tydzień w aquaparku" xCity="Liptov" lat="" long=""/> <trp desCode="" depCode="" depDate="20101112" duration="7" flightCode="" carrierCode="" rFlightCode="" rCarrierCode="" depTime="0000" arrTime="0000" rDepTime="0000" rArrTime="0000" type="" type2="" dstCode="428_3456" depDesc="" desDesc="" rDepDate="20101119" desDate="20101112" rDesDate="20101119" rDepCode="" rDesCode="" startDate="20101112" tourCode="" busStop="" durationM="7" season="0" busStopDesc="" flightOp="" stay=""/> </ofr> <ofr id="18a71e7373561ad94fa984291669596d219a9fdeb566ece37793980eba3ab128" catalog="MADA" tourOp="MADA" type="H" sweet="0" status="BA" operPrice="25" operCurr="PLN" price="25"> <obj name="Tatralandia - tydzień w aquaparku" city="Liptov" category="30" code="193" room="218" service="I" roomDesc="Apartament 5 os" minPax="1" maxPax="5" minAdt="1" maxAdt="5" xCode="-924" region="Kotlina Liptowska" acomodation="" attributes="(nil)" type="H" serviceDesc="śniadania kolacje" serviceId="1" country="Słowacja" bookBeds="0" rating="" desCode="a59" xName="Tatralandia - tydzień w aquaparku" xCity="Liptov" lat="" long=""/> <trp desCode="" depCode="" depDate="20101112" duration="7" flightCode="" carrierCode="" rFlightCode="" rCarrierCode="" depTime="0000" arrTime="0000" rDepTime="0000" rArrTime="0000" type="" type2="" dstCode="428_3456" depDesc="" desDesc="" rDepDate="20101119" desDate="20101112" rDesDate="20101119" rDepCode="" rDesCode="" startDate="20101112" tourCode="" busStop="" durationM="7" season="0" busStopDesc="" flightOp="" stay=""/> </ofr> (...) <count>15427</count> </response>