@adcp/sdk 5.23.0

package/dist/lib/schemas-data/3.0.1/bundled/media-buy/get-products-request.json

@@ -0,0 +1,2046 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/schemas/3.0.1/bundled/media-buy/get-products-request.json",
+  "title": "Get Products Request",
+  "description": "Request parameters for discovering or refining advertising products. buying_mode declares the buyer's intent: 'brief' for curated discovery, 'wholesale' for raw catalog access, or 'refine' to iterate on known products and proposals.",
+  "type": "object",
+  "properties": {
+    "adcp_major_version": {
+      "type": "integer",
+      "description": "The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.",
+      "minimum": 1,
+      "maximum": 99
+    },
+    "buying_mode": {
+      "type": "string",
+      "enum": [
+        "brief",
+        "wholesale",
+        "refine"
+      ],
+      "description": "Declares buyer intent for this request. 'brief': publisher curates product recommendations from the provided brief. 'wholesale': buyer requests raw inventory to apply their own audiences — brief must not be provided, and proposals are omitted. 'refine': iterate on products and proposals from a previous get_products response using the refine array of change requests. v3 clients MUST include buying_mode. Sellers receiving requests from pre-v3 clients without buying_mode SHOULD default to 'brief'."
+    },
+    "brief": {
+      "type": "string",
+      "description": "Natural language description of campaign requirements. Required when buying_mode is 'brief'. Must not be provided when buying_mode is 'wholesale' or 'refine'."
+    },
+    "refine": {
+      "type": "array",
+      "description": "Array of change requests for iterating on products and proposals from a previous get_products response. Each entry declares a scope (request, product, or proposal) and what the buyer is asking for. Only valid when buying_mode is 'refine'. The seller responds to each entry via refinement_applied in the response, matched by position.",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "discriminator": {
+          "propertyName": "scope"
+        },
+        "oneOf": [
+          {
+            "properties": {
+              "scope": {
+                "type": "string",
+                "const": "request",
+                "description": "Change scoped to the overall request — direction for the selection as a whole."
+              },
+              "ask": {
+                "type": "string",
+                "minLength": 1,
+                "description": "What the buyer is asking for at the request level (e.g., 'more video options and less display', 'suggest how to combine these products')."
+              }
+            },
+            "required": [
+              "scope",
+              "ask"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "properties": {
+              "scope": {
+                "type": "string",
+                "const": "product",
+                "description": "Change scoped to a specific product."
+              },
+              "product_id": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Product ID from a previous get_products response."
+              },
+              "action": {
+                "type": "string",
+                "enum": [
+                  "include",
+                  "omit",
+                  "more_like_this"
+                ],
+                "default": "include",
+                "description": "'include' (default): return this product with updated pricing and data. 'omit': exclude this product from the response. 'more_like_this': find additional products similar to this one (the original is also returned). Optional — when omitted, the seller treats the entry as action: 'include'."
+              },
+              "ask": {
+                "type": "string",
+                "minLength": 1,
+                "description": "What the buyer is asking for on this product. For 'include': specific changes to request (e.g., 'add 16:9 format'). For 'more_like_this': what 'similar' means (e.g., 'same audience but video format'). Ignored when action is 'omit'."
+              }
+            },
+            "required": [
+              "scope",
+              "product_id"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "properties": {
+              "scope": {
+                "type": "string",
+                "const": "proposal",
+                "description": "Change scoped to a specific proposal."
+              },
+              "proposal_id": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Proposal ID from a previous get_products response."
+              },
+              "action": {
+                "type": "string",
+                "enum": [
+                  "include",
+                  "omit",
+                  "finalize"
+                ],
+                "default": "include",
+                "description": "'include' (default): return this proposal with updated allocations and pricing. 'omit': exclude this proposal from the response. 'finalize': request firm pricing and inventory hold — transitions a draft proposal to committed with an expires_at hold window. May trigger seller-side approval (HITL). The buyer should not set a time_budget for finalize requests — they represent a commitment to wait for the result. Optional — when omitted, the seller treats the entry as action: 'include'."
+              },
+              "ask": {
+                "type": "string",
+                "minLength": 1,
+                "description": "What the buyer is asking for on this proposal (e.g., 'shift more budget toward video', 'reduce total by 10%'). Ignored when action is 'omit'."
+              }
+            },
+            "required": [
+              "scope",
+              "proposal_id"
+            ],
+            "additionalProperties": false
+          }
+        ]
+      }
+    },
+    "brand": {
+      "title": "Brand Reference",
+      "description": "Brand reference for product discovery context. Resolved to full brand identity at execution time.",
+      "type": "object",
+      "properties": {
+        "domain": {
+          "type": "string",
+          "description": "Domain where /.well-known/brand.json is hosted, or the brand's operating domain",
+          "pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"
+        },
+        "brand_id": {
+          "title": "Brand ID",
+          "description": "Brand identifier within the house portfolio. Optional for single-brand domains.",
+          "type": "string",
+          "pattern": "^[a-z0-9_]+$",
+          "x-entity": "advertiser_brand",
+          "examples": [
+            "tide",
+            "cheerios",
+            "air_jordan",
+            "nike",
+            "pampers"
+          ]
+        },
+        "industries": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Inline override for the brand's industries. Useful when the caller cannot modify the brand's canonical brand.json but needs to declare industries for governance (e.g., Annex III vertical detection). brand.json remains the canonical source; when omitted here, governance agents SHOULD resolve from brand.json."
+        },
+        "data_subject_contestation": {
+          "type": "object",
+          "description": "Inline override for the brand's contestation contact point. Useful when the operator does not control brand.json but needs to discharge Art 22(3) for this plan. brand.json is canonical; when omitted, governance agents resolve brand → house → missing.",
+          "properties": {
+            "url": {
+              "type": "string",
+              "format": "uri",
+              "pattern": "^https://"
+            },
+            "email": {
+              "type": "string",
+              "format": "email"
+            },
+            "languages": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          },
+          "anyOf": [
+            {
+              "required": [
+                "url"
+              ]
+            },
+            {
+              "required": [
+                "email"
+              ]
+            }
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "domain"
+      ],
+      "additionalProperties": false,
+      "examples": [
+        {
+          "domain": "nova-brands.com",
+          "brand_id": "spark"
+        },
+        {
+          "domain": "nova-brands.com",
+          "brand_id": "glow"
+        },
+        {
+          "domain": "acme-corp.com"
+        }
+      ]
+    },
+    "catalog": {
+      "title": "Catalog",
+      "description": "Catalog of items the buyer wants to promote. The seller matches catalog items against its inventory and returns products where matches exist. Supports all catalog types: a job catalog finds job ad products, a product catalog finds sponsored product slots. Reference a synced catalog by catalog_id, or provide inline items.",
+      "type": "object",
+      "properties": {
+        "catalog_id": {
+          "type": "string",
+          "description": "Buyer's identifier for this catalog. Required when syncing via sync_catalogs. When used in creatives, references a previously synced catalog on the account.",
+          "x-entity": "catalog"
+        },
+        "name": {
+          "type": "string",
+          "description": "Human-readable name for this catalog (e.g., 'Summer Products 2025', 'Amsterdam Store Locations')."
+        },
+        "type": {
+          "title": "Catalog Type",
+          "description": "Catalog type. Structural types: 'offering' (AdCP Offering objects), 'product' (ecommerce entries), 'inventory' (stock per location), 'store' (physical locations), 'promotion' (deals and pricing). Vertical types: 'hotel', 'flight', 'job', 'vehicle', 'real_estate', 'education', 'destination', 'app' — each with an industry-specific item schema.",
+          "type": "string",
+          "enum": [
+            "offering",
+            "product",
+            "inventory",
+            "store",
+            "promotion",
+            "hotel",
+            "flight",
+            "job",
+            "vehicle",
+            "real_estate",
+            "education",
+            "destination",
+            "app"
+          ]
+        },
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "description": "URL to an external catalog feed. The platform fetches and resolves items from this URL. For offering-type catalogs, the feed contains an array of Offering objects. For other types, the feed format is determined by feed_format. When omitted with type 'product', the platform uses its synced copy of the brand's product catalog."
+        },
+        "feed_format": {
+          "title": "Feed Format",
+          "description": "Format of the external feed at url. Required when url points to a non-AdCP feed (e.g., Google Merchant Center XML, Meta Product Catalog). Omit for offering-type catalogs where the feed is native AdCP JSON.",
+          "type": "string",
+          "enum": [
+            "google_merchant_center",
+            "facebook_catalog",
+            "shopify",
+            "linkedin_jobs",
+            "custom"
+          ]
+        },
+        "update_frequency": {
+          "title": "Update Frequency",
+          "description": "How often the platform should re-fetch the feed from url. Only applicable when url is provided. Platforms may use this as a hint for polling schedules.",
+          "type": "string",
+          "enum": [
+            "realtime",
+            "hourly",
+            "daily",
+            "weekly"
+          ]
+        },
+        "items": {
+          "type": "array",
+          "description": "Inline catalog data. The item schema depends on the catalog type: Offering objects for 'offering', StoreItem for 'store', HotelItem for 'hotel', FlightItem for 'flight', JobItem for 'job', VehicleItem for 'vehicle', RealEstateItem for 'real_estate', EducationItem for 'education', DestinationItem for 'destination', AppItem for 'app', or freeform objects for 'product', 'inventory', and 'promotion'. Mutually exclusive with url — provide one or the other, not both. Implementations should validate items against the type-specific schema.",
+          "items": {
+            "type": "object"
+          },
+          "minItems": 1
+        },
+        "ids": {
+          "type": "array",
+          "description": "Filter catalog to specific item IDs. For offering-type catalogs, these are offering_id values. For product-type catalogs, these are SKU identifiers.",
+          "items": {
+            "type": "string"
+          },
+          "minItems": 1
+        },
+        "gtins": {
+          "type": "array",
+          "description": "Filter product-type catalogs by GTIN identifiers for cross-retailer catalog matching. Accepts standard GTIN formats (GTIN-8, UPC-A/GTIN-12, EAN-13/GTIN-13, GTIN-14). Only applicable when type is 'product'.",
+          "items": {
+            "type": "string",
+            "pattern": "^[0-9]{8,14}$"
+          },
+          "minItems": 1
+        },
+        "tags": {
+          "type": "array",
+          "description": "Filter catalog to items with these tags. Tags are matched using OR logic — items matching any tag are included.",
+          "items": {
+            "type": "string"
+          },
+          "minItems": 1
+        },
+        "category": {
+          "type": "string",
+          "description": "Filter catalog to items in this category (e.g., 'beverages/soft-drinks', 'chef-positions')."
+        },
+        "query": {
+          "type": "string",
+          "description": "Natural language filter for catalog items (e.g., 'all pasta sauces under $5', 'amsterdam vacancies')."
+        },
+        "conversion_events": {
+          "type": "array",
+          "description": "Event types that represent conversions for items in this catalog. Declares what events the platform should attribute to catalog items — e.g., a job catalog converts via submit_application, a product catalog via purchase. The event's content_ids field carries the item IDs that connect back to catalog items. Use content_id_type to declare what identifier type content_ids values represent.",
+          "items": {
+            "title": "Event Type",
+            "description": "Standard marketing event types for event logging, aligned with IAB ECAPI",
+            "type": "string",
+            "enum": [
+              "page_view",
+              "view_content",
+              "select_content",
+              "select_item",
+              "search",
+              "share",
+              "add_to_cart",
+              "remove_from_cart",
+              "viewed_cart",
+              "add_to_wishlist",
+              "initiate_checkout",
+              "add_payment_info",
+              "purchase",
+              "refund",
+              "lead",
+              "qualify_lead",
+              "close_convert_lead",
+              "disqualify_lead",
+              "complete_registration",
+              "subscribe",
+              "start_trial",
+              "app_install",
+              "app_launch",
+              "contact",
+              "schedule",
+              "donate",
+              "submit_application",
+              "custom"
+            ],
+            "enumDescriptions": {
+              "page_view": "User viewed a page",
+              "view_content": "User viewed specific content (product, article, etc.)",
+              "select_content": "User selected or clicked on content (article, video, etc.)",
+              "select_item": "User selected a specific product or item from a list",
+              "search": "User performed a search",
+              "share": "User shared content via social or messaging",
+              "add_to_cart": "User added an item to cart",
+              "remove_from_cart": "User removed an item from cart",
+              "viewed_cart": "User viewed their shopping cart",
+              "add_to_wishlist": "User added an item to a wishlist",
+              "initiate_checkout": "User started checkout process",
+              "add_payment_info": "User added payment information",
+              "purchase": "User completed a purchase",
+              "refund": "A purchase was fully or partially refunded (adjusts ROAS)",
+              "lead": "User expressed interest (form submission, signup, etc.)",
+              "qualify_lead": "Lead qualified by sales or scoring criteria",
+              "close_convert_lead": "Lead converted to a customer or closed deal",
+              "disqualify_lead": "Lead disqualified or marked as not viable",
+              "complete_registration": "User completed account registration",
+              "subscribe": "User subscribed to a service or newsletter",
+              "start_trial": "User started a free trial",
+              "app_install": "User installed an application",
+              "app_launch": "User launched an application",
+              "contact": "User initiated contact (call, message, etc.)",
+              "schedule": "User scheduled an appointment or event",
+              "donate": "User made a donation",
+              "submit_application": "User submitted an application (loan, job, etc.)",
+              "custom": "Custom event type (specify in custom_event_name)"
+            }
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "content_id_type": {
+          "title": "Content ID Type",
+          "description": "Identifier type that the event's content_ids field should be matched against for items in this catalog. For example, 'gtin' means content_ids values are Global Trade Item Numbers, 'sku' means retailer SKUs. Omit when using a custom identifier scheme not listed in the enum.",
+          "type": "string",
+          "enum": [
+            "sku",
+            "gtin",
+            "offering_id",
+            "job_id",
+            "hotel_id",
+            "flight_id",
+            "vehicle_id",
+            "listing_id",
+            "store_id",
+            "program_id",
+            "destination_id",
+            "app_id"
+          ]
+        },
+        "feed_field_mappings": {
+          "type": "array",
+          "description": "Declarative normalization rules for external feeds. Maps non-standard feed field names, date formats, price encodings, and image URLs to the AdCP catalog item schema. Applied during sync_catalogs ingestion. Supports field renames, named transforms (date, divide, boolean, split), static literal injection, and assignment of image URLs to typed asset pools.",
+          "items": {
+            "title": "Catalog Field Mapping",
+            "description": "Declares how a field in an external feed maps to the AdCP catalog item schema. Used in sync_catalogs feed_field_mappings to normalize non-AdCP feeds (Google Merchant Center, LinkedIn Jobs XML, hotel XML, etc.) to the standard catalog item schema without requiring the buyer to preprocess every feed. Multiple mappings can assemble a nested object via dot notation (e.g., separate mappings for price.amount and price.currency).",
+            "type": "object",
+            "properties": {
+              "feed_field": {
+                "type": "string",
+                "description": "Field name in the external feed record. Omit when injecting a static literal value (use the value property instead)."
+              },
+              "catalog_field": {
+                "type": "string",
+                "description": "Target field on the catalog item schema, using dot notation for nested fields (e.g., 'name', 'price.amount', 'location.city'). Mutually exclusive with asset_group_id."
+              },
+              "asset_group_id": {
+                "type": "string",
+                "description": "Places the feed field value (a URL) into a typed asset pool on the catalog item's assets array. The value is wrapped as an image or video asset in a group with this ID. Use standard group IDs: 'images_landscape', 'images_vertical', 'images_square', 'logo', 'video'. Mutually exclusive with catalog_field."
+              },
+              "value": {
+                "description": "Static literal value to inject into catalog_field for every item, regardless of what the feed contains. Mutually exclusive with feed_field. Useful for fields the feed omits (e.g., currency when price is always USD, or a constant category value)."
+              },
+              "transform": {
+                "type": "string",
+                "description": "Named transform to apply to the feed field value before writing to the catalog schema. See transform-specific parameters (format, timezone, by, separator).",
+                "enum": [
+                  "date",
+                  "divide",
+                  "boolean",
+                  "split"
+                ]
+              },
+              "format": {
+                "type": "string",
+                "description": "For transform 'date': the input date format string (e.g., 'YYYYMMDD', 'MM/DD/YYYY', 'DD-MM-YYYY'). Output is always ISO 8601 (e.g., '2025-03-01'). Uses Unicode date pattern tokens."
+              },
+              "timezone": {
+                "type": "string",
+                "description": "For transform 'date': the timezone of the input value. IANA timezone identifier (e.g., 'UTC', 'America/New_York', 'Europe/Amsterdam'). Defaults to UTC when omitted."
+              },
+              "by": {
+                "type": "number",
+                "description": "For transform 'divide': the divisor to apply (e.g., 100 to convert integer cents to decimal dollars).",
+                "exclusiveMinimum": 0
+              },
+              "separator": {
+                "type": "string",
+                "description": "For transform 'split': the separator character or string to split on. Defaults to ','.",
+                "default": ","
+              },
+              "default": {
+                "description": "Fallback value to use when feed_field is absent, null, or empty. Applied after any transform would have been applied. Allows optional feed fields to have a guaranteed baseline value."
+              },
+              "ext": {
+                "title": "Extension Object",
+                "description": "Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.",
+                "type": "object",
+                "additionalProperties": true
+              }
+            },
+            "allOf": [
+              {
+                "not": {
+                  "required": [
+                    "feed_field",
+                    "value"
+                  ]
+                }
+              },
+              {
+                "not": {
+                  "required": [
+                    "catalog_field",
+                    "asset_group_id"
+                  ]
+                }
+              }
+            ],
+            "additionalProperties": true,
+            "examples": [
+              {
+                "description": "Simple field rename",
+                "data": {
+                  "feed_field": "hotel_name",
+                  "catalog_field": "name"
+                }
+              },
+              {
+                "description": "Date format transform — YYYYMMDD to ISO 8601",
+                "data": {
+                  "feed_field": "available_from",
+                  "catalog_field": "valid_from",
+                  "transform": "date",
+                  "format": "YYYYMMDD",
+                  "timezone": "UTC"
+                }
+              },
+              {
+                "description": "Divide cents to dollars",
+                "data": {
+                  "feed_field": "price_cents",
+                  "catalog_field": "price.amount",
+                  "transform": "divide",
+                  "by": 100
+                }
+              },
+              {
+                "description": "Static literal injection — currency not in feed",
+                "data": {
+                  "catalog_field": "price.currency",
+                  "value": "USD"
+                }
+              },
+              {
+                "description": "Image URL assigned to typed asset pool",
+                "data": {
+                  "feed_field": "primary_photo_url",
+                  "asset_group_id": "images_landscape"
+                }
+              },
+              {
+                "description": "Vertical photo URL assigned to vertical pool",
+                "data": {
+                  "feed_field": "portrait_photo_url",
+                  "asset_group_id": "images_vertical"
+                }
+              },
+              {
+                "description": "Split comma-separated tags to array",
+                "data": {
+                  "feed_field": "amenity_list",
+                  "catalog_field": "amenities",
+                  "transform": "split",
+                  "separator": ","
+                }
+              },
+              {
+                "description": "Boolean coercion with default",
+                "data": {
+                  "feed_field": "is_available",
+                  "catalog_field": "available",
+                  "transform": "boolean",
+                  "default": false
+                }
+              }
+            ]
+          },
+          "minItems": 1
+        }
+      },
+      "required": [
+        "type"
+      ],
+      "additionalProperties": true,
+      "examples": [
+        {
+          "description": "Synced product catalog from Google Merchant Center",
+          "data": {
+            "catalog_id": "gmc-primary",
+            "name": "Primary Product Feed",
+            "type": "product",
+            "url": "https://feeds.acmecorp.com/products.xml",
+            "feed_format": "google_merchant_center",
+            "update_frequency": "daily"
+          }
+        },
+        {
+          "description": "Inventory feed for store-level stock data",
+          "data": {
+            "catalog_id": "store-inventory",
+            "name": "Store Inventory",
+            "type": "inventory",
+            "url": "https://feeds.acmecorp.com/inventory.json",
+            "feed_format": "custom",
+            "update_frequency": "hourly"
+          }
+        },
+        {
+          "description": "Store locator feed",
+          "data": {
+            "catalog_id": "retail-locations",
+            "name": "Retail Locations",
+            "type": "store",
+            "url": "https://feeds.acmecorp.com/stores.json",
+            "feed_format": "custom",
+            "update_frequency": "weekly"
+          }
+        },
+        {
+          "description": "Promotional pricing feed",
+          "data": {
+            "catalog_id": "summer-sale",
+            "name": "Summer Sale Promotions",
+            "type": "promotion",
+            "url": "https://feeds.acmecorp.com/promotions.json",
+            "feed_format": "google_merchant_center",
+            "update_frequency": "daily"
+          }
+        },
+        {
+          "description": "Inline offering catalog (no sync needed)",
+          "data": {
+            "type": "offering",
+            "items": [
+              {
+                "offering_id": "summer-sale",
+                "name": "Summer Sale",
+                "landing_url": "https://acme.com/summer"
+              }
+            ]
+          }
+        },
+        {
+          "description": "Reference to a previously synced catalog by ID",
+          "data": {
+            "catalog_id": "gmc-primary",
+            "type": "product",
+            "ids": [
+              "SKU-12345",
+              "SKU-67890"
+            ]
+          }
+        },
+        {
+          "description": "Product catalog with GTIN cross-retailer matching and attribution",
+          "data": {
+            "type": "product",
+            "gtins": [
+              "00013000006040",
+              "00013000006057"
+            ],
+            "content_id_type": "gtin",
+            "conversion_events": [
+              "purchase",
+              "add_to_cart"
+            ]
+          }
+        },
+        {
+          "description": "Inline store catalog with catchment areas",
+          "data": {
+            "catalog_id": "retail-locations",
+            "name": "Retail Locations",
+            "type": "store",
+            "items": [
+              {
+                "store_id": "amsterdam-flagship",
+                "name": "Amsterdam Flagship",
+                "location": {
+                  "lat": 52.3676,
+                  "lng": 4.9041
+                },
+                "catchments": [
+                  {
+                    "catchment_id": "walk",
+                    "travel_time": {
+                      "value": 10,
+                      "unit": "min"
+                    },
+                    "transport_mode": "walking"
+                  },
+                  {
+                    "catchment_id": "drive",
+                    "travel_time": {
+                      "value": 15,
+                      "unit": "min"
+                    },
+                    "transport_mode": "driving"
+                  }
+                ]
+              }
+            ]
+          }
+        }
+      ]
+    },
+    "account": {
+      "title": "Account Reference",
+      "description": "Account for product lookup. Returns products with pricing specific to this account's rate card.",
+      "type": "object",
+      "oneOf": [
+        {
+          "properties": {
+            "account_id": {
+              "type": "string",
+              "description": "Seller-assigned account identifier (from sync_accounts or list_accounts)",
+              "x-entity": "account"
+            }
+          },
+          "required": [
+            "account_id"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "properties": {
+            "brand": {
+              "title": "Brand Reference",
+              "description": "Brand reference identifying the advertiser",
+              "type": "object",
+              "properties": {
+                "domain": {
+                  "type": "string",
+                  "description": "Domain where /.well-known/brand.json is hosted, or the brand's operating domain",
+                  "pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"
+                },
+                "brand_id": {
+                  "title": "Brand ID",
+                  "description": "Brand identifier within the house portfolio. Optional for single-brand domains.",
+                  "type": "string",
+                  "pattern": "^[a-z0-9_]+$",
+                  "x-entity": "advertiser_brand",
+                  "examples": [
+                    "tide",
+                    "cheerios",
+                    "air_jordan",
+                    "nike",
+                    "pampers"
+                  ]
+                },
+                "industries": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Inline override for the brand's industries. Useful when the caller cannot modify the brand's canonical brand.json but needs to declare industries for governance (e.g., Annex III vertical detection). brand.json remains the canonical source; when omitted here, governance agents SHOULD resolve from brand.json."
+                },
+                "data_subject_contestation": {
+                  "type": "object",
+                  "description": "Inline override for the brand's contestation contact point. Useful when the operator does not control brand.json but needs to discharge Art 22(3) for this plan. brand.json is canonical; when omitted, governance agents resolve brand → house → missing.",
+                  "properties": {
+                    "url": {
+                      "type": "string",
+                      "format": "uri",
+                      "pattern": "^https://"
+                    },
+                    "email": {
+                      "type": "string",
+                      "format": "email"
+                    },
+                    "languages": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    }
+                  },
+                  "anyOf": [
+                    {
+                      "required": [
+                        "url"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "email"
+                      ]
+                    }
+                  ],
+                  "additionalProperties": false
+                }
+              },
+              "required": [
+                "domain"
+              ],
+              "additionalProperties": false,
+              "examples": [
+                {
+                  "domain": "nova-brands.com",
+                  "brand_id": "spark"
+                },
+                {
+                  "domain": "nova-brands.com",
+                  "brand_id": "glow"
+                },
+                {
+                  "domain": "acme-corp.com"
+                }
+              ]
+            },
+            "operator": {
+              "type": "string",
+              "description": "Domain of the entity operating on the brand's behalf. When the brand operates directly, this is the brand's domain.",
+              "pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$",
+              "x-entity": "operator"
+            },
+            "sandbox": {
+              "type": "boolean",
+              "description": "When true, references the sandbox account for this brand/operator pair. Defaults to false (production account).",
+              "default": false
+            }
+          },
+          "required": [
+            "brand",
+            "operator"
+          ],
+          "additionalProperties": false
+        }
+      ],
+      "examples": [
+        {
+          "account_id": "acc_acme_001"
+        },
+        {
+          "brand": {
+            "domain": "acme-corp.com"
+          },
+          "operator": "acme-corp.com"
+        },
+        {
+          "brand": {
+            "domain": "nova-brands.com",
+            "brand_id": "spark"
+          },
+          "operator": "pinnacle-media.com"
+        },
+        {
+          "brand": {
+            "domain": "acme-corp.com"
+          },
+          "operator": "acme-corp.com",
+          "sandbox": true
+        }
+      ]
+    },
+    "preferred_delivery_types": {
+      "type": "array",
+      "description": "Delivery types the buyer prefers, in priority order. Unlike filters.delivery_type which excludes non-matching products, this signals preference for curation — the publisher may still include other delivery types when they match the brief well.",
+      "items": {
+        "$ref": "#/$defs/DeliveryType"
+      },
+      "minItems": 1,
+      "uniqueItems": true
+    },
+    "filters": {
+      "title": "Product Filters",
+      "description": "Structured filters for product discovery",
+      "type": "object",
+      "properties": {
+        "delivery_type": {
+          "$ref": "#/$defs/DeliveryType"
+        },
+        "exclusivity": {
+          "title": "Exclusivity",
+          "description": "Filter by exclusivity level. Returns products matching the specified exclusivity (e.g., 'exclusive' returns only sole-sponsorship products).",
+          "type": "string",
+          "enum": [
+            "none",
+            "category",
+            "exclusive"
+          ],
+          "enumDescriptions": {
+            "none": "No exclusivity — multiple advertisers can buy this product simultaneously",
+            "category": "Category-exclusive — only one advertiser per industry category (e.g., one auto brand per collection sponsorship)",
+            "exclusive": "Sole sponsorship — only one advertiser can buy this product"
+          }
+        },
+        "is_fixed_price": {
+          "type": "boolean",
+          "description": "Filter by pricing availability: true = products offering fixed pricing (at least one option with fixed_price), false = products offering auction pricing (at least one option without fixed_price). Products with both fixed and auction options match both true and false."
+        },
+        "format_ids": {
+          "type": "array",
+          "description": "Filter by specific format IDs",
+          "items": {
+            "title": "Format Reference (Structured Object)",
+            "description": "A JSON object — never a plain string — that identifies a creative format by its declaring agent and local slug. Required properties: agent_url (URI of the agent that owns the format) and id (slug matching [a-zA-Z0-9_-]+). Example: {\"agent_url\": \"https://creative.adcontextprotocol.org\", \"id\": \"display_300x250\"}. Can reference: (1) a concrete format with fixed dimensions (id only), (2) a template format without parameters (id only), or (3) a template format with parameters (id + dimensions/duration). Template formats accept parameters in format_id while concrete formats have fixed dimensions in their definition. Parameterized format IDs create unique, specific format variants. Using a plain string here is a schema violation.",
+            "x-entity": "creative_format",
+            "type": "object",
+            "properties": {
+              "agent_url": {
+                "type": "string",
+                "format": "uri",
+                "description": "URL of the agent that defines this format (e.g., 'https://creative.adcontextprotocol.org' for standard formats, or 'https://publisher.com/.well-known/adcp/sales' for custom formats). Callers comparing two `format-id` values MUST canonicalize `agent_url` per the AdCP URL canonicalization rules before treating two formats as the same. See docs/reference/url-canonicalization."
+              },
+              "id": {
+                "type": "string",
+                "pattern": "^[a-zA-Z0-9_-]+$",
+                "description": "Format identifier within the agent's namespace (e.g., 'display_static', 'video_hosted', 'audio_standard'). When used alone, references a template format. When combined with dimension/duration fields, creates a parameterized format ID for a specific variant."
+              },
+              "width": {
+                "type": "integer",
+                "minimum": 1,
+                "description": "Width in pixels for visual formats. When specified, height must also be specified. Both fields together create a parameterized format ID for dimension-specific variants."
+              },
+              "height": {
+                "type": "integer",
+                "minimum": 1,
+                "description": "Height in pixels for visual formats. When specified, width must also be specified. Both fields together create a parameterized format ID for dimension-specific variants."
+              },
+              "duration_ms": {
+                "type": "number",
+                "minimum": 1,
+                "description": "Duration in milliseconds for time-based formats (video, audio). When specified, creates a parameterized format ID. Omit to reference a template format without parameters."
+              }
+            },
+            "required": [
+              "agent_url",
+              "id"
+            ],
+            "additionalProperties": true,
+            "dependencies": {
+              "width": [
+                "height"
+              ],
+              "height": [
+                "width"
+              ]
+            }
+          },
+          "minItems": 1
+        },
+        "standard_formats_only": {
+          "type": "boolean",
+          "description": "Only return products accepting IAB standard formats"
+        },
+        "min_exposures": {
+          "type": "integer",
+          "description": "Minimum exposures/impressions needed for measurement validity",
+          "minimum": 1
+        },
+        "start_date": {
+          "type": "string",
+          "format": "date",
+          "description": "Campaign start date (ISO 8601 date format: YYYY-MM-DD) for availability checks"
+        },
+        "end_date": {
+          "type": "string",
+          "format": "date",
+          "description": "Campaign end date (ISO 8601 date format: YYYY-MM-DD) for availability checks"
+        },
+        "budget_range": {
+          "type": "object",
+          "description": "Budget range to filter appropriate products",
+          "properties": {
+            "min": {
+              "type": "number",
+              "description": "Minimum budget amount",
+              "minimum": 0
+            },
+            "max": {
+              "type": "number",
+              "description": "Maximum budget amount",
+              "minimum": 0
+            },
+            "currency": {
+              "type": "string",
+              "description": "ISO 4217 currency code (e.g., 'USD', 'EUR', 'GBP')",
+              "pattern": "^[A-Z]{3}$"
+            }
+          },
+          "required": [
+            "currency"
+          ],
+          "anyOf": [
+            {
+              "required": [
+                "min"
+              ]
+            },
+            {
+              "required": [
+                "max"
+              ]
+            }
+          ],
+          "additionalProperties": true
+        },
+        "countries": {
+          "type": "array",
+          "description": "Filter by country coverage using ISO 3166-1 alpha-2 codes (e.g., ['US', 'CA', 'GB']). Works for all inventory types.",
+          "items": {
+            "type": "string",
+            "pattern": "^[A-Z]{2}$"
+          },
+          "minItems": 1
+        },
+        "regions": {
+          "type": "array",
+          "description": "Filter by region coverage using ISO 3166-2 codes (e.g., ['US-NY', 'US-CA', 'GB-SCT']). Use for locally-bound inventory (regional OOH, local TV) where products have region-specific coverage.",
+          "items": {
+            "type": "string",
+            "pattern": "^[A-Z]{2}-[A-Z0-9]+$"
+          },
+          "minItems": 1
+        },
+        "metros": {
+          "type": "array",
+          "description": "Filter by metro coverage for locally-bound inventory (radio, DOOH, local TV). Use when products have DMA/metro-specific coverage. For digital inventory where products have broad coverage, use required_geo_targeting instead to filter by seller capability.",
+          "items": {
+            "type": "object",
+            "properties": {
+              "system": {
+                "title": "Metro Area System",
+                "description": "Metro classification system",
+                "type": "string",
+                "enum": [
+                  "nielsen_dma",
+                  "uk_itl1",
+                  "uk_itl2",
+                  "eurostat_nuts2",
+                  "custom"
+                ]
+              },
+              "code": {
+                "type": "string",
+                "description": "Metro code within the system (e.g., '501' for NYC DMA)"
+              }
+            },
+            "required": [
+              "system",
+              "code"
+            ],
+            "additionalProperties": false
+          },
+          "minItems": 1
+        },
+        "channels": {
+          "type": "array",
+          "description": "Filter by advertising channels (e.g., ['display', 'ctv', 'dooh'])",
+          "items": {
+            "title": "Media Channel",
+            "description": "Standardized advertising media channels describing how buyers allocate budget. Channels are planning abstractions, not technical substrates. See the Media Channel Taxonomy specification for detailed definitions.",
+            "type": "string",
+            "enum": [
+              "display",
+              "olv",
+              "social",
+              "search",
+              "ctv",
+              "linear_tv",
+              "radio",
+              "streaming_audio",
+              "podcast",
+              "dooh",
+              "ooh",
+              "print",
+              "cinema",
+              "email",
+              "gaming",
+              "retail_media",
+              "influencer",
+              "affiliate",
+              "product_placement",
+              "sponsored_intelligence"
+            ],
+            "enumDescriptions": {
+              "display": "Digital display advertising (banners, native, rich media) across web and app",
+              "olv": "Online video advertising outside CTV (pre-roll, outstream, in-app video)",
+              "social": "Social media platforms (Facebook, Instagram, TikTok, LinkedIn, etc.)",
+              "search": "Search engine advertising and search networks",
+              "ctv": "Connected TV and streaming on television screens",
+              "linear_tv": "Traditional broadcast and cable television",
+              "radio": "Traditional AM/FM radio broadcast",
+              "streaming_audio": "Digital audio streaming services (Spotify, Pandora, etc.)",
+              "podcast": "Podcast advertising (host-read or dynamically inserted)",
+              "dooh": "Digital out-of-home screens in public spaces",
+              "ooh": "Classic out-of-home (physical billboards, transit, etc.)",
+              "print": "Newspapers, magazines, and other print publications",
+              "cinema": "Movie theater advertising",
+              "email": "Email advertising and sponsored newsletter content",
+              "gaming": "In-game advertising across platforms",
+              "retail_media": "Retail media networks and commerce marketplaces (Amazon, Walmart, Instacart)",
+              "influencer": "Creator and influencer marketing partnerships",
+              "affiliate": "Affiliate networks, comparison sites, and performance-based partnerships",
+              "product_placement": "Product placement, branded content, and sponsorship integrations",
+              "sponsored_intelligence": "Sponsored Intelligence — advertising within AI assistants, AI search, and generative AI experiences via the reversed data flow"
+            }
+          },
+          "minItems": 1
+        },
+        "required_axe_integrations": {
+          "type": "array",
+          "description": "Deprecated: Use trusted_match filter instead. Filter to products executable through specific agentic ad exchanges. URLs are canonical identifiers.",
+          "deprecated": true,
+          "items": {
+            "type": "string",
+            "format": "uri"
+          },
+          "minItems": 1
+        },
+        "trusted_match": {
+          "type": "object",
+          "description": "Filter products by Trusted Match Protocol capabilities. Only products with matching TMP support are returned.",
+          "properties": {
+            "providers": {
+              "type": "array",
+              "description": "Filter to products with specific TMP providers and match types. Each entry identifies a provider by agent_url and optionally requires specific match capabilities. Products must match at least one entry.",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "agent_url": {
+                    "type": "string",
+                    "format": "uri",
+                    "description": "Provider's agent URL from the registry."
+                  },
+                  "context_match": {
+                    "type": "boolean",
+                    "description": "When true, require this provider to support context match."
+                  },
+                  "identity_match": {
+                    "type": "boolean",
+                    "description": "When true, require this provider to support identity match."
+                  }
+                },
+                "required": [
+                  "agent_url"
+                ],
+                "additionalProperties": true
+              },
+              "minItems": 1
+            },
+            "response_types": {
+              "type": "array",
+              "description": "Filter to products supporting specific TMP response types (e.g., 'activation', 'creative', 'catalog_items'). Products must support at least one of the listed types.",
+              "items": {
+                "title": "TMP Response Type",
+                "description": "What the publisher wants back from a TMP context match. Determines the richness level of the buyer's offer response.",
+                "type": "string",
+                "enum": [
+                  "activation",
+                  "catalog_items",
+                  "creative",
+                  "deal"
+                ],
+                "enumDescriptions": {
+                  "activation": "Binary activation with GAM key-values. Offers identify the package via package_id.",
+                  "catalog_items": "Preferred catalog items for rendering. Offers may include catalog item references.",
+                  "creative": "Inline creative manifest. Offers include full rendering details.",
+                  "deal": "Deal ID for programmatic execution. Offers include deal metadata."
+                }
+              },
+              "minItems": 1
+            }
+          },
+          "additionalProperties": false
+        },
+        "required_features": {
+          "title": "Media Buy Features",
+          "description": "Filter to products from sellers supporting specific protocol features. Only features set to true are used for filtering.",
+          "type": "object",
+          "properties": {
+            "inline_creative_management": {
+              "type": "boolean",
+              "description": "Supports creatives provided inline in create_media_buy requests"
+            },
+            "property_list_filtering": {
+              "type": "boolean",
+              "description": "Honors property_list parameter in get_products to filter results to buyer-approved properties"
+            },
+            "catalog_management": {
+              "type": "boolean",
+              "description": "Supports sync_catalogs task for catalog feed management with platform review and approval"
+            }
+          },
+          "additionalProperties": {
+            "type": "boolean"
+          }
+        },
+        "required_geo_targeting": {
+          "type": "array",
+          "description": "Filter to products from sellers supporting specific geo targeting capabilities. Each entry specifies a targeting level (country, region, metro, postal_area) and optionally a system for levels that have multiple classification systems.",
+          "items": {
+            "type": "object",
+            "properties": {
+              "level": {
+                "title": "Geographic Targeting Level",
+                "description": "Geographic targeting level (country, region, metro, postal_area)",
+                "type": "string",
+                "enum": [
+                  "country",
+                  "region",
+                  "metro",
+                  "postal_area"
+                ]
+              },
+              "system": {
+                "type": "string",
+                "description": "Classification system within the level. Required for metro (e.g., 'nielsen_dma') and postal_area (e.g., 'us_zip'). Not applicable for country/region which use ISO standards."
+              }
+            },
+            "required": [
+              "level"
+            ],
+            "additionalProperties": false
+          },
+          "minItems": 1
+        },
+        "signal_targeting": {
+          "type": "array",
+          "description": "Filter to products supporting specific signals from data provider catalogs. Products must have the requested signals in their data_provider_signals and signal_targeting_allowed must be true (or all signals requested).",
+          "items": {
+            "title": "Signal Targeting",
+            "description": "Targeting constraint for a specific signal. Uses value_type as discriminator to determine the targeting expression format.",
+            "discriminator": {
+              "propertyName": "value_type"
+            },
+            "oneOf": [
+              {
+                "type": "object",
+                "description": "Binary signal targeting - user either matches or doesn't",
+                "properties": {
+                  "signal_id": {
+                    "title": "Signal ID",
+                    "description": "The signal to target",
+                    "x-entity": "signal",
+                    "discriminator": {
+                      "propertyName": "source"
+                    },
+                    "oneOf": [
+                      {
+                        "type": "object",
+                        "description": "Catalog signal - references a signal from a data provider's published catalog. Buyers can verify authorization by checking the data provider's adagents.json.",
+                        "properties": {
+                          "source": {
+                            "type": "string",
+                            "const": "catalog",
+                            "description": "Discriminator indicating this signal is from a data provider's published catalog"
+                          },
+                          "data_provider_domain": {
+                            "type": "string",
+                            "description": "Domain of the data provider that owns this signal (e.g., 'polk.com', 'experian.com'). The signal definition is published at this domain's /.well-known/adagents.json",
+                            "pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"
+                          },
+                          "id": {
+                            "type": "string",
+                            "pattern": "^[a-zA-Z0-9_-]+$",
+                            "description": "Signal identifier within the data provider's catalog (e.g., 'likely_tesla_buyers', 'income_100k_plus')"
+                          }
+                        },
+                        "required": [
+                          "source",
+                          "data_provider_domain",
+                          "id"
+                        ],
+                        "additionalProperties": true
+                      },
+                      {
+                        "type": "object",
+                        "description": "Agent signal - references a signal native to the signals agent. Not externally verifiable; buyer trusts the agent's claim about the signal.",
+                        "properties": {
+                          "source": {
+                            "type": "string",
+                            "const": "agent",
+                            "description": "Discriminator indicating this signal is native to the agent (not from a data provider catalog)"
+                          },
+                          "agent_url": {
+                            "type": "string",
+                            "format": "uri",
+                            "description": "URL of the signals agent that provides this signal (e.g., 'https://liveramp.com/.well-known/adcp/signals')"
+                          },
+                          "id": {
+                            "type": "string",
+                            "pattern": "^[a-zA-Z0-9_-]+$",
+                            "description": "Signal identifier within the agent's signal set (e.g., 'custom_auto_intenders')"
+                          }
+                        },
+                        "required": [
+                          "source",
+                          "agent_url",
+                          "id"
+                        ],
+                        "additionalProperties": true
+                      }
+                    ]
+                  },
+                  "value_type": {
+                    "type": "string",
+                    "const": "binary",
+                    "description": "Discriminator for binary signals"
+                  },
+                  "value": {
+                    "type": "boolean",
+                    "description": "Whether to include (true) or exclude (false) users matching this signal"
+                  }
+                },
+                "required": [
+                  "signal_id",
+                  "value_type",
+                  "value"
+                ],
+                "additionalProperties": true
+              },
+              {
+                "type": "object",
+                "description": "Categorical signal targeting - target users with specific values",
+                "properties": {
+                  "signal_id": {
+                    "title": "Signal ID",
+                    "description": "The signal to target",
+                    "x-entity": "signal",
+                    "discriminator": {
+                      "propertyName": "source"
+                    },
+                    "oneOf": [
+                      {
+                        "type": "object",
+                        "description": "Catalog signal - references a signal from a data provider's published catalog. Buyers can verify authorization by checking the data provider's adagents.json.",
+                        "properties": {
+                          "source": {
+                            "type": "string",
+                            "const": "catalog",
+                            "description": "Discriminator indicating this signal is from a data provider's published catalog"
+                          },
+                          "data_provider_domain": {
+                            "type": "string",
+                            "description": "Domain of the data provider that owns this signal (e.g., 'polk.com', 'experian.com'). The signal definition is published at this domain's /.well-known/adagents.json",
+                            "pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"
+                          },
+                          "id": {
+                            "type": "string",
+                            "pattern": "^[a-zA-Z0-9_-]+$",
+                            "description": "Signal identifier within the data provider's catalog (e.g., 'likely_tesla_buyers', 'income_100k_plus')"
+                          }
+                        },
+                        "required": [
+                          "source",
+                          "data_provider_domain",
+                          "id"
+                        ],
+                        "additionalProperties": true
+                      },
+                      {
+                        "type": "object",
+                        "description": "Agent signal - references a signal native to the signals agent. Not externally verifiable; buyer trusts the agent's claim about the signal.",
+                        "properties": {
+                          "source": {
+                            "type": "string",
+                            "const": "agent",
+                            "description": "Discriminator indicating this signal is native to the agent (not from a data provider catalog)"
+                          },
+                          "agent_url": {
+                            "type": "string",
+                            "format": "uri",
+                            "description": "URL of the signals agent that provides this signal (e.g., 'https://liveramp.com/.well-known/adcp/signals')"
+                          },
+                          "id": {
+                            "type": "string",
+                            "pattern": "^[a-zA-Z0-9_-]+$",
+                            "description": "Signal identifier within the agent's signal set (e.g., 'custom_auto_intenders')"
+                          }
+                        },
+                        "required": [
+                          "source",
+                          "agent_url",
+                          "id"
+                        ],
+                        "additionalProperties": true
+                      }
+                    ]
+                  },
+                  "value_type": {
+                    "type": "string",
+                    "const": "categorical",
+                    "description": "Discriminator for categorical signals"
+                  },
+                  "values": {
+                    "type": "array",
+                    "description": "Values to target. Users with any of these values will be included.",
+                    "items": {
+                      "type": "string"
+                    },
+                    "minItems": 1
+                  }
+                },
+                "required": [
+                  "signal_id",
+                  "value_type",
+                  "values"
+                ],
+                "additionalProperties": true
+              },
+              {
+                "type": "object",
+                "description": "Numeric signal targeting - target users within a value range. If min_value is provided, it must be <= max_value. Values should be within the signal's defined range (see signal definition).",
+                "properties": {
+                  "signal_id": {
+                    "title": "Signal ID",
+                    "description": "The signal to target",
+                    "x-entity": "signal",
+                    "discriminator": {
+                      "propertyName": "source"
+                    },
+                    "oneOf": [
+                      {
+                        "type": "object",
+                        "description": "Catalog signal - references a signal from a data provider's published catalog. Buyers can verify authorization by checking the data provider's adagents.json.",
+                        "properties": {
+                          "source": {
+                            "type": "string",
+                            "const": "catalog",
+                            "description": "Discriminator indicating this signal is from a data provider's published catalog"
+                          },
+                          "data_provider_domain": {
+                            "type": "string",
+                            "description": "Domain of the data provider that owns this signal (e.g., 'polk.com', 'experian.com'). The signal definition is published at this domain's /.well-known/adagents.json",
+                            "pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"
+                          },
+                          "id": {
+                            "type": "string",
+                            "pattern": "^[a-zA-Z0-9_-]+$",
+                            "description": "Signal identifier within the data provider's catalog (e.g., 'likely_tesla_buyers', 'income_100k_plus')"
+                          }
+                        },
+                        "required": [
+                          "source",
+                          "data_provider_domain",
+                          "id"
+                        ],
+                        "additionalProperties": true
+                      },
+                      {
+                        "type": "object",
+                        "description": "Agent signal - references a signal native to the signals agent. Not externally verifiable; buyer trusts the agent's claim about the signal.",
+                        "properties": {
+                          "source": {
+                            "type": "string",
+                            "const": "agent",
+                            "description": "Discriminator indicating this signal is native to the agent (not from a data provider catalog)"
+                          },
+                          "agent_url": {
+                            "type": "string",
+                            "format": "uri",
+                            "description": "URL of the signals agent that provides this signal (e.g., 'https://liveramp.com/.well-known/adcp/signals')"
+                          },
+                          "id": {
+                            "type": "string",
+                            "pattern": "^[a-zA-Z0-9_-]+$",
+                            "description": "Signal identifier within the agent's signal set (e.g., 'custom_auto_intenders')"
+                          }
+                        },
+                        "required": [
+                          "source",
+                          "agent_url",
+                          "id"
+                        ],
+                        "additionalProperties": true
+                      }
+                    ]
+                  },
+                  "value_type": {
+                    "type": "string",
+                    "const": "numeric",
+                    "description": "Discriminator for numeric signals"
+                  },
+                  "min_value": {
+                    "type": "number",
+                    "description": "Minimum value (inclusive). Omit for no minimum. Must be <= max_value when both are provided. Should be >= signal's range.min if defined."
+                  },
+                  "max_value": {
+                    "type": "number",
+                    "description": "Maximum value (inclusive). Omit for no maximum. Must be >= min_value when both are provided. Should be <= signal's range.max if defined."
+                  }
+                },
+                "required": [
+                  "signal_id",
+                  "value_type"
+                ],
+                "additionalProperties": true
+              }
+            ]
+          },
+          "minItems": 1
+        },
+        "postal_areas": {
+          "type": "array",
+          "description": "Filter by postal area coverage for locally-bound inventory (direct mail, DOOH, local campaigns). Use when products have postal-area-specific coverage. For digital inventory where products have broad coverage, use required_geo_targeting instead to filter by seller capability.",
+          "items": {
+            "type": "object",
+            "properties": {
+              "system": {
+                "title": "Postal Code System",
+                "description": "Postal code system (e.g., 'us_zip', 'gb_outward')",
+                "type": "string",
+                "enum": [
+                  "us_zip",
+                  "us_zip_plus_four",
+                  "gb_outward",
+                  "gb_full",
+                  "ca_fsa",
+                  "ca_full",
+                  "de_plz",
+                  "fr_code_postal",
+                  "au_postcode",
+                  "ch_plz",
+                  "at_plz"
+                ]
+              },
+              "values": {
+                "type": "array",
+                "description": "Postal codes within the system (e.g., ['10001', '10002'] for us_zip)",
+                "items": {
+                  "type": "string"
+                },
+                "minItems": 1
+              }
+            },
+            "required": [
+              "system",
+              "values"
+            ],
+            "additionalProperties": false
+          },
+          "minItems": 1
+        },
+        "geo_proximity": {
+          "type": "array",
+          "description": "Filter by proximity to geographic points. Returns products with inventory coverage near these locations. Follows the same format as the targeting overlay — each entry uses exactly one method: travel_time + transport_mode, radius, or geometry. For locally-bound inventory (DOOH, radio), filters to products with coverage in the area. For digital inventory, filters to products from sellers supporting geo_proximity targeting.",
+          "items": {
+            "type": "object",
+            "properties": {
+              "lat": {
+                "type": "number",
+                "minimum": -90,
+                "maximum": 90,
+                "description": "Latitude in decimal degrees (WGS 84)"
+              },
+              "lng": {
+                "type": "number",
+                "minimum": -180,
+                "maximum": 180,
+                "description": "Longitude in decimal degrees (WGS 84)"
+              },
+              "label": {
+                "type": "string",
+                "description": "Human-readable label (e.g., 'Düsseldorf', 'Heathrow Airport')"
+              },
+              "travel_time": {
+                "type": "object",
+                "description": "Travel time limit for isochrone calculation",
+                "properties": {
+                  "value": {
+                    "type": "number",
+                    "minimum": 1,
+                    "description": "Travel time limit"
+                  },
+                  "unit": {
+                    "title": "Travel Time Unit",
+                    "description": "Time unit for isochrone (travel-time catchment) calculations.",
+                    "type": "string",
+                    "enum": [
+                      "min",
+                      "hr"
+                    ],
+                    "enumDescriptions": {
+                      "min": "Minutes",
+                      "hr": "Hours"
+                    }
+                  }
+                },
+                "required": [
+                  "value",
+                  "unit"
+                ],
+                "additionalProperties": false
+              },
+              "transport_mode": {
+                "title": "Transport Mode",
+                "description": "Transportation mode for isochrone calculation. Required when travel_time is provided.",
+                "type": "string",
+                "enum": [
+                  "walking",
+                  "cycling",
+                  "driving",
+                  "public_transport"
+                ],
+                "enumDescriptions": {
+                  "walking": "Pedestrian travel on walkable paths and sidewalks",
+                  "cycling": "Bicycle travel on roads and cycle paths",
+                  "driving": "Motor vehicle travel on road networks",
+                  "public_transport": "Public transit including bus, rail, metro, and ferry"
+                }
+              },
+              "radius": {
+                "type": "object",
+                "description": "Simple radius from the point",
+                "properties": {
+                  "value": {
+                    "type": "number",
+                    "exclusiveMinimum": 0,
+                    "description": "Radius distance"
+                  },
+                  "unit": {
+                    "title": "Distance Unit",
+                    "description": "Distance unit",
+                    "type": "string",
+                    "enum": [
+                      "km",
+                      "mi",
+                      "m"
+                    ],
+                    "enumDescriptions": {
+                      "km": "Kilometers",
+                      "mi": "Miles",
+                      "m": "Meters"
+                    }
+                  }
+                },
+                "required": [
+                  "value",
+                  "unit"
+                ],
+                "additionalProperties": false
+              },
+              "geometry": {
+                "type": "object",
+                "description": "Pre-computed GeoJSON geometry defining the proximity boundary",
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "enum": [
+                      "Polygon",
+                      "MultiPolygon"
+                    ],
+                    "description": "GeoJSON geometry type"
+                  },
+                  "coordinates": {
+                    "type": "array",
+                    "description": "GeoJSON coordinates array"
+                  }
+                },
+                "required": [
+                  "type",
+                  "coordinates"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "oneOf": [
+              {
+                "required": [
+                  "lat",
+                  "lng",
+                  "travel_time",
+                  "transport_mode"
+                ],
+                "not": {
+                  "anyOf": [
+                    {
+                      "required": [
+                        "radius"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "geometry"
+                      ]
+                    }
+                  ]
+                }
+              },
+              {
+                "required": [
+                  "lat",
+                  "lng",
+                  "radius"
+                ],
+                "not": {
+                  "anyOf": [
+                    {
+                      "required": [
+                        "travel_time"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "geometry"
+                      ]
+                    }
+                  ]
+                }
+              },
+              {
+                "required": [
+                  "geometry"
+                ],
+                "not": {
+                  "anyOf": [
+                    {
+                      "required": [
+                        "travel_time"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "radius"
+                      ]
+                    }
+                  ]
+                }
+              }
+            ],
+            "additionalProperties": true
+          },
+          "minItems": 1
+        },
+        "required_performance_standards": {
+          "type": "array",
+          "description": "Filter to products that can meet the buyer's performance standard requirements. Each entry specifies a metric, minimum threshold, and optionally a required vendor and standard. Products that cannot meet these thresholds or do not support the specified vendors are excluded. Use this to tell the seller upfront: 'I need DoubleVerify for viewability at 70% MRC.'",
+          "items": {
+            "title": "Performance Standard",
+            "description": "A rate threshold for a performance metric, measured by a specified vendor. The threshold is a floor or ceiling depending on the metric: viewability, completion_rate, brand_safety, and attention_score are floors (must exceed); ivt is a ceiling (must not exceed).",
+            "type": "object",
+            "properties": {
+              "metric": {
+                "title": "Performance Standard Metric",
+                "description": "The performance metric this standard applies to.",
+                "type": "string",
+                "enum": [
+                  "viewability",
+                  "ivt",
+                  "completion_rate",
+                  "brand_safety",
+                  "attention_score"
+                ],
+                "enumDescriptions": {
+                  "viewability": "Viewable impression rate (floor — must exceed threshold). Requires viewability_standard. Denominator: measurable_impressions.",
+                  "ivt": "Invalid Traffic rate (ceiling — must not exceed threshold). Denominator: total_impressions.",
+                  "completion_rate": "Video or audio completion rate (floor — must exceed threshold). Denominator: total_impressions.",
+                  "brand_safety": "Brand-safe impression rate (floor — must exceed threshold). Denominator: total_impressions.",
+                  "attention_score": "Attention score rate (floor — must exceed threshold). Denominator: measurable_impressions."
+                }
+              },
+              "threshold": {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 1,
+                "description": "Rate threshold as a decimal (e.g., 0.70 for 70%). Whether this is a floor or ceiling depends on the metric: for viewability, completion_rate, brand_safety, attention_score the actual rate must be >= threshold; for ivt the actual rate must be <= threshold."
+              },
+              "standard": {
+                "title": "Viewability Standard",
+                "description": "Measurement standard. Required when metric is 'viewability' (MRC and GroupM define materially different thresholds). Omit for other metrics.",
+                "type": "string",
+                "enum": [
+                  "mrc",
+                  "groupm"
+                ],
+                "enumDescriptions": {
+                  "mrc": "MRC/IAB standard: 50% of pixels in view for 1 continuous second (display) or 2 continuous seconds (video).",
+                  "groupm": "GroupM standard: 100% of pixels in view for 1 continuous second (display) or 50% of video duration."
+                }
+              },
+              "vendor": {
+                "title": "Brand Reference",
+                "description": "Vendor measuring this metric (e.g., { domain: 'doubleverify.com' }). The vendor's brand.json agents array (type: 'measurement') is the discovery point for their measurement agent. When specified on a confirmed package, creatives MUST include tracker_script or tracker_pixel assets from this vendor.",
+                "type": "object",
+                "properties": {
+                  "domain": {
+                    "type": "string",
+                    "description": "Domain where /.well-known/brand.json is hosted, or the brand's operating domain",
+                    "pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"
+                  },
+                  "brand_id": {
+                    "title": "Brand ID",
+                    "description": "Brand identifier within the house portfolio. Optional for single-brand domains.",
+                    "type": "string",
+                    "pattern": "^[a-z0-9_]+$",
+                    "x-entity": "advertiser_brand",
+                    "examples": [
+                      "tide",
+                      "cheerios",
+                      "air_jordan",
+                      "nike",
+                      "pampers"
+                    ]
+                  },
+                  "industries": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    },
+                    "description": "Inline override for the brand's industries. Useful when the caller cannot modify the brand's canonical brand.json but needs to declare industries for governance (e.g., Annex III vertical detection). brand.json remains the canonical source; when omitted here, governance agents SHOULD resolve from brand.json."
+                  },
+                  "data_subject_contestation": {
+                    "type": "object",
+                    "description": "Inline override for the brand's contestation contact point. Useful when the operator does not control brand.json but needs to discharge Art 22(3) for this plan. brand.json is canonical; when omitted, governance agents resolve brand → house → missing.",
+                    "properties": {
+                      "url": {
+                        "type": "string",
+                        "format": "uri",
+                        "pattern": "^https://"
+                      },
+                      "email": {
+                        "type": "string",
+                        "format": "email"
+                      },
+                      "languages": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      }
+                    },
+                    "anyOf": [
+                      {
+                        "required": [
+                          "url"
+                        ]
+                      },
+                      {
+                        "required": [
+                          "email"
+                        ]
+                      }
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "required": [
+                  "domain"
+                ],
+                "additionalProperties": false,
+                "examples": [
+                  {
+                    "domain": "nova-brands.com",
+                    "brand_id": "spark"
+                  },
+                  {
+                    "domain": "nova-brands.com",
+                    "brand_id": "glow"
+                  },
+                  {
+                    "domain": "acme-corp.com"
+                  }
+                ]
+              }
+            },
+            "required": [
+              "metric",
+              "threshold",
+              "vendor"
+            ],
+            "additionalProperties": true
+          },
+          "minItems": 1
+        },
+        "keywords": {
+          "type": "array",
+          "description": "Filter by keyword relevance for search and retail media platforms. Returns products that support keyword targeting for these terms. Allows the sell-side agent to assess keyword availability and recommend appropriate products. Use match_type to indicate the desired precision.",
+          "items": {
+            "type": "object",
+            "properties": {
+              "keyword": {
+                "type": "string",
+                "minLength": 1,
+                "description": "The keyword to target"
+              },
+              "match_type": {
+                "title": "Match Type",
+                "description": "Keyword targeting match type. broad: ads may serve on queries semantically related to the keyword. phrase: ads serve when the query contains the keyword phrase. exact: ads serve only when the query matches the keyword exactly.",
+                "type": "string",
+                "enum": [
+                  "broad",
+                  "phrase",
+                  "exact"
+                ],
+                "enumDescriptions": {
+                  "broad": "Ads may serve on queries semantically related to the keyword",
+                  "phrase": "Ads serve when the query contains the keyword phrase in order",
+                  "exact": "Ads serve only when the query matches the keyword exactly"
+                },
+                "default": "broad"
+              }
+            },
+            "required": [
+              "keyword"
+            ],
+            "additionalProperties": false
+          },
+          "minItems": 1
+        }
+      },
+      "additionalProperties": true
+    },
+    "property_list": {
+      "title": "Property List Reference",
+      "description": "[AdCP 3.0] Reference to an externally managed property list. When provided, the sales agent should filter products to only those available on properties in the list.",
+      "type": "object",
+      "properties": {
+        "agent_url": {
+          "type": "string",
+          "format": "uri",
+          "description": "URL of the agent managing the property list"
+        },
+        "list_id": {
+          "type": "string",
+          "description": "Identifier for the property list within the agent",
+          "minLength": 1,
+          "x-entity": "property_list"
+        },
+        "auth_token": {
+          "type": "string",
+          "description": "JWT or other authorization token for accessing the list. Optional if the list is public or caller has implicit access."
+        }
+      },
+      "required": [
+        "agent_url",
+        "list_id"
+      ],
+      "additionalProperties": false
+    },
+    "fields": {
+      "type": "array",
+      "description": "Specific product fields to include in the response. When omitted, all fields are returned. Use for lightweight discovery calls where only a subset of product data is needed (e.g., just IDs and pricing for comparison). Required fields (product_id, name) are always included regardless of selection.",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "enum": [
+          "product_id",
+          "name",
+          "description",
+          "publisher_properties",
+          "channels",
+          "format_ids",
+          "placements",
+          "delivery_type",
+          "exclusivity",
+          "pricing_options",
+          "forecast",
+          "outcome_measurement",
+          "delivery_measurement",
+          "reporting_capabilities",
+          "creative_policy",
+          "catalog_types",
+          "metric_optimization",
+          "conversion_tracking",
+          "data_provider_signals",
+          "max_optimization_goals",
+          "catalog_match",
+          "collections",
+          "collection_targeting_allowed",
+          "installments",
+          "brief_relevance",
+          "expires_at",
+          "product_card",
+          "product_card_detailed",
+          "enforced_policies",
+          "trusted_match"
+        ]
+      }
+    },
+    "time_budget": {
+      "allOf": [
+        {
+          "title": "Duration",
+          "description": "A time duration expressed as an interval and unit. Used for frequency cap windows, attribution windows, reach optimization windows, time budgets, and other time-based settings. When unit is 'campaign', interval must be 1 — the window spans the full campaign flight.",
+          "type": "object",
+          "properties": {
+            "interval": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "Number of time units. Must be 1 when unit is 'campaign'."
+            },
+            "unit": {
+              "type": "string",
+              "enum": [
+                "seconds",
+                "minutes",
+                "hours",
+                "days",
+                "campaign"
+              ],
+              "description": "Time unit. 'seconds' for sub-minute precision. 'campaign' spans the full campaign flight."
+            }
+          },
+          "required": [
+            "interval",
+            "unit"
+          ],
+          "additionalProperties": false
+        }
+      ],
+      "description": "Maximum time the buyer will commit to this request. The seller returns the best results achievable within this budget and does not start processes (human approvals, expensive external queries) that cannot complete in time. When omitted, the seller decides timing."
+    },
+    "pagination": {
+      "title": "Pagination Request",
+      "description": "Standard cursor-based pagination parameters for list operations",
+      "type": "object",
+      "properties": {
+        "max_results": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 100,
+          "default": 50,
+          "description": "Maximum number of items to return per page"
+        },
+        "cursor": {
+          "type": "string",
+          "description": "Opaque cursor from a previous response to fetch the next page"
+        }
+      },
+      "additionalProperties": false
+    },
+    "context": {
+      "title": "Context Object",
+      "description": "Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.",
+      "type": "object",
+      "additionalProperties": true
+    },
+    "required_policies": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Registry policy IDs that the buyer requires to be enforced for products in this response. Sellers filter products to only those that comply with or already enforce the requested policies."
+    },
+    "ext": {
+      "title": "Extension Object",
+      "description": "Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.",
+      "type": "object",
+      "additionalProperties": true
+    }
+  },
+  "required": [
+    "buying_mode"
+  ],
+  "dependencies": {
+    "catalog": [
+      "brand"
+    ]
+  },
+  "additionalProperties": true,
+  "$defs": {
+    "DeliveryType": {
+      "title": "Delivery Type",
+      "description": "Type of inventory delivery",
+      "type": "string",
+      "enum": [
+        "guaranteed",
+        "non_guaranteed"
+      ],
+      "enumDescriptions": {
+        "guaranteed": "Reserved inventory with guaranteed delivery",
+        "non_guaranteed": "Auction-based inventory without delivery guarantees"
+      }
+    }
+  },
+  "_bundled": {
+    "generatedAt": "2026-04-28T12:32:22.988Z",
+    "note": "This is a bundled schema with all $ref resolved inline. For the modular version with references, use the parent directory."
+  }
+}