Guides
  1. Product Feed
  2. Product Feed Data File

Travel & Experiences Feed

Product Feed Specifications: Travel and Experiences Feed

The CJ Travel and Experiences Feed allows advertisers to describe the products they sell in the travel and experiences vertical, such as hotel rooms, cruise ships, flights, car rentals, or concert tickets. Your feed should be formatted as a plain text or XML document containing only the column names listed below.

Field Reference

Use the table below to scan all available fields. Click any row to expand full requirements and error details.

Click any row to see type, format, and value examples.
Parameter
Description
Required
id
Your product's unique identifier, e.g. property ID, concert ID, package ID, event ID.
Required
Type: AlphanumericFormat: Max 50 characters. Allowed special characters: - . # _ /
Note: Must be unique within the feed. Products with duplicate IDs will be removed on import. If using item-based pixel or batch, the ID must exactly match the SKU passed in your transaction data.
title
Your product's name, e.g. hotel name, performer name, event name.
Required
Type: StringFormat: Max 150 characters
Note: Make the name relevant, clear and specific. For example, 'Caesar's Palace Las Vegas' or 'Red Sox at Yankees.'
description
Your product's detailed description.
Required
Type: StringFormat: Max 5000 characters
Note: Describe your product's features, specifications, and qualities. The more you describe your product, the more useful it is to publishers and customers.
link
Your product's landing page URL.
Required
Type: URLFormat: Max 2000 characters. Must be a valid URL including http:// or https://
Note: Links with invalid formatting (e.g., without http://) will be rejected. Products with no valid link will be rejected.
image_link
Your product's main image URL.
Required
Type: URLFormat: Max 2000 characters. Must be a valid URL including http:// or https://
Note: Provide the largest, highest-quality image possible — publishers may resize for various formats. Products with an invalid image link will be accepted without this value.
travel_type
Your product's primary category. Used to classify your product in the CJ system.
Required
Type: Enum
Allowed Values
air
car
activity
cruise
event
hotel
package
restaurant
travel_guides
vacation_rental
other
Note: Products without a valid travel_type value will be rejected.
price
Your product's standard pricing, e.g. the standard room rate or package price. If pricing is dynamic or variable, include your lowest price and set from_price to 'Yes'.
Required
Type: NumericFormat: ISO 4217 numeric. May optionally include three-digit currency code, e.g. '199.00 USD'
Examples
199.00
199.00 USD
Note: Products without a valid price will be rejected.
street_address
Your product's street name and number, e.g. 123 Main Street.
Conditional
Type: StringFormat: Max 150 characters
Note: Required for hotels. Recommended for vacation rentals. Hotel products without this value will be rejected.
city
Your product's city location, e.g. Los Angeles or London.
Conditional
Type: StringFormat: Max 150 characters
Note: Required for hotels, vacation rentals, or events. Products in these categories without this value will be rejected.
country
Your product's country in two-digit ISO code, e.g. US, AU, FR.
Conditional
Type: StringFormat: ISO 3166-1 alpha-2 two-digit country code
Examples
US
GB
AU
Note: Required for hotels, vacation rentals, or events. Products in these categories without a valid country value will be rejected.
phone_number
Your product's contact phone number, e.g. +61 9801 5462, 1-805-123-1234.
Conditional
Type: StringFormat: Max 20 characters
Note: Required for hotels. Recommended for vacation rentals and events.
flight_type
Your flight type, e.g. one-way, return, multi-city.
Conditional
Type: StringFormat: Max 150 characters
Note: Required for Air products.
mobile_link
Your product's mobile-optimized landing page when you have a different URL for mobile and desktop traffic.
No
Type: URLFormat: Max 2000 characters. Must be a valid URL including http:// or https://
Note: Links with invalid formatting will be rejected. Products with no valid mobile link will be accepted without this value.
additional_image_link
Up to 24 additional image URLs. Show different views of your product, e.g. hotel room, lobby, pool, or event performers and venue.
Recommended
Type: URL listFormat: Max 2000 characters. Multiple values separated with commas. Each must be a valid URL.
Note: Provide the largest, highest-quality images possible. Products with an invalid image link will be accepted without this value.
brand
Your product's brand, e.g. the brand of your hotel, airline, or car rental service.
No
Type: StringFormat: Max 70 characters
Note: Values over 70 characters will be truncated.
brand_id
Your product's brand ID.
No
Type: StringFormat: Max 70 characters
Note: Values over 70 characters will be truncated.
category_name
Your self-assigned category name, e.g. type of hotel or type of cruise.
No
Type: StringFormat: Max 750 characters
category_id
Your self-assigned category ID.
No
Type: StringFormat: Max 750 characters
custom_identifier_1
Additional self-assigned category or identifier.
No
Type: StringFormat: Max 750 characters
custom_identifier_2
Additional self-assigned category or identifier.
No
Type: StringFormat: Max 750 characters
location_name
Your product's location name, e.g. the name of your venue or car rental location.
No
Type: StringFormat: Max 150 characters
location_id
Your product's location ID, e.g. venue or airport ID.
No
Type: StringFormat: Max 150 characters
province_state
Your product's province or state, e.g. Nebraska or Quebec.
Recommended
Type: StringFormat: Max 150 characters
zip_code
Your product's location zip or postal code.
Recommended
Type: StringFormat: Max 20 characters
Examples
93101
SW13 0BY
latitude
Your product location's latitude, e.g. the latitude of your hotel or rental car office.
Recommended
Type: NumericFormat: ISO 6709 latitude format
Note: Products with an invalid value will be accepted without this value.
longitude
Your product location's longitude, e.g. the longitude of your hotel or rental car office.
Recommended
Type: NumericFormat: ISO 6709 longitude format
Note: Products with an invalid value will be accepted without this value.
region_name
Your product's region, e.g. Southern California, Napa Valley, or Caribbean. Useful for search.
Recommended
Type: StringFormat: Max 150 characters
proximity_city
The closest city or metro area to your property. For example, if your property is just outside Paris, you can use 'Paris' or '15km to Paris city center.'
No
Type: StringFormat: Max 150 characters
proximity_airport
The closest airport to your property.
No
Type: StringFormat: Max 150 characters
origin_name
Your product's origin or departure location name. For products with a departure and arrival location, e.g. flights or cruises.
Recommended
Type: StringFormat: Max 150 characters
Note: Recommended for air, cruise, or car.
origin_code
Your product's origin ID or IATA code, e.g. LAX or ORD.
Recommended
Type: StringFormat: Max 150 characters
Note: Recommended for air, cruise, or car.
origin_city
Your product's origin city name, e.g. New York or Frankfurt.
Recommended
Type: StringFormat: Max 150 characters
Note: Recommended for air, cruise, or car.
origin_country
Your product's origin country code, e.g. FR, AU.
Recommended
Type: StringFormat: ISO 3166-1 alpha-2 two-digit country code
Note: Recommended for air, cruise, or car. Values not in valid format will be accepted without this value.
origin_latitude
Your product's origin latitude.
Recommended
Type: NumericFormat: ISO 6709 latitude format
Note: Recommended for air, cruise, or car. Values not in valid format will be accepted without this value.
origin_longitude
Your product's origin longitude.
Recommended
Type: NumericFormat: ISO 6709 longitude format
Note: Recommended for air, cruise, or car. Values not in valid format will be accepted without this value.
destination_name
Your product's destination or arrival location name.
Recommended
Type: StringFormat: Max 150 characters
Note: Recommended for air, cruise, or car.
destination_code
Your product's destination or arrival ID or IATA code, e.g. LAX or ORD.
Recommended
Type: StringFormat: Max 150 characters
Note: Recommended for air, cruise, or car.
destination_city
Your product's destination or arrival city name, e.g. New York or Frankfurt.
Recommended
Type: StringFormat: Max 150 characters
Note: Recommended for air, cruise, or car.
destination_country
Your product's destination or arrival country code.
Recommended
Type: StringFormat: ISO 3166-1 alpha-2 two-digit country code
Examples
FR
AU
Note: Recommended for air, cruise, or car. Values not in valid format will be accepted without this value.
destination_latitude
Your product's destination or arrival latitude.
Recommended
Type: NumericFormat: ISO 6709 latitude format
Note: Recommended for air, cruise, or car. Values not in valid format will be accepted without this value.
destination_longitude
Your product's destination or arrival longitude.
Recommended
Type: NumericFormat: ISO 6709 longitude format
Note: Recommended for air, cruise, or car. Values not in valid format will be accepted without this value.
sale_price
Your product's discounted or sale price.
No
Type: NumericFormat: ISO 4217 numeric. May optionally include three-digit currency code.
Examples
149.00
149.00 USD
Note: Products without a valid sale price will be accepted without this value.
sale_price_effective_date
The date range during which your product's sale price applies.
No
Type: Date rangeFormat: ISO 8601
Note: Products without a valid value will be accepted without this field.
additional_fees
Details about additional fees associated with your product, e.g. baggage fees or resort fees. Compound field with three sub-attributes.
No
Type: Compound
Note: Sub-attributes: amount (required, numeric price with optional currency), id (optional, max 50 chars), name (required, max 50 chars, e.g. 'baggage fee'). If using this field, amount and name are required. Products without a valid value will be accepted without this field.
from_price
Indicate if the price field is a starting or best price. For example, if your hotel room price changes dynamically, put the lowest price in the price field and set from_price to 'Yes'.
No
Type: Boolean
Allowed Values
Yes
No
Note: Products without a valid value will be accepted without this field.
fare_type
Your flight fare type, e.g. F, J, Y, W.
No
Type: StringFormat: Max 50 characters
free_cancellation
Indicate whether your product can be cancelled without penalty or fees.
No
Type: Boolean
Allowed Values
Yes
No
cancellable_online
Indicate whether your product can be cancelled online.
No
Type: Boolean
Allowed Values
Yes
No
payment_options
Your product's payment options, e.g. 'pay in advance' or 'pay when you arrive.'
Recommended
Type: StringFormat: Max 150 characters
loyalty_redeemable
Indicate whether customers can purchase your product with loyalty points.
No
Type: Boolean
Allowed Values
Yes
No
points_price
Your product's price in loyalty points, e.g. '24,000 Air Miles Points.'
Recommended
Type: StringFormat: Max 150 characters
tax_fees
The amount of taxes and fees on top of the price of your product, e.g. car rental fees, resort fees, or state or local taxes.
Recommended
Type: NumericFormat: ISO 4217 numeric
Note: Products without a valid value will be accepted without this field.
upgrade_price
Information about options for upgrading your product, e.g. '$100 to upgrade to first class.'
Recommended
Type: StringFormat: Max 150 characters
margin
Your margin on this product. For reporting purposes only — this value is not passed to publishers.
No
Type: StringFormat: Max 150 characters
travel_start_date
The date that your travel product starts, e.g. the date a festival starts or a cruise departs. Can also indicate when special pricing applies.
Recommended
Type: DateTimeFormat: ISO 8601: hh24:mm:ss+/-hh:mm, e.g. 15:53:00+05:00
Note: Products without a valid value will be accepted without this field.
travel_end_date
The date that your travel product ends, e.g. the date a festival ends or a cruise returns. Can also indicate the last date when special pricing applies.
Recommended
Type: DateTimeFormat: ISO 8601: hh24:mm:ss+/-hh:mm, e.g. 15:53:00+05:00
Note: Products without a valid value will be accepted without this field.
minimum_stay_duration
The minimum number of nights that must be booked at your property, e.g. 'minimum 2 night stay.'
Recommended
Type: StringFormat: Max 150 characters
availability_start
Your product's availability start date — the first date when customers can purchase or book your product, such as when tickets are released.
No
Type: DateFormat: ISO 8601
Note: Products without a valid value will be accepted without this field.
availability_end
Your product's availability end date — the last date when customers can purchase or book your product, such as when a sale ends.
No
Type: DateFormat: ISO 8601
Note: Products without a valid value will be accepted without this field.
star_rating
Your hotel or property star rating, e.g. 5.
Recommended
Type: NumericFormat: Number with decimal to one place, e.g. 2.5
Note: Recommended for hotels. Products without a valid value will be accepted without this field.
included_guests_count
The number of guests included in your product, e.g. the number of guests who fit in the hotel room, vacation rental, or rental car.
Recommended
Type: Integer
Note: Products without a valid value will be accepted without this field.
customer_segment
Indicate if your product is targeted to business or personal travelers.
No
Type: Enum
Allowed Values
business
personal
Note: Products without a valid value will be accepted without this field.
class
The class or type of product. Examples: business class, first class, economy (air); standard, suite, deluxe (hotel); economy, compact, SUV (car rental); interior, ocean view (cruise).
Recommended
Type: StringFormat: Max 150 characters
Note: Recommended for air, cruise, or car.
room_type
Your room type, e.g. deluxe, suite, interior cabin.
Recommended
Type: StringFormat: Max 150 characters
Note: Recommended for hotel, vacation rental, or cruise.
age_restrictions
Indicate if your product has age restrictions, e.g. 'over 18' or 'over 21.'
Recommended
Type: StringFormat: Max 150 characters
all_inclusive
Indicate whether your product is all inclusive, with food and activities included in the price.
Recommended
Type: StringFormat: Max 150 characters
Note: Recommended for resorts, cruises, and events.
amenities
Your property's amenities as a comma-separated list, e.g. 'pool, business facilities, free parking.'
Recommended
Type: StringFormat: Max 750 characters
accessibility
Information about your product's accessibility features as a comma-separated list, e.g. 'wheelchair accessible room, ASL interpreter.'
Recommended
Type: StringFormat: Max 150 characters
bedrooms
The number of separate bedrooms your property has. Typically used for vacation rentals or hotel suites.
Recommended
Type: Integer
Note: Recommended for hotel, vacation rental, or cruise. Products without a valid value will be accepted without this field.
beds
The number of beds your property has.
Recommended
Type: Integer
Note: Recommended for hotel, vacation rental, or cruise.
beds_description
A description of the types of beds in your property, e.g. 'one king or two queens.'
Recommended
Type: StringFormat: Max 150 characters
Note: Recommended for hotel, vacation rental, or cruise.
baths
The number of bathrooms in your property. Typically used for vacation rentals or hotel suites.
Recommended
Type: Integer
Note: Recommended for hotel, vacation rental, or cruise.
dining_options
Your product's dining options, e.g. a list of restaurants on your resort property or cruise ship.
Recommended
Type: StringFormat: Max 150 characters
Note: Recommended for hotel, vacation rental, or cruise.
free_breakfast
Indicate whether your product comes with free breakfast.
No
Type: Boolean
Allowed Values
Yes
No
free_internet
Indicate whether your product comes with free internet or wifi access.
No
Type: Boolean
Allowed Values
Yes
No
included_activities
A comma-separated list of activities included with your product, such as on-board cruise activities.
No
Type: StringFormat: Max 750 characters
itinerary
Your cruise or tour itinerary, e.g. 'day one in Miami, day two in Bahamas.'
Recommended
Type: StringFormat: Max 150 characters
Note: Recommended for cruises.
mileage
Your rental car mileage options, e.g. 'unlimited miles per day.'
Recommended
Type: StringFormat: Max 150 characters
Note: Recommended for car rentals.
nearby_attractions
A comma-separated list of attractions near your product, e.g. 'Aquarium, Natural History Museum, Sports Stadium.'
No
Type: StringFormat: Max 750 characters
pet_policy
Indicate whether your property allows pets.
No
Type: Boolean
Allowed Values
Yes
No
pet_policy_description
A description of your pet policy, e.g. 'dogs under 25lb acceptable with deposit.'
Recommended
Type: StringFormat: Max 150 characters
Note: Recommended for hotels and vacation rentals.
stops
Number of stops on your flight or cruise.
Recommended
Type: StringFormat: Max 150 characters
Note: Recommended for cruises.
duration
The duration of your product, e.g. number of days on the cruise, number of nights in a resort package, or number of days for the festival pass.
No
Type: StringFormat: Max 150 characters
performers
A list of performers for events such as artists, sports teams, celebrities, etc.
Recommended
Type: StringFormat: Max 750 characters
Note: Recommended for events.
promotion
Promotional or sale information, e.g. 'Stay three nights get the fourth free.'
No
Type: StringFormat: Max 150 characters
custom_label_0
Custom field for information that doesn't fit into another field.
No
Type: StringFormat: Max 2000 characters
custom_label_1
Custom field for information that doesn't fit into another field.
No
Type: StringFormat: Max 2000 characters
custom_label_2
Custom field for information that doesn't fit into another field.
No
Type: StringFormat: Max 2000 characters
custom_label_3
Custom field for information that doesn't fit into another field.
No
Type: StringFormat: Max 2000 characters
custom_label_4
Custom field for information that doesn't fit into another field.
No
Type: StringFormat: Max 2000 characters

Updated 11 days ago