ParrAPI

Deals and Offers - Content Structure

The 'Deals and Offers’ content is available across all the categories. Please see below more details regarding the deals.


For more information, please do not hesitate to contact us


Features:

  • The Search API results can be filtered by listings having deals (or) filter based on the deal types
  • The Get Product API will return the full details of the deal(s) associated with each listing (Deals are applicable to the product and not the service)
  • The deals are optional, so not all listings will return deals in the API response.
  • A listing can contain a maximum of 3 deals.
  • A deal is valid for a maximum of 3 months.
  • The deal(s) will be removed from the API response once the validity date is reached.
  • The deal tags provide options to filter listings based on the deal tags.


Content Standards:

Field Field Definition Field Format Field Limit Mandatory (Yes/No)
Deal Flag Indicates if the deals & offers exists for the listing Boolean (true or false) n/a n/a
Deal ID Unique reference of the deal ID n/a Yes, if deal exists
Deal Type Type of the deal being offered Attribute ID 10 characters Yes, if deal exists
Deal Name The name of the deal or offer Alphanumeric 55 characters max Yes, if deal exists
Deal Description A broader description of the deal or offer Alphanumeric 350 characters max Yes, if deal exists
Deal Terms Terms and conditions of the deal Alphanumeric 150 characters max Yes, if deal exists
Deal Start Date Start date of the deal Date n/a Yes, if deal exists
Deal End Date End date of the deal Date n/a Yes, if deal exists
Deal URL Website URL for the deal Valid URL n/a No
Deal Tags Pre-defined set of tags for the deal Valid pre-defined attribute(s) n/a No
List of available 'Deal Types' (Attribute):
  • Discount
  • Special Rate
  • Bonus Offer
  • Package
Note:
  • ‘Deal flag’ is a separate field to indicate whether the ‘Deals & offers’ exists for the given listing.
  • The above fields will be returned in the product detail API response only and not applicable to the search API and service API response.

List of available 'Deal Tags' (Attribute):
  • Featured
  • Campaign
  • Do Not Display
Note:
  • Deals Tags are attributes that have entered a specific marketing package or campaign with the ParrAPI.
  • Similarly, the "Do Not Display" deal tag is also for the purpose of ParrAPI filtering. These Tags may not be of relevance to the non-ParrAPI distribution network.


Examples:
Instructions to use Example API calls:

  • Please replace “[KEY]” in the example API calls with your actual distributor API key to view the results.
  • Please replace “[PRODUCT_ID]” in the example API call with the required product id. The product id can be obtained from the Search API response.
Example Search API call to filter the results based on whether the deals exists or not:
API Request https://api.parrapi.com/api/atlas/products?key=[KEY]&additionalQuery=hasDeals:true
Definition &additionalQuery=hasDeals:true - Filter results by products having deals & offers
&additionalQuery=hasDeals:false - Filter results by products that does not have the deals & offers
Additional Info The Search API response will not return the details of the deal. To view the details of the deal for the given product, please use the product detail API call by specifying the product ID obtained from the search API response.
Example Search API call to filter the results based on the deal types:
API Request https://api.parrapi.com/api/atlas/products?key=[KEY]&att=DEALTYPESBONUSOFFER
Definition Find all products having a specific deal type - 'Bonus Offer'
Additional Info
  • You can filter the results by multiple attribtues using a comma separated list (to apply AND condition in the search) or a pipe separated list (to apply an OR condition in th search)
    • Example request payload:
      • &att=DEALTYPESBONUSOFFER,DEALTYPESDISCOUNT,DEALTYPESSPECIALRATE
        • Find all listings containing the deal types - Bonus Offer and Discount and Special Rate
        • Note: A product must have all the given deal types to be considered as a match and returned in the search results
      • &att=DEALTYPESBONUSOFFER|DEALTYPESDISCOUNT|DEALTYPESSPECIALRATE
        • Find all listings containing either one of the deal types - Bonus Offer or Discount or Special Rate
        • Note: A product must have either one of the given deal types to be considered as a match and returned in the search results
  • To view the list of available attributes for deal type, please click here
Example Search API call to filter the results based on the deal tags:
API Request https://api.parrapi.com/api/atlas/products?key=[KEY]&att=DEALTAGSCAMPAIGN
Definition Find all products having a specific deal tag - 'Campaign'
Additional Info
  • You can filter the results by multiple attribtues using a comma separated list (to apply AND condition in the search) or a pipe separated list (to apply an OR condition in th search)
    • Example request payload:
      • &att=DEALTAGSCAMPAIGN,DEALTAGSFEATURED
        • Find all listings containing the deal tags - Campaign and Featured
        • Note: A product must have all the given deal tags to be considered as a match and returned in the search results
      • &att=DEALTAGSCAMPAIGN|DEALTAGSFEATURED|DEALTAGSDONOTDISPLAY
        • Find all listings containing either one of the deal tags - Campaign or Featured or Do Not Display
        • Note: A product must have either one of the given deal tags to be considered as a match and returned in the search results
  • To view the list of available attributes for deal tags, please click here
Example Get Product API call:
API Request https://api.parrapi.com/api/atlas/product?key=[KEY]&productid=[PRODUCT_ID]
Definition Retrieve detailed information for the specified product
Sample Get Product API response payload showing the deals:
XML Output: <deal_flag>true</deal_flag> <deals> <row> <deal_id>5996442e2ba54cf00f2bc3cd</deal_id> <attribute_id_deal_type>Discount</attribute_id_deal_type> <attribute_id_deal_type_description>Discount</attribute_id_deal_type_description> <deal_name>Extra 10% off</deal_name> <deal_description>Book 2 or more nights to receive 10% off</deal_description> <deal_start_date>2020-07-01</deal_start_date> <deal_end_date>2020-09-01</deal_end_date> <deal_terms>Enter the promo code '10OFF' when booking</deal_terms> <deal_url>https://mydeals.com.au/xmas_offer</deal_url> <attribute_id_deal_tag> <row> <attribute_type_id>DEALTAGS</attribute_type_id> <attribute_type_id_description>Deal Tags</attribute_type_id_description> <attribute_id>CAMPAIGN</attribute_id> <attribute_id_description>Campaign</attribute_id_description> </row> </attribute_id_deal_tag> </row> <row> <deal_id>599651691f49ead352d57ff6</deal_id> <attribute_id_deal_type>Bonus Offer</attribute_id_deal_type> <attribute_id_deal_type_description>Bonus Offer</attribute_id_deal_type_description> <deal_name>2 for 1</deal_name> <deal_description>Book 2 people for the price of 1</deal_description> <deal_start_date>2020-08-10</deal_start_date> <deal_end_date>2020-10-10</deal_end_date> <deal_terms>Enter the promo code '2FOR1' when booking</deal_terms> <deal_url>https://mydeals.com.au/new_year_offer</deal_url> <attribute_id_deal_tag> <row> <attribute_type_id>DEALTAGS</attribute_type_id> <attribute_type_id_description>Deal Tags</attribute_type_id_description> <attribute_id>CAMPAIGN</attribute_id> <attribute_id_description>Campaign</attribute_id_description> </row> <row> <attribute_type_id>DEALTAGS</attribute_type_id> <attribute_type_id_description>Deal Tags</attribute_type_id_description> <attribute_id>FEATURED</attribute_id> <attribute_id_description>Featured</attribute_id_description> </row> </attribute_id_deal_tag> </row> </deals>
JSON Output: "dealFlag": "true" "deals": [ { "dealId": "5996519db235c2dd521688f9", "attributeIdDealType": "Special Rate", "attributeIdDealTypeDescription": "Special Rate", "dealName": "Extra 10% off", "dealDescription": "Book 2 or more nights to receive 10% off", "dealStartDate": "2020-07-01", "dealEndDate": "2020-09-01", "dealTerms": "Enter the promo code '10OFF' when booking", "dealUrl": "https://mydeals.com.au/xmas_offer", "attributeIdDealTag": [ { "attributeTypeId": "DEALTAGS", "attributeTypeIdDescription": "Deal Tags", "attributeId": "CAMPAIGN", "attributeIdDescription": "Campaign" } ] }, { "dealId": "5996519db235c2dd521688f9", "attributeIdDealType": "Package", "attributeIdDealTypeDescription": "Package", "dealName": "2 for 1", "dealDescription": "Book 2 people for the price of 1", "dealStartDate": "2020-10-20", "dealEndDate": "2020-11-20", "dealTerms": "Enter the promo code '2FOR1' when booking", "dealUrl": "https://mydeals.com.au/new_year_offer", "attributeIdDealTag": [ { "attributeTypeId": "DEALTAGS", "attributeTypeIdDescription": "Deal Tags", "attributeId": "CAMPAIGN", "attributeIdDescription": "Campaign" }, { "attributeTypeId": "DEALTAGS", "attributeTypeIdDescription": "Deal Tags", "attributeId": "FEATURED", "attributeIdDescription": "Featured" } ] } ]

Static API call:

Attributes for Deal Types:

API Request https://api.parrapi.com/api/atlas/attributes?key=[KEY]&types=DEALTYPES
Definition Retrieve all attributes that belong to the attribute type - "DEAL TYPES"
Sample attributes response payload showing the deals types:
XML Output: <AttributeType> <AttributeTypeId>DEALTYPES</AttributeTypeId> <Description>Deal Types</Description> <Attributes> <AttributeId>BONUSOFFER</AttributeId> <Description>Bonus Offer</Description> </Attributes> <Attributes> <AttributeId>DISCOUNT</AttributeId> <Description>Discount</Description> </Attributes> <Attributes> <AttributeId>PACKAGE</AttributeId> <Description>Package</Description> </Attributes> <Attributes> <AttributeId>SPECIALRATE</AttributeId> <Description>Special Rate</Description> </Attributes> </AttributeType>
JSON Output: [ { "AttributeTypeId": "DEALTYPES", "Description": "Deal Types", "Attributes": [ { "AttributeId": "BONUSOFFER", "Description": "Bonus Offer" }, { "AttributeId": "DISCOUNT", "Description": "Discount" }, { "AttributeId": "PACKAGE", "Description": "Package" }, { "AttributeId": "SPECIALRATE", "Description": "Special Rate" } ] } ]

Attributes for Deal Tags:
API Request https://api.parrapi.com/api/atlas/attributes?key=[KEY]&types=DEALTAGS
Definition Retrieve all attributes that belong to the attribute type - "DEAL TAGS"
Sample attributes response payload showing the deals tags:
XML Output: <AttributeType> <AttributeTypeId>DEALTAGS</AttributeTypeId> <Description>Deal Tags</Description> <Attributes> <AttributeId>FEATURED</AttributeId> <Description>Featured</Description> </Attributes> <Attributes> <AttributeId>CAMPAIGN</AttributeId> <Description>Campaign</Description> </Attributes> <Attributes> <AttributeId>DONOTDISPLAY</AttributeId> <Description>Do Not Display</Description> </Attributes> </AttributeType>
JSON Output: [ { "AttributeTypeId": "DEALTAGS", "Description": "Deal Tags", "Attributes": [ { "AttributeId": "FEATURED", "Description": "Featured" }, { "AttributeId": "CAMPAIGN", "Description": "Campaign" }, { "AttributeId": "DONOTDISPLAY", "Description": "Do Not Display" } ] } ]