Catalog item schemas

Each vertical catalog type maps to a single AdCP schema that works across platforms — Google, Meta, LinkedIn, and others. Provide items in this format once, and every platform gets what it needs. All vertical items share a common pattern: a unique ID field, core display fields, an optional assets array for typed creative asset pools, an optional tags array for filtering, and an ext object for vendor-specific extensions. Conversion events listed for each vertical are the standard event names used for attribution when an ad drives action on a catalog item.

Common fields

In addition to the domain-specific fields listed in each vertical’s table, all vertical items support:

Field	Type	Description
`image_url`	uri	Primary image URL (most verticals — see note)
`url`	uri	Landing page URL (most verticals — see note)
`assets`	OfferingAssetGroup[]	Typed creative asset pools (landscape, vertical, square, logo, video)
`tags`	string[]	Tags for filtering and targeting
`ext`	object	Vendor-specific extensions

Exceptions: Job items use apply_url instead of url and have no image_url. App items use icon_url and store_url instead of image_url and url. See each vertical’s field table for the exact fields.

Job catalog

Job postings for recruitment campaigns. Maps to LinkedIn Jobs XML, Google DynamicJobsAsset, and schema.org JobPosting. Schema: /schemas/core/job-item.json Required: job_id, title, company_name, description Conversion events: submit_application, complete_registration

Field	Type	Description
`job_id`	string	Unique identifier for this posting
`title`	string	Job title
`company_name`	string	Hiring company name
`description`	string	Full job description
`location`	string	Display string — “Amsterdam, NL” or “Remote”
`employment_type`	enum	`full_time`, `part_time`, `contract`, `temporary`, `internship`, `freelance`
`experience_level`	enum	`entry_level`, `mid_level`, `senior`, `director`, `executive`
`salary`	object	`{ min, max, currency, period }` — period is `hour`, `month`, or `year`
`date_posted`	date	ISO 8601 date
`valid_through`	date	Application deadline
`apply_url`	uri	Direct application URL
`job_functions`	string[]	e.g., `["engineering", "marketing"]`
`industries`	string[]	e.g., `["technology", "healthcare"]`
`tags`	string[]	For filtering — e.g., `["remote", "visa-sponsorship"]`

Plus common fields (assets, tags, ext) shared by all verticals. Job items use apply_url instead of url and have no image_url. Minimal — just required fields:

{
  "$schema": "https://adcontextprotocol.org/schemas/v3/core/job-item.json",
  "job_id": "eng-sr-2025-042",
  "title": "Senior Software Engineer",
  "company_name": "Acme Corp",
  "description": "Senior engineer to lead our platform team, designing distributed systems serving millions of daily requests."
}

Full example with optional fields:

{
  "$schema": "https://adcontextprotocol.org/schemas/v3/core/job-item.json",
  "job_id": "eng-sr-2025-042",
  "title": "Senior Software Engineer",
  "company_name": "Acme Corp",
  "description": "We're looking for a senior engineer to lead our platform team. You'll design and build distributed systems serving millions of daily requests.",
  "location": "Amsterdam, NL",
  "employment_type": "full_time",
  "experience_level": "senior",
  "salary": { "min": 80000, "max": 110000, "currency": "EUR", "period": "year" },
  "date_posted": "2025-06-01",
  "valid_through": "2025-08-01",
  "apply_url": "https://acmecorp.com/careers/eng-sr-2025-042",
  "job_functions": ["engineering"],
  "industries": ["technology"],
  "tags": ["visa-sponsorship", "equity"]
}

Hotel catalog

Hotel and lodging properties for travel ads and dynamic remarketing. Maps to Google Hotel Center feeds and Meta hotel catalogs. Schema: /schemas/core/hotel-item.json Required: hotel_id, name, location Conversion events: purchase (booking)

Field	Type	Description
`hotel_id`	string	Unique identifier
`name`	string	Property name
`description`	string	Property description
`location`	object	`{ lat, lng }` — WGS 84 coordinates
`address`	object	`{ street, city, region, postal_code, country }`
`star_rating`	integer	1–5
`price`	object	`{ amount, currency, period }` — use period `"night"`
`image_url`	uri	Primary property image
`url`	uri	Property landing page
`amenities`	string[]	e.g., `["spa", "pool", "wifi"]`
`check_in_time`	string	HH:MM format (e.g., `"15:00"`)
`check_out_time`	string	HH:MM format (e.g., `"11:00"`)
`phone`	string	Property phone number in E.164 format
`valid_from`	date	Start of seasonal availability window
`valid_to`	date	End of seasonal availability window
`tags`	string[]	e.g., `["luxury", "city-center"]`

Plus common fields (image_url, url, assets, tags, ext) shared by all verticals. Minimal — just required fields:

{
  "$schema": "https://adcontextprotocol.org/schemas/v3/core/hotel-item.json",
  "hotel_id": "grand-amsterdam",
  "name": "Grand Hotel Amsterdam",
  "location": { "lat": 52.3676, "lng": 4.9041 }
}

Full example with optional fields:

{
  "$schema": "https://adcontextprotocol.org/schemas/v3/core/hotel-item.json",
  "hotel_id": "grand-amsterdam",
  "name": "Grand Hotel Amsterdam",
  "description": "Five-star canal-side hotel in the heart of Amsterdam with rooftop bar and spa.",
  "location": { "lat": 52.3676, "lng": 4.9041 },
  "address": {
    "street": "Herengracht 100",
    "city": "Amsterdam",
    "region": "NL-NH",
    "postal_code": "1015 BS",
    "country": "NL"
  },
  "star_rating": 5,
  "price": { "amount": 289, "currency": "EUR", "period": "night" },
  "image_url": "https://images.acmehotels.com/grand-amsterdam/hero.jpg",
  "url": "https://acmehotels.com/amsterdam/grand",
  "amenities": ["spa", "pool", "restaurant", "wifi", "parking"],
  "check_in_time": "15:00",
  "check_out_time": "11:00",
  "tags": ["luxury", "city-center", "business"]
}

Vehicle catalog

Vehicle listings for automotive inventory ads. Maps to Meta Automotive Inventory Ads, Microsoft Auto Inventory feeds, and Google vehicle ads. Schema: /schemas/core/vehicle-item.json Required: vehicle_id, title, make, model, year Conversion events: lead, schedule (test drive)

Field	Type	Description
`vehicle_id`	string	Unique identifier
`title`	string	Listing title (e.g., “2024 Apex Horizon EX Sedan”)
`make`	string	Manufacturer
`model`	string	Model name
`year`	integer	Model year
`price`	object	`{ amount, currency }`
`condition`	enum	`new`, `used`, `certified_pre_owned`
`vin`	string	17-character VIN
`trim`	string	Trim level (e.g., “EX”, “Limited”)
`mileage`	object	`{ value, unit }` — unit is `km` or `mi`
`body_style`	enum	`sedan`, `suv`, `truck`, `coupe`, `convertible`, `wagon`, `van`, `hatchback`
`transmission`	enum	`automatic`, `manual`, `cvt`
`fuel_type`	enum	`gasoline`, `diesel`, `electric`, `hybrid`, `plug_in_hybrid`
`exterior_color`	string	Exterior color
`interior_color`	string	Interior color
`location`	object	`{ lat, lng }` — dealer or vehicle location
`tags`	string[]	e.g., `["low-mileage", "one-owner"]`

Plus common fields (image_url, url, assets, tags, ext) shared by all verticals. Minimal — just required fields:

{
  "$schema": "https://adcontextprotocol.org/schemas/v3/core/vehicle-item.json",
  "vehicle_id": "dlr-2024-horizon-001",
  "title": "2024 Apex Horizon EX Sedan",
  "make": "Apex",
  "model": "Horizon",
  "year": 2024
}

Full example with optional fields:

{
  "$schema": "https://adcontextprotocol.org/schemas/v3/core/vehicle-item.json",
  "vehicle_id": "dlr-2024-horizon-001",
  "title": "2024 Apex Horizon EX Sedan",
  "make": "Apex",
  "model": "Horizon",
  "year": 2024,
  "trim": "EX",
  "price": { "amount": 28500, "currency": "USD" },
  "condition": "new",
  "body_style": "sedan",
  "transmission": "cvt",
  "fuel_type": "gasoline",
  "exterior_color": "Lunar Silver Metallic",
  "image_url": "https://images.apexmotors.com/horizon-ex-2024.jpg",
  "url": "https://apexmotors.com/inventory/horizon-001",
  "tags": ["new-arrival"]
}

Flight catalog

Flight routes for travel ads and dynamic remarketing. Maps to Google DynamicFlightsAsset and Meta flight catalogs. Schema: /schemas/core/flight-item.json Required: flight_id, origin, destination Conversion events: purchase (booking)

Field	Type	Description
`flight_id`	string	Unique identifier for this route
`origin`	object	`{ airport_code, city }` — IATA 3-letter code required
`destination`	object	`{ airport_code, city }` — IATA 3-letter code required
`airline`	string	Airline name or IATA code
`price`	object	`{ amount, currency }`
`description`	string	Route description or promotional text
`departure_time`	datetime	ISO 8601
`arrival_time`	datetime	ISO 8601
`image_url`	uri	Destination photo
`url`	uri	Booking page
`tags`	string[]	e.g., `["direct", "red-eye"]`

Plus common fields (image_url, url, assets, tags, ext) shared by all verticals. Minimal — just required fields:

{
  "$schema": "https://adcontextprotocol.org/schemas/v3/core/flight-item.json",
  "flight_id": "ams-jfk-summer",
  "origin": { "airport_code": "AMS" },
  "destination": { "airport_code": "JFK" }
}

Full example with optional fields:

{
  "$schema": "https://adcontextprotocol.org/schemas/v3/core/flight-item.json",
  "flight_id": "ams-jfk-summer",
  "origin": { "airport_code": "AMS", "city": "Amsterdam" },
  "destination": { "airport_code": "JFK", "city": "New York" },
  "airline": "Acme Air",
  "price": { "amount": 449, "currency": "EUR" },
  "description": "Direct flights from Amsterdam to New York, daily departures.",
  "image_url": "https://images.acmeair.com/routes/ams-jfk.jpg",
  "url": "https://acmeair.com/flights/ams-jfk",
  "tags": ["direct", "transatlantic"]
}

Real estate catalog

Property listings for real estate ads. Maps to Google DynamicRealEstateAsset and Meta home listing catalogs. Schema: /schemas/core/real-estate-item.json Required: listing_id, title, address Conversion events: lead, schedule (viewing)

Field	Type	Description
`listing_id`	string	Unique identifier
`title`	string	Listing title
`description`	string	Property description
`address`	object	`{ street, city, region, postal_code, country }`
`price`	object	`{ amount, currency, period }` — use `"month"` for rentals
`property_type`	enum	`house`, `apartment`, `condo`, `townhouse`, `land`, `commercial`
`listing_type`	enum	`for_sale`, `for_rent`
`bedrooms`	integer	Number of bedrooms
`bathrooms`	number	Number of bathrooms (e.g., 2.5)
`area`	object	`{ value, unit }` — unit is `sqft` or `sqm`
`location`	object	`{ lat, lng }`
`neighborhood`	string	Area name
`year_built`	integer	Year built
`tags`	string[]	e.g., `["garden", "renovated"]`

Plus common fields (image_url, url, assets, tags, ext) shared by all verticals. Minimal — just required fields:

{
  "$schema": "https://adcontextprotocol.org/schemas/v3/core/real-estate-item.json",
  "listing_id": "ams-jordaan-3br",
  "title": "Spacious 3BR Apartment in Jordaan",
  "address": { "city": "Amsterdam", "country": "NL" }
}

Full example with optional fields:

{
  "$schema": "https://adcontextprotocol.org/schemas/v3/core/real-estate-item.json",
  "listing_id": "ams-jordaan-3br",
  "title": "Spacious 3BR Apartment in Jordaan",
  "description": "Bright canal-view apartment with original features and modern kitchen, steps from Noordermarkt.",
  "address": {
    "street": "Prinsengracht 450",
    "city": "Amsterdam",
    "region": "NL-NH",
    "postal_code": "1017 KE",
    "country": "NL"
  },
  "price": { "amount": 650000, "currency": "EUR" },
  "property_type": "apartment",
  "listing_type": "for_sale",
  "bedrooms": 3,
  "bathrooms": 1,
  "area": { "value": 95, "unit": "sqm" },
  "location": { "lat": 52.3667, "lng": 4.8833 },
  "neighborhood": "Jordaan",
  "year_built": 1920,
  "tags": ["canal-view", "renovated"]
}

Education catalog

Educational programs and courses for student recruitment. Maps to Google DynamicEducationAsset and schema.org Course. Schema: /schemas/core/education-item.json Required: program_id, name, school Conversion events: submit_application, complete_registration

Field	Type	Description
`program_id`	string	Unique identifier
`name`	string	Program name
`school`	string	Institution name
`description`	string	Program description
`subject`	string	Field of study
`degree_type`	enum	`certificate`, `associate`, `bachelor`, `master`, `doctorate`, `professional`, `bootcamp`
`level`	enum	`beginner`, `intermediate`, `advanced`
`price`	object	`{ amount, currency, period }`
`duration`	string	e.g., “4 weeks”, “2 years”
`start_date`	date	Next available start date
`language`	string	Language code (e.g., “en”)
`modality`	enum	`online`, `in_person`, `hybrid`
`location`	string	Campus location (e.g., “Amsterdam, NL”). Omit for fully online.
`tags`	string[]	e.g., `["stem", "research"]`

Plus common fields (image_url, url, assets, tags, ext) shared by all verticals. Minimal — just required fields:

{
  "$schema": "https://adcontextprotocol.org/schemas/v3/core/education-item.json",
  "program_id": "pinnacle-msc-cs-2025",
  "name": "MSc Computer Science",
  "school": "Pinnacle University"
}

Full example with optional fields:

{
  "$schema": "https://adcontextprotocol.org/schemas/v3/core/education-item.json",
  "program_id": "pinnacle-msc-cs-2025",
  "name": "MSc Computer Science",
  "school": "Pinnacle University",
  "description": "Two-year research master's covering AI, distributed systems, and software engineering.",
  "subject": "computer-science",
  "degree_type": "master",
  "level": "advanced",
  "price": { "amount": 2314, "currency": "EUR", "period": "year" },
  "duration": "2 years",
  "start_date": "2025-09-01",
  "language": "en",
  "modality": "in_person",
  "location": "Amsterdam, NL",
  "url": "https://pinnacle-university.com/programmes/masters/computer-science",
  "tags": ["stem", "research"]
}

Destination catalog

Travel destinations for destination ads and travel remarketing. Maps to Meta destination catalogs and Google travel ads. Schema: /schemas/core/destination-item.json Required: destination_id, name Conversion events: purchase (booking)

Field	Type	Description
`destination_id`	string	Unique identifier
`name`	string	Destination name
`description`	string	Highlights and appeal
`city`	string	City name
`region`	string	State/province
`country`	string	ISO 3166-1 alpha-2
`location`	object	`{ lat, lng }`
`destination_type`	enum	`beach`, `mountain`, `urban`, `cultural`, `adventure`, `wellness`, `cruise`
`price`	object	Starting trip price
`rating`	number	1–5
`tags`	string[]	e.g., `["family", "romantic"]`

Plus common fields (image_url, url, assets, tags, ext) shared by all verticals. Minimal — just required fields:

{
  "$schema": "https://adcontextprotocol.org/schemas/v3/core/destination-item.json",
  "destination_id": "barcelona",
  "name": "Barcelona"
}

Full example with optional fields:

{
  "$schema": "https://adcontextprotocol.org/schemas/v3/core/destination-item.json",
  "destination_id": "barcelona",
  "name": "Barcelona",
  "description": "Mediterranean city blending Gaudí architecture, beaches, and world-class dining.",
  "city": "Barcelona",
  "region": "Catalonia",
  "country": "ES",
  "location": { "lat": 41.3874, "lng": 2.1686 },
  "destination_type": "urban",
  "price": { "amount": 399, "currency": "EUR" },
  "image_url": "https://images.acmetravel.com/barcelona/hero.jpg",
  "url": "https://acmetravel.com/destinations/barcelona",
  "rating": 4.7,
  "tags": ["city-break", "beach", "culture"]
}

App catalog

Mobile applications for app install and re-engagement campaigns. Maps to Google App Campaigns, Apple Search Ads, Meta App Ads, TikTok App Campaigns, and Snapchat App Install Ads. iOS and Android variants are separate items. Schema: /schemas/core/app-item.json Required: app_id, name, platform Conversion events: app_install, app_launch

Field	Type	Description
`app_id`	string	Buyer-assigned unique identifier
`name`	string	App display name
`platform`	enum	`ios`, `android`
`bundle_id`	string	Reverse-domain identifier (e.g., `com.acme.app`)
`apple_id`	string	Numeric Apple App Store ID (iOS only)
`description`	string	App description (overrides store listing)
`category`	string	Store category (e.g., “games”, “finance”)
`genre`	string	Sub-genre (e.g., “puzzle”, “strategy”)
`icon_url`	uri	App icon (1024x1024 px)
`screenshots`	uri[]	App store screenshots
`preview_video_url`	uri	Gameplay or demo video for video ad creatives
`store_url`	uri	App store listing URL
`deep_link_url`	uri	For re-engagement campaigns
`price`	object	`{ amount, currency }` — set amount to 0 for free
`rating`	number	0–5 store rating
`rating_count`	integer	Total number of store ratings
`content_rating`	string	Age rating (e.g., “4+”, “Everyone”)
`tags`	string[]	e.g., `["casual", "offline"]`

Plus common fields (assets, tags, ext) shared by all verticals. App items use icon_url and store_url instead of image_url and url. Minimal — just required fields:

{
  "$schema": "https://adcontextprotocol.org/schemas/v3/core/app-item.json",
  "app_id": "puzzlequest-ios",
  "name": "Puzzle Quest: Match 3",
  "platform": "ios"
}

Full example with optional fields:

{
  "$schema": "https://adcontextprotocol.org/schemas/v3/core/app-item.json",
  "app_id": "puzzlequest-ios",
  "name": "Puzzle Quest: Match 3",
  "platform": "ios",
  "bundle_id": "com.acmegames.puzzlequest",
  "apple_id": "1234567890",
  "category": "games",
  "genre": "puzzle",
  "icon_url": "https://assets.acmegames.com/puzzlequest/icon-1024.png",
  "store_url": "https://apps.apple.com/app/puzzle-quest-match-3/id1234567890",
  "price": { "amount": 0, "currency": "USD" },
  "rating": 4.7,
  "rating_count": 82000,
  "content_rating": "4+",
  "tags": ["casual", "offline"]
}

Documentation

​Catalog item schemas

​Common fields

​Job catalog

​Hotel catalog

​Vehicle catalog

​Flight catalog

​Real estate catalog

​Education catalog

​Destination catalog

​App catalog

Catalog item schemas

Common fields

Job catalog

Hotel catalog

Vehicle catalog

Flight catalog

Real estate catalog

Education catalog

Destination catalog

App catalog