Available catalog fields for Travel Ads

Field

Is required?

Description & example

Rules

origin_airport

Type: string

Required

The IATA code for the origin airport

Example: CHI

IATA code only (3 characters)

destination_airport

Type: string

Required

The IATA code for the destination airport

Example: NYC

IATA code only (3 characters)

image_link

Type: string

Required

A link to the flight's image

Example: https://www.imagelink.com/flight_image_001.jpg

1. Link URL should be formatted as x://xxx.xxx/xxx?xxx=xxx.

2. Image must be in .JPG/.JPEG or .PNG format

3. Image must be at least 500x500 pixels.

4. The recommended image sizes are: 1200x628px for horizontal, 640x640px for square, and 720x1280px for vertical.

5. There is no maximum character limit for the link URL.

6. Link can start with either http or https.

7. Ensure the link is active and accessible at the time of submission.

8. Image should be unique to the flight; avoid thumbnail, placeholder, or generic images.

9. Avoid using images with watermarks, logos, or overlaid text.

link

Type: string

Optional

The URL of the product landing page, or the website where you can view the flight

Example: https://www.landingpage.com

1. Link URL should be formatted as x://xxx.xxx/xxx?xxx=xxx.

2. There is no maximum character limit for the link URL.

3. Ensure link is functioning at time of submission to avoid rejection.

4. Link can start with either http or https

additional_image_link

Type: string

Optional

Additional image links for the flight

Example: https://www.imagelink.com/flight_image_002.jpg

1. Link URLs should be formatted as x://xxx.xxx/xxx?xxx=xxx

2. All images must be in .JPG/.JPEG or .PNG format.

3. Each image must be at least 500x500 pixels.

4. Use a comma (,) to separate multiple image links.

5. Maximum of 20 image links per flight

6. Ensure all links are active and accessible at the time of submission.

7. Images should be relevant to the specific flight; avoid placeholder or generic visuals.

8. Avoid using images with watermarks, logos, or overlaid text.

video_link

Type: string

Optional

A link to the flight's video

Example: https://www.tiktok.com/flight.mp4

1. Link URL should be formatted as x://xxx.xxx/xxx?xxx=xxx.

2. There is no maximum character limit for the link URL.

3. Ensure link is functioning at time of submission to avoid rejection.

4. Link can start with either http or https

5. Linked video recommended aspect ratio is vertical (9:16)

6. Linked video recommended resolution is ≥720*1280

7. Linked video recommended bitrate is ≥516kbps

8. Linked video is recommended to have sound enabled and captions included

9. Linked video is recommended to follow standard TikTok safe zone guidelines to avoid overlapping text or covering essential information.

origin_city

Type: string

Optional

The name of the origin city

Example: Chicago

Character limit: 150

destination_city

Type: string

Optional

The name of the destination city

Example: New York

Character limit: 150

price

Type: string

Optional

The original price of the flight

Example: 9.97 USD

1. Format price as the cost, followed by the ISO 4217 currency code, with a space between cost and currency.

2. Currency must match the catalog's default currency.

3. Price and currency should match the price and currency on the landing page and checkout page.

sale_price

Type: string

Optional

The discount price of the flight

Example: 9.9 USD

1. Format sale_price as the cost, followed by the ISO 4217 currency code, with a space between cost and currency.

2. Use this field when advertising discounts, sale_price should reflect the discounted fare shown to users.

3. Currency must match the catalog's default currency.

4. sale_price and currency should match the price and currency on the landing page and checkout page.

5. sale_price must be strictly less than price.

description

Type: string

Optional

Brief description of the flight

Example: Flight to NYC

Character limit: 20,000

airline_company

Type: string

Optional

The name of the airline company

Example: Delta Air Lines

1. Accepted values: Delta Air Lines, American Airlines, United Airlines, Emirates, Lufthansa Group, Air France-KLM Group, Qatar Airways, China Southern Airlines, China Eastern Airlines, Southwest Airlines, Singapore Airlines, British Airways, Qantas Airways, Turkish Airlines, Cathay Pacific, ANA (All Nippon Airways), KLM Royal Dutch Airlines, Japan Airlines, Alaska Airlines, Virgin Atlantic, JetBlue Airways, Aeroflot

2. Provide only one airline name per entry

3. Use this field to specify the airline operating the flight. The value should exactly match one of the accepted airlines listed above.

cabin_class

Type: string

Optional

The class of flight cabin

Example: First Class

1. Accepted values: First Class, Business Class, Premium Economy, Economy Class, Basic Economy, First Class Suite, Business Class Suite, Lie-Flat Seat, Comfort Class, Standard Economy, Quiet Class

2. Provide only one cabin class per entry

3. Use this field to indicate the cabin class offered for the flight. The value must exactly match one of the accepted options above.

priority

Type: string

Optional

The priority level of the flight in the catalog Example: 1

Accepted values: 0, 1, 2, 3, 4, 5

android_url

Type: string

Optional

The URL of each Android app, required if your optimization location includes app.

Example: android://electronic

1. Android app store url

2. Ensure link is functioning at time of submission to avoid rejection.

3. android_url and android_package should direct to the same app

android_package

Type: string

Optional

The Android app store ID, required if your optimization location includes app.

Example: com.electronic

1. Android app store ID

2. Ensure link is functioning at time of submission to avoid rejection.

3. android_url and android_package should direct to the same app

android_app_name

Type: string

Optional

The name of each Android app, required if your optimization location includes app.

Example: Electronic Android

Name of android_app_name must match the app linked from the android_url and android_package fields

ios_url

Type: string

Optional

The URL of each iOS app, required if your optimization location includes app.

Example: iOS://electronic

1. iOS app store url

2. Ensure link is functioning at time of submission to avoid rejection.

3. iOS_url and iOS_package should direct to the same app

ios_app_store_id

Type: string

Optional

The iOS app store ID, required if your optimization location includes app.

Example: 1234

1. iOS app store ID

2. Ensure link is functioning at time of submission to avoid rejection.

3. iOS_url and iOS_package should direct to the same app

ios_app_name

Type: string

Optional

The name of each iOS app, required if your optimization location includes app.

Example: Electronic iOS

Name of ios_app_name must match the app linked from the ios_url and ios_app_store_id fields

custom_label_0

Type: string

Optional

A short selling point for the flight. Used to populate ad copy when no sale_price is detected for the flight_id

Example: Non-stop

1. Use this field to highlight a key selling point of the flight.

2. Each of the five available fields (custom_label_0 through custom_label_4) is designed to hold one distinct short message.

3. We recommend populating the fields sequentially, starting with custom_label_0, then 1, 2, and so on.

4. Character limit: 500

custom_label_1

Type: string

Optional

A short selling point for the flight

Example: Affordable

1. Use this field to highlight a key selling point of the flight.

2. Each of the five available fields (custom_label_0 through custom_label_4) is designed to hold one distinct short message.

3. We recommend populating the fields sequentially, starting with custom_label_0, then 1, 2, and so on.

4. Character limit: 500

custom_label_2

Type: string

Optional

A short selling point for the flight

Example: Early bird

1. Use this field to highlight a key selling point of the flight.

2. Each of the five available fields (custom_label_0 through custom_label_4) is designed to hold one distinct short message.

3. We recommend populating the fields sequentially, starting with custom_label_0, then 1, 2, and so on.

4. Character limit: 500

custom_label_3

Type: string

Optional

A short selling point for the flight

Example: Free Wi-Fi

1. Use this field to highlight a key selling point of the flight.

2. Each of the five available fields (custom_label_0 through custom_label_4) is designed to hold one distinct short message.

3. We recommend populating the fields sequentially, starting with custom_label_0, then 1, 2, and so on.

4. Character limit: 500

custom_label_4

Type: string

Optional

A short selling point for the flight

Example: Extra legroom

1. Use this field to highlight a key selling point of the flight.

2. Each of the five available fields (custom_label_0 through custom_label_4) is designed to hold one distinct short message.

3. We recommend populating the fields sequentially, starting with custom_label_0, then 1, 2, and so on.

4. Character limit: 500

internal_label[0]

Type: string

Optional

Add internal labels to help filter items when creating product sets

Example: 1927

1. Enclose each label in single quotes (') and separate multiple labels with commas (,)

2. Do not include white space at the beginning or end of each label.

3. Character limit: 100

4. Label amount limit: 5000

internal_label[1]

Type: string

Optional

Add internal labels to help filter items when creating product sets

Example: summer

1. Enclose each label in single quotes (') and separate multiple labels with commas (,)

2. Do not include white space at the beginning or end of each label.

3. Character limit: 100

4. Label amount limit: 5000

Field

Is required?

Description & example

Rules

hotel_id

Type: string

Required

This ID should be the same as the SKU ID you're using for the 'content_id' parameter in your event source

Example: H12345

1. Character limit: 100

2. All hotel_id must be unique in the catalog

hotel_name

Type: string

Required

Most common name of the hotel

Example: TikTok Hotel

Character limit: 150

image_link

Type: string

Required

A link to the hotel's image

Example: https://www.imagelink.com/hotel_image_001.jpg

1. Link URL should be formatted as x://xxx.xxx/xxx?xxx=xxx.

2. There is no maximum character limit for the link URL.

3. Ensure link is functioning at time of submission to avoid rejection.

4. Link can start with either http or https

5. Linked image should be ≥ 500x500 pixels.

6. Image must be JPG or PNG format.

7. Image should be unique to the hotel; avoid thumbnail, placeholder, or generic images.

8. Do not include watermarks, logos, or text in image.

brand

Type: string

Required

The hotel's brand name

Example: TikTok

Character limit: 150

address

Type: string

Required

Primary street address of hotel

Example: 123 Main Street

Character limit: 150

address.city

Type: string

Required

City where the hotel is located

Example: Palo Alto

Character limit: 150

address.country

Type: string

Required

Country where the hotel is located

Example: United States

Character limit: 150

link

Type: string

Optional

The URL of the product landing page, or the website where you can book a hotel room. If this field is left empty, the campaign's destination URL will be used as the landing page.

Example: https://www.landingpage.com

1. Link URL should be formatted as x://xxx.xxx/xxx?xxx=xxx.

2. There is no maximum character limit for the link URL.

3. Ensure link is functioning at time of submission to avoid rejection.

4. Link can start with either http or https

video_link

Type: string

Optional

A link to the hotel's video

Example: https://www.tiktok.com/hotel.mp4

1. Link URL should be formatted as x://xxx.xxx/xxx?xxx=xxx.

2. There is no maximum character limit for the link URL.

3. Ensure link is functioning at time of submission to avoid rejection.

4. Link can start with either http or https

5. Linked video recommended aspect ratio is Vertical (9:16)

6. Linked video recommended resolution is ≥720*1280

7. Linked video recommended bitrate is ≥516kbps

8. Linked video is recommended to have sound enabled and captions included

9. Linked video is recommended to follow standard TikTok safe zone guidelines to avoid overlapping text or covering essential information.

additional_image_link

Type: string

Optional

Additional image links for the hotel

Example: https://www.tiktok.com/hotel_image_002.jpg,https://www.tiktok.com/hotel_image_003.jpg

1. Link URL should be formatted as x://xxx.xxx/xxx?xxx=xxx.

2. All images must be in .JPG, .JPEG, or .PNG format.

3. Each image must be at least 500x500 pixels.

4. Use a comma (,) to separate multiple image links.

5. Maximum of 20 image links per hotel

6. Ensure all links are active and accessible at the time of submission.

7. Images should be relevant to the specific hotel; avoid placeholder or generic visuals.

8. Avoid using images with watermarks, logos, or overlaid text

availability

Type: string

The product's inventory status

Example: in stock

Accepted values: in stock, out of stock. All other values will result in an error.

latitude

Type: float

Optional

Latitude of the hotel

Example: 37.4841

Value must be between -90 and 90

longitude

Type: float

Optional

Longitude of the hotel

Example: 122.148252

Value must be between -180 and 180

neighborhood

Type: string

Optional

Neighborhood where the hotel is located

Example: Paris City Centre

Character limit: 150

address.region

Type: string

Optional

State, county, or province where the hotel is located

Example: California

Character limit: 150

postal_code

Type: string

Optional

Postal code of the area where the hotel is located

Example: 123456

Character limit: 150

description

Type: string

Optional

Brief description of the hotel

Example: A very cool hotel.

Character limit: 20,000

secondary_address

Type: string

Optional

The secondary street address of the hotel

Example: The Palazzo Tower

Character limit: 150

tertiary_address

Type: string

Optional

The tertiary street address of the hotel

Example: Room 1, Floor 14

Character limit: 150

base_price

Type: string

Optional

The lowest base price of the hotel room per night

Example: 9.97 USD

1. Format price as the cost, followed by the ISO 4217 currency code, with a space between cost and currency

2. Currency must match the catalog's default currency

3. Price and currency should match the price and currency on the landing page and checkout page

4. There should only be one price per hotel_id

sale_price

Type: string

Optional

The discount price of the hotel room per night

Example: 9.91 USD

1. Format sale_price as the cost, followed by the ISO 4217 currency code, with a space between cost and currency

2. Currency must match the catalog's default currency

3. sale_price and currency should match the price and currency on the landing page and checkout page

4. There should only be one sale_price per hotel_id

category

Type: string

Optional

The type of property; such as a hotel

Example: Motel

1. Accepted values: Motel, Hostel, Guest House, Capsule Hotel, Family Hotel, Ryokan, Villa, Apartment, Serviced Apartment, Beach Hotel, Resort, Cabin, Hotel, Houseboat, Farm, Cottage, Chalet, Castle, Condo, Tree House, Bed & Breakfast, Lodge, Inn, Camping, Ranch, Safari, Condo Resort, Hostel/Backpacker Accommodation, Private Vacation Home, Residence, Guesthouse, Hostal, Country House, Palace, Townhouse, Holiday Park, Pousada, Cruise, Pension, Riad, Luxury tents, Resort Villages, Farm Stays, Boats, Love Hotels

2. A maximum of 3 categories can be chosen per property, separated by ','

priority

Type: integer

Optional

An indicator of the priority of the hotel

Example: 0

Accepted value: 0, 1, 2, 3, 4, 5

room_type

Type: string

Optional

Type of the room

Example: Deluxe Room

1. Accepted values: Single Room, Double Room, Twin Room, Suite, Deluxe Room, Presidential Suite, Family Room, Business Room, Executive Room, Sea View Room, Mountain View Room, Garden View Room, Loft Room, Studio Room, Accessible Room, Honeymoon Suite, Jacuzzi Room, Penthouse Suite, Junior Suite, Wellness Room, Allergy-Free Room, Apartment Suite, Pet-Friendly Room, Beachfront Room, Ski Room, Terrace Room, Duplex Suite, Soundproof Room, Glamping Tent, Garden Suite, Luxury Suite, Mountain Chalet, Loft Suite, Treehouse Room, Floating Room, Pool Villa Room, Apartment Room, Artist Room, Cabin Room, Water Suite, Mountain Lodge, Eco Room, Romantic Suite, Fitness Room, Rustic Room, Executive Suite, Studio Apartment, Poolside Room, Ski-in/Ski-out Room, Historical Room, Grand Suite, Private Villa Room

2. A maximum of 3 types can be chosen per property, separated by ','

loyalty_program

Type: string

Optional

Loyalty program you use to gain points for staying at the hotel

Example: TikTok Group

1. Accepted values: Hilton Honors, Marriott Bonvoy, IHG Rewards Club, Wyndham Rewards, Accor Live Limitless (ALL), Best Western Rewards, Choice Privileges, Radisson Rewards, World of Hyatt, Sonesta Travel Pass, Motel 6 My6, Kimpton Karma Rewards, Four Seasons Loyalty Program, Trump Card, Aman Club, Leaders Club (The Leading Hotels of the World), Loews Loves You, Scandic Friends, Banyan Tree DISCOVERY

2. A maximum of 1 type can be chosen per property

margin_level

Type: string

Optional

Indicator of the profitability of the hotel

Example: 10

Character limit: 150

star_rating

Type: float

Optional

Hotel star rating

Example: 5

The valid values are between 1 to 5

guest_rating[0].rating_system

Type: string

Optional

The system used for guest rating

Example: TripAdvisor

Character limit: 150

guest_rating[0].number_of_reviewers

Type: integer

Optional

Total number of guests who have rated this hotel

Example: 345

Must be greater than or equal to 0

guest_rating[0].score

Type: integer

Optional

Actual value for the hotel rating score

Example: 3.5

Must be greater than or equal to 0; We suggest uploading the guest_rating[0].score and the guest_rating[0].max_score together

guest_rating[0].max_score

Type: float

Optional

Max value for the hotel rating score

Example: 5

Must be greater than or equal to 0, and less than or equal to 100; We suggest uploading the guest_rating[0].score and the guest_rating[0].max_score together

android_url

Type: string

Optional

The URL of each Android app, required if your optimization location includes app

Example: android://electronic

1. Android app store url

2. Ensure link is functioning at time of submission to avoid rejection.

3. android_url and android_package should direct to the same app

android_package

Type: string

Optional

The Android app store ID, required if your optimization location includes app

Example: com.electronic

1. Android app store ID

2. Ensure link is functioning at time of submission to avoid rejection.

3. android_url and android_package should direct to the same app

android_app_name

Type: string

Optional

The name of each Android app, required if your optimization location includes app

Example: Electronic Android

Name of android_app_name must match the app linked from the android_url and android_package fields

ios_url

Type: string

Optional

The URL of each iOS app, required if your optimization location includes app

Example: iOS://electronic

1. iOS app store url

2. Ensure link is functioning at time of submission to avoid rejection.

3. iOS_url and iOS_package should direct to the same app

ios_app_store_id

Type: string

Optional

The iOS app store ID, required if your optimization location includes app

Example: 1234

1. iOS app store ID

2. Ensure link is functioning at time of submission to avoid rejection.

3. iOS_url and iOS_package should direct to the same app

ios_app_name

Type: string

Optional

The name of each iOS app, required if your optimization location includes app

Example: Electronic iOS

Name of ios_app_name must match the app linked from the ios_url and ios_app_store_id fields

custom_label_0

Type: string

Optional

A short selling point for the hotel

Example: Free breakfast

Character limit: 20

custom_label_1

Type: string

Optional

A short selling point for the hotel

Example: Pet friendly

Character limit: 20

custom_label_2

Type: string

Optional

A short selling point for the hotel

Example: On-site parking

Character limit: 20

custom_label_3

Type: string

Optional

A short selling point for the hotel

Example: Airport shuttle service

Character limit: 20

custom_label_4

Type: string

Optional

A short selling point for the hotel

Example: Sustainability

Character limit: 20

internal_label[0]

Type: string

Optional

Add internal labels to help filter items when creating product

Example: 1927

1. Enclose each label in single quotes (') and separate multiple labels with commas (,)

2. Do not include white space at the beginning or end of each label

3. Character limit: 100 characters per label

4. Label amount limit: 5000

internal_label[1]

Type: string

Optional

Add internal labels to help filter items when creating product sets

Example: summer

1. Enclose each label in single quotes (') and separate multiple labels with commas (,)

2. Do not include white space at the beginning or end of each label

3. Character limit: 100 characters per label

4. Label amount limit: 5000

Field

Is required?

Description & example

Rules

destination_id

Type: string

Required

This ID should be the same as the SKU ID you're using for the 'content_id' parameter in your event source

Example: D123456

1. Character limit: 100

2. All destination_id must be unique in the catalog

destination_name

Type: string

Required

Most common name of the destination

Example: New York City

1. Character limit:150

image_link

Type: string

Required

A link to the destination's image

Example: https://www.imagelink.com/destination_image_001.jpg

1. Link URL should be formatted as x://xxx.xxx/xxx?xxx=xxx. 2. There is no maximum character limit for the link URL. 3. Ensure link is functioning at time of submission to avoid rejection. 4. Link can start with either http or https 5. Linked image should be ≥ 500x500 pixels. 6. Image must be JPG or PNG format. 7. Image should be unique to the destination; avoid thumbnail, placeholder, or generic images. 8. Do not include watermarks, logos, or text in image.

link

Type: string

Required

The URL of the product landing page, or the website where you can view the destination page

Example: https://www.landingpage.com

1. Link URL should be formatted as x://xxx.xxx/xxx?xxx=xxx. 2. There is no maximum character limit for the link URL. 3. Ensure link is functioning at time of submission to avoid rejection. 4. Link can start with either http or https

address

Type: string

Required

Primary street address of the destination

Example: 123 Main Street

1. Character limit:150

address.city

Type: string

Required

City where the destination is located

Example: Palo Alto

1. Character limit:150

address.region

Type: string

Required

State, county, province, where the destination is located

Example: California

1. Character limit:150

address.country

Type: string

Required

Country where the destination is located

Example: United States

1. Character limit:150

types

Type: string

Required

Words or phrases describing the destination, e.g. beach, city, food, sightseeing, culture, history, shopping, museum, tranquility, scenery, nature, architecture, business, friendly people, relaxation, night market, mountain, temple, hiking, snorkeling

Example: city, sightseeing

1. Use a comma to separate each type

price

Type: string

Optional

The original price of the trip

Example: 9.97 USD

1. Format price as the cost, followed by the ISO 4217 currency code, with a space between cost and currency 2. Currency must match the catalog's default currency 3. Price and currency should match the price and currency on the landing page and checkout page 4. There should only be one price per destination_id

description

Type: string

Optional

Brief description of the trip

Example: Explore the bustling city of New York

1. Character limit: 20,000

video_link

Type: string

Optional

A link to the destination's video

Example: https://www.tiktok.com/destination.mp4

1. Link URL should be formatted as x://xxx.xxx/xxx?xxx=xxx. 2. There is no maximum character limit for the link URL. 3. Ensure link is functioning at time of submission to avoid rejection. 4. Link can start with either http or https 5. Linked video recommended aspect ratio is Vertical (9:16) 6. Linked video recommended resolution is ≥720*1280 7. Linked video recommended bitrate is ≥516kbps 8. Linked video is recommended to have sound enabled and captions included 9. Linked video is recommended to follow standard TikTok safe zone guidelines to avoid overlapping text or covering essential information.

postcode

Type: string

Optional

Postcode of the destination

Example: 10001

latitude

Type: float

Optional

Latitude of the destination

Example: 40.7128

1. Value must be between -90 and 90

longitude

Type: float

Optional

Longitude of the destination

Example: -74.006

1. Value must be between -180 and 180

sale_price

Optional

The discount price of the trip

Example: 9.9 USD

1. Format sale_price as the cost, followed by the ISO 4217 currency code, with a space between cost and currency 2. Currency must match the catalog's default currency 3. sale_price and currency should match the price and currency on the landing page and checkout page 4. There should only be one sale_price per destination_id

additional_image_link

Type: string

Optional

Additional image links for the destination

Example: https://www.tiktok.com/destination_image_002.jpg,https://www.tiktok.com/destination_image_003.jpg

1. Link URL should be formatted as x://xxx.xxx/xxx?xxx=xxx. 2. There is no maximum character limit for the link URL. 3. Ensure link is functioning at time of submission to avoid rejection. 4. Link can start with either http or https 5. No more than 10 links 6. Use "," to separate each link

android_url

Type: string

Optional

The URL of each Android app

Example: android_url

1. Android app store url 2. Ensure link is functioning at time of submission to avoid rejection. 3. android_url and android_package should direct to the same app

android_package

Type: string

Optional

The Android app store ID

Example: android_package

1. android_url and android_package should direct to the same app

android_app_name

Type: string

Optional

The name of each Android app

Example: android_app_name

1. Name of android_app_name must match the app linked from the android_url and android_package fields

ios_url

Type: string

Optional

The URL of each iOS app

Example: iOS://electronic

1. iOS app store url

2.Ensure link is functioning at time of submission to avoid rejection. 3. iOS_url and iOS_package should direct to the same app

ios_app_store_id

Type: string

Optional

The iOS app store ID

Example: 1234

1. iOS app store ID 2. iOS_url and iOS_package should direct to the same app

ios_app_name

Type: string

Optional

The name of each iOS app

Example: Electronic iOS

1. Name of ios_app_name must match the app linked from the ios_url and ios_app_store_id fields

neighborhood

Type: string

Optional

Neighborhood where the destination is located

Example: Paris City Centre

1. Character limit: 150

custom_label_0

Type: string

Optional

A short selling point for the trip

Example: Easy escape

1. Recommended character limit: 20

custom_label_1

Type: string

Optional

A short selling point for the trip

Example: Epic scenes

1. Recommended character limit: 20

custom_label_2

Type: string

Optional

A short selling point for the trip

Example: Endless fun

1. Character limit: 20

custom_label_3

Type: string

Optional

A short selling point for the trip

Example: Pack now

1. Character limit: 20

custom_label_4

Type: string

Optional

A short selling point for the trip

Example: Quick trip

1. Character limit: 20