From 475424d6678324e07ea35c9ed1e9f856284d7112 Mon Sep 17 00:00:00 2001 From: agustinespildora Date: Thu, 18 Jun 2026 12:22:00 -0400 Subject: [PATCH 1/2] feat: add marketplaceExperimentVariant to sponsored listings auction Document the optional marketplaceExperimentVariant field (max 10 chars) on the SponsoredListingsAuction request. The engine already accepts, validates and records it in auction reporting (resolved_auction_bids and auction_report); this exposes it in the public docs with a disclaimer so clients can tag and analyze their own experiments. Co-authored-by: Cursor Agent --- topsort-api-v2.yml | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/topsort-api-v2.yml b/topsort-api-v2.yml index b4bde63..15645dc 100644 --- a/topsort-api-v2.yml +++ b/topsort-api-v2.yml @@ -1024,6 +1024,17 @@ components: $ref: "#/components/schemas/Page" filter: $ref: "#/components/schemas/AttributesFilter" + marketplaceExperimentVariant: + type: string + maxLength: 10 + description: > + Optional. A marketplace-defined experiment variant tag (maximum 10 characters). By + default Topsort does not change auction behavior based on this value; it is recorded + alongside the auction so you can run your own A/B experiments and then slice the + resulting ad metrics (impressions, clicks, purchases) by variant. Contact your Topsort + representative if you want this value to influence auction behavior. + examples: + - exp_a demandSources: type: array items: From 7bd01b6b5cdc633a742d0721275215a095215b27 Mon Sep 17 00:00:00 2001 From: agustinespildora Date: Thu, 18 Jun 2026 12:28:27 -0400 Subject: [PATCH 2/2] fix: drop redundant minimum on qualityScores items Products.qualityScores items declared both exclusiveMinimum: 0 and minimum: 0, which redocly's recommended-strict no-mixed-number-range-constraints rule rejects. exclusiveMinimum: 0 already encodes the "greater than 0" constraint and matches the QualityScore component and price field conventions. Co-authored-by: Cursor Agent --- topsort-api-v2.yml | 1 - 1 file changed, 1 deletion(-) diff --git a/topsort-api-v2.yml b/topsort-api-v2.yml index 15645dc..f2b9268 100644 --- a/topsort-api-v2.yml +++ b/topsort-api-v2.yml @@ -1779,7 +1779,6 @@ components: type: number maximum: 1 exclusiveMinimum: 0 - minimum: 0 examples: - 0.75 format: double