LeaderboardBack to leaderboard — loading return destination
Opening report…
Loading report overview
M
MCP server
server.example.com/mcp
Tools and resources for your MCP client, with a public quality report and detailed checks.
Protocol
MCP 2025-11-25
Server version
1.0.0
Website
server.example.com
Supports
Tools · Resources
Overall score
90 /100
How is this score calculated?
Server metadata
Loading server metadata
Reviewed90/100
Discoverability
Loading discoverability
Reviewed90/100
Protocol
Loading protocol
Reviewed90/100
Tools
Loading tools
Reviewed90/100
MCP Apps
Loading mcp apps
Reviewed90/100
Tool documentation quality
Loading tool documentation quality
Reviewed90/100
LeaderboardBack to leaderboard — loading return destination
P
POD Benchmark
podbenchmark.com/api/mcp
Compare print-on-demand suppliers for the same product: product cost, shipping, delivered total and delivery time for US, UK, EU, Canadian and Australian buyers, plus profit after platform fees.
Compare print-on-demand suppliers for the same product: product cost, shipping, delivered total and delivery time for US, UK, EU, Canadian and Australian buyers, plus profit after platform fees.
POD Benchmark compares the same print-on-demand blank across suppliers such as Printify, Printful and Gelato, using prices it collects from each supplier. Every tool is read-only: it never places orders, opens links or touches a store.
Usual path: search_products (or resolve_supplier_link when the seller pastes a supplier link), then get_product_options for a specific size or color, then compare_product. Use list_suppliers and get_supplier for plans, fees and branding, get_supplier_prices for where one supplier is cheapest, and supplier_guide when a seller is choosing suppliers for a shop.
Ask only for what changes the answer: the product, and where buyers live (US, GB, DE, CA or AU). Pass the seller's current supplier, selling price or target margin, platform and shop country to compare_product once they mention them, rather than estimating profit yourself.
Report unknown prices as unknown, never as zero or as the cheapest. Rankings are product plus shipping; affiliate links never change them. Each result carries a podbenchmark.com url: share it so the seller can check the comparison and its sources.
Discoverability
2/6 passed2 of 6 passed33/100
Client listings and public setup information.
mcp.json or server-card.json
Either mcp.json or an MCP Server Card declaring this endpoint passes.
The manifest declares this MCP server's exact endpoint.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description96/100
Use this when a seller wants to find a print-on-demand (POD) product to compare across suppliers such as Printify, Printful, Gelato, Prodigi, Apliiq, Artelo, CustomCat, Fourthwall, Inkthreadable and merchOne. Search by product type such as T-shirt, hoodie or mug, or by brand and model such as Bella+Canvas 3001 or Gildan 5000, and filter by category, brand, supplier, audience, specs (fit, material, eco and more) or weight. Returns product ids, a starting delivered price for the destination and optional filter counts; compare a specific size or colour with compare_product. Supported destinations: US, GB, DE, AU, CA.
The description explains the capability, when to use it, and what to expect.
Inputs90/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
query
Product type, brand or model, such as `hoodie` or `bella canvas 3001`. Leave empty to browse with filters.
Clear enough to supply this argument.
category
A category id from list_categories, such as `t-shirts`.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
brands
Only these brands, by name such as `Gildan` or `Bella+Canvas`. includeFacets lists them.
Clear enough to supply this argument.
suppliers
Only products at least one of these suppliers sells.
Clear enough to supply this argument.
audiences
Such as unisex, mens, womens or kids.
Clear enough to supply this argument.
specs
Spec filters, any value per field, such as { "fit": ["classic"], "material": ["cotton"] }. includeFacets lists the values.
Clear enough to supply this argument.
minWeightOz
Lightest product weight to include, in ounces.
Clear enough to supply this argument.
maxWeightOz
Heaviest product weight to include, in ounces.
Clear enough to supply this argument.
pricedOnly
Only products with a delivered price for the destination.
Clear enough to supply this argument.
sort
Result order. cheapest and priciest use the starting delivered price; most-suppliers puts the most widely sold products first.
Clear enough to supply this argument.
destination
The buyer's country, where the order ships. Product cost, shipping and duty depend on it.
Clear enough to supply this argument.
currency
Currency for every price. Defaults to the destination's own currency.
Clear enough to supply this argument.
includeFacets
Also count brands, suppliers, audiences and spec values.
Clear enough to supply this argument.
limit
How many results to return.
Clear enough to supply this argument.
offset
How many results to skip. Pass nextOffset from the previous page.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description95/100
Use this when a seller wants to browse what POD Benchmark compares, or needs a category id to narrow search_products. Returns each category's id, name, parent, product count, supplier count and starting delivered price for the destination. Pass parent to list subcategories.
The description explains the capability, when to use it, and what to expect.
Inputs87/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
query
Words in the category name, such as `mugs`. Leave empty for all.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
parent
Only the children of this category.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
destination
The buyer's country, where the order ships. Product cost, shipping and duty depend on it.
Clear enough to supply this argument.
currency
Currency for every price. Defaults to the destination's own currency.
Clear enough to supply this argument.
limit
How many results to return.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
offset
How many results to skip. Pass nextOffset from the previous page.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description92/100
Use this when a seller asks about a product's specs, fabric, fit, print methods or what is similar to it. Returns curated product facts and similar products with what they share and how they differ. Specs describe the product; they do not promise every supplier offers every option.
The description explains the capability, when to use it, and what to expect.
Inputs75/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
canonicalProductId
A product id from search_products or resolve_supplier_link, such as `cotton-ringer-tee`.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
similarLimit
How many similar products to return. 0 skips them.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description93/100
Use this when a seller wants supplier pricing for a specific print-on-demand product size or color, such as an adult M black T-shirt or an 11 oz mug. Lists the product's fields and supported configurations for the destination and currency; narrow with words or choices. Pass a returned key as optionKey, or its choices, to compare_product. Search products first to obtain canonicalProductId. Supported destinations: US, GB, DE, AU, CA.
The description explains the capability, when to use it, and what to expect.
Inputs89/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
canonicalProductId
A product id from search_products or resolve_supplier_link, such as `cotton-ringer-tee`.
Clear enough to supply this argument.
destination
The buyer's country, where the order ships. Product cost, shipping and duty depend on it.
Clear enough to supply this argument.
currency
Currency for every price, such as USD, GBP or EUR.
Clear enough to supply this argument.
query
Words to narrow the list, such as `m black`.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
choices
Choices by field, such as { "size": "m", "color": "black" }. Values match a value key, its last part or its label, case-insensitively; get_product_options lists them.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
offset
How many results to skip. Pass nextOffset from the previous page.
Clear enough to supply this argument.
limit
How many results to return.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
{
"type": "object",
"oneOf": [
{
"type": "object",
"required": [
"ok",
"fields",
"options",
"totalCount",
"nextOffset",
"defaultOptionKey"
],
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"fields": {
"type": "array",
"items": {
"type": "object",
"required": [
"field",
"label",
"values"
],
"properties": {
"field": {
"type": "string",
"description": "The field name to use in `choices`, such as size or color."
},
"label": {
"type": "string",
"description": "The field as a person would say it, such as Size."
},
"values": {
"type": "array",
"items": {
"type": "object",
"required": [
"value",
"label"
],
"properties": {
"label": {
"type": "string",
"description": "That value as the supplier names it."
},
"value": {
"type": "string",
"description": "The value to pass back in `choices`."
}
},
"additionalProperties": false
},
"description": "The values this field has among the matching configurations."
}
},
"additionalProperties": false
},
"description": "The choice fields this product has and their available values."
},
"options": {
"type": "array",
"items": {
"type": "object",
"required": [
"key",
"label",
"choices",
"supplierCount"
],
"properties": {
"key": {
"type": "string",
"description": "The configuration's key, to pass as optionKey."
},
"label": {
"type": "string",
"description": "The configuration in words, such as `Adult M / Black`."
},
"choices": {
"type": "object",
"description": "The same choice by field, ready for compare_product `choices`.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"supplierCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many suppliers price this configuration."
}
},
"additionalProperties": false
},
"maxItems": 100,
"description": "The matching configurations."
},
"nextOffset": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
],
"description": "Offset to pass for the next page; null on the last page."
},
"totalCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many configurations match in total, across every page."
},
"defaultOptionKey": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The configuration compare_product uses when none is given; null when the product has none."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"ok",
"error"
],
"properties": {
"ok": {
"type": "boolean",
"const": false
},
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"enum": [
"invalid_input",
"not_found",
"product_not_found",
"invalid_option",
"comparison_unavailable",
"unavailable",
"rate_limited"
],
"type": "string",
"description": "The machine-readable reason the call failed."
},
"message": {
"type": "string",
"description": "What went wrong, in words, and what to do next."
},
"retryable": {
"type": "boolean",
"description": "Whether calling again could succeed."
}
},
"description": "The error this call returned instead of a result.",
"additionalProperties": false
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
Original tool metadata
{
"name": "get_product_options",
"title": "Find product configurations",
"description": "Use this when a seller wants supplier pricing for a specific print-on-demand product size or color, such as an adult M black T-shirt or an 11 oz mug. Lists the product's fields and supported configurations for the destination and currency; narrow with words or choices. Pass a returned key as optionKey, or its choices, to compare_product. Search products first to obtain canonicalProductId. Supported destinations: US, GB, DE, AU, CA.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"canonicalProductId",
"destination",
"currency"
],
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1,
"description": "How many results to return."
},
"query": {
"type": "string",
"default": "",
"maxLength": 120,
"description": "Words to narrow the list, such as `m black`."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 10000,
"minimum": 0,
"description": "How many results to skip. Pass nextOffset from the previous page."
},
"choices": {
"type": "object",
"description": "Choices by field, such as { \"size\": \"m\", \"color\": \"black\" }. Values match a value key, its last part or its label, case-insensitively; get_product_options lists them.",
"propertyNames": {
"type": "string",
"maxLength": 60,
"minLength": 1
},
"additionalProperties": {
"type": "string",
"maxLength": 120,
"minLength": 1
}
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "Currency for every price, such as USD, GBP or EUR."
},
"destination": {
"enum": [
"US",
"GB",
"DE",
"AU",
"CA"
],
"type": "string",
"description": "The buyer's country, where the order ships. Product cost, shipping and duty depend on it."
},
"canonicalProductId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]*$",
"description": "A product id from search_products or resolve_supplier_link, such as `cotton-ringer-tee`."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"oneOf": [
{
"type": "object",
"required": [
"ok",
"fields",
"options",
"totalCount",
"nextOffset",
"defaultOptionKey"
],
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"fields": {
"type": "array",
"items": {
"type": "object",
"required": [
"field",
"label",
"values"
],
"properties": {
"field": {
"type": "string",
"description": "The field name to use in `choices`, such as size or color."
},
"label": {
"type": "string",
"description": "The field as a person would say it, such as Size."
},
"values": {
"type": "array",
"items": {
"type": "object",
"required": [
"value",
"label"
],
"properties": {
"label": {
"type": "string",
"description": "That value as the supplier names it."
},
"value": {
"type": "string",
"description": "The value to pass back in `choices`."
}
},
"additionalProperties": false
},
"description": "The values this field has among the matching configurations."
}
},
"additionalProperties": false
},
"description": "The choice fields this product has and their available values."
},
"options": {
"type": "array",
"items": {
"type": "object",
"required": [
"key",
"label",
"choices",
"supplierCount"
],
"properties": {
"key": {
"type": "string",
"description": "The configuration's key, to pass as optionKey."
},
"label": {
"type": "string",
"description": "The configuration in words, such as `Adult M / Black`."
},
"choices": {
"type": "object",
"description": "The same choice by field, ready for compare_product `choices`.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"supplierCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many suppliers price this configuration."
}
},
"additionalProperties": false
},
"maxItems": 100,
"description": "The matching configurations."
},
"nextOffset": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
],
"description": "Offset to pass for the next page; null on the last page."
},
"totalCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many configurations match in total, across every page."
},
"defaultOptionKey": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The configuration compare_product uses when none is given; null when the product has none."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"ok",
"error"
],
"properties": {
"ok": {
"type": "boolean",
"const": false
},
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"enum": [
"invalid_input",
"not_found",
"product_not_found",
"invalid_option",
"comparison_unavailable",
"unavailable",
"rate_limited"
],
"type": "string",
"description": "The machine-readable reason the call failed."
},
"message": {
"type": "string",
"description": "What went wrong, in words, and what to do next."
},
"retryable": {
"type": "boolean",
"description": "Whether calling again could succeed."
}
},
"description": "The error this call returned instead of a result.",
"additionalProperties": false
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
},
"annotations": {
"title": "Find product configurations",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description95/100
Use this when a seller asks which print-on-demand (POD) supplier costs less for a product, wants a Printify vs Printful comparison, or needs product prices, shipping, delivered totals or delivery times. Compares Printify, Printful, Gelato, Prodigi, Apliiq, Artelo, CustomCat, Fourthwall, Inkthreadable and merchOne for one product and configuration, destination and currency. Search products first; for a specific size or color pass choices or an optionKey from get_product_options, otherwise it uses the product's usual configuration and returns its label. Totals and rankings are product + shipping; unknown costs stay null; similar products stay separate; affiliate links never change rankings. pricingTier base is standard pricing; use paid plans only when asked. supplier lists one supplier's every product and print provider for the choice. Seller context, only when the seller already said it: yourSupplier pins their current supplier first with the difference per sale; sellingPrice or targetMargin with salesChannel and shopLocation applies approved platform fees. When the seller mentions any of these, call again with them instead of estimating profit yourself; if salesChannel or shopLocation is missing, the result lists what to ask. Profit is an estimate before tax. Supplier-billed duty is separate: established, zero, a bounded estimate or unverified. Profit deducts established duty or a converted estimate; unverified duty or an unconverted native estimate leaves profit before that charge. Show one estimated duty amount (the converted upper endpoint, or the native one marked not converted), never a min–max range. Estimated or unverified duty and conditional design/setup prices never support a winner, gap or best-profit claim. VAT, sales tax and customer-paid import charges are excluded or marked unknown. Supported destinations: US, GB, DE, AU, CA. Not for ordering, store integrations, print-quality rankings or other destinations.
The description explains the capability, when to use it, and what to expect.
Inputs88/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
canonicalProductId
A product id from search_products or resolve_supplier_link, such as `cotton-ringer-tee`.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
destination
The buyer's country, where the order ships. Product cost, shipping and duty depend on it.
Clear enough to supply this argument.
currency
Currency for every price, such as USD, GBP or EUR.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
optionKey
An exact key from get_product_options.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
choices
Choices by field, such as { "size": "m", "color": "black" }. Values match a value key, its last part or its label, case-insensitively; get_product_options lists them.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
pricingTier
base is each supplier's standard price; tier1 and tier2 are its paid plans.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
supplier
Show only this supplier, with every product and print provider it offers for the choice.
Clear enough to supply this argument.
yourSupplier
The supplier the seller uses today. Only when the seller said so; never guess.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
sellingPrice
What the seller's customer pays for one selected configuration or pack, in the chosen currency, including any shipping the seller charges. Only when the seller said so.
Clear enough to supply this argument.
targetMargin
The share of the sale, in percent, the seller wants to keep after supplier cost and platform fees. Returns the price to charge with each supplier. Use instead of sellingPrice.
Clear enough to supply this argument.
salesChannel
The platform the seller sells on. Needed with sellingPrice or targetMargin for platform fees.
Clear enough to supply this argument.
shopLocation
The country the seller's shop is based in, which can differ from the destination the order ships to. Needed with sellingPrice or targetMargin for platform fees.
{
"type": "object",
"oneOf": [
{
"type": "object",
"required": [
"ok",
"product",
"destination",
"currency",
"pricingTier",
"optionKey",
"optionLabel",
"optionChoices",
"profit",
"yourSupplier",
"supplier",
"options",
"optionCount",
"suppliers",
"alternatives",
"priceContext",
"servedAt",
"affiliateDisclosure"
],
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"profit": {
"oneOf": [
{
"type": "object",
"required": [
"status"
],
"properties": {
"status": {
"type": "string",
"const": "off",
"description": "No selling price or target margin was given, so profit is not calculated."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"missing",
"message"
],
"properties": {
"status": {
"type": "string",
"const": "needs_input",
"description": "Profit needs the sales channel or the shop country before it can be calculated."
},
"message": {
"type": "string",
"description": "What to ask the seller, in words."
},
"missing": {
"type": "array",
"items": {
"enum": [
"salesChannel",
"shopLocation"
],
"type": "string"
},
"minItems": 1,
"description": "What to ask the seller for."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"message"
],
"properties": {
"status": {
"type": "string",
"const": "unavailable",
"description": "Profit cannot be calculated for this comparison."
},
"message": {
"type": "string",
"description": "Why profit is unavailable, in words."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"mode",
"sellingPrice",
"targetMargin",
"salesChannel",
"salesChannelLabel",
"shopLocation",
"fallbackFromLabel",
"feesCheckedAt"
],
"properties": {
"mode": {
"enum": [
"selling-price",
"target-margin"
],
"type": "string",
"description": "selling-price uses the price the seller gave; target-margin returns the price to charge."
},
"status": {
"type": "string",
"const": "ready",
"description": "Profit is calculated for every offer whose supplier cost is complete."
},
"salesChannel": {
"enum": [
"etsy",
"shopify",
"woocommerce",
"tiktok-shop"
],
"type": "string",
"description": "The sales channel whose platform fees apply."
},
"sellingPrice": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The selling price given, in the response currency; null with targetMargin."
},
"shopLocation": {
"enum": [
"US",
"GB",
"DE",
"AU",
"CA"
],
"type": "string",
"description": "The country the seller's shop is based in, which sets the fees."
},
"targetMargin": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The target margin in percent; null with sellingPrice."
},
"feesCheckedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The date of the fee research in use, as `YYYY-MM-DD`; null when unknown."
},
"fallbackFromLabel": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Set when the requested channel has no fees for the shop, so another was used."
},
"salesChannelLabel": {
"type": "string",
"description": "That sales channel as a person would say it."
}
},
"additionalProperties": false
}
],
"description": "Whether profit is shown, and the selling price or target margin it uses."
},
"options": {
"type": "array",
"items": {
"type": "object",
"required": [
"key",
"label"
],
"properties": {
"key": {
"type": "string",
"description": "The configuration's key, to pass as optionKey."
},
"label": {
"type": "string",
"description": "The configuration in words, such as `Adult M / Black`."
}
},
"additionalProperties": false
},
"maxItems": 100,
"description": "Up to 100 configurations the product supports, to pass as optionKey."
},
"product": {
"type": "object",
"required": [
"id",
"name",
"subtitle",
"category",
"url"
],
"properties": {
"id": {
"type": "string",
"description": "The product's id."
},
"url": {
"type": "string",
"format": "uri",
"description": "The product's comparison page with these choices applied."
},
"name": {
"type": "string",
"description": "The product's name."
},
"category": {
"type": "string",
"description": "The category slug from the product's path, such as `t-shirts`."
},
"subtitle": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "A short qualifier under the name; null when there is none."
}
},
"description": "The product that was compared.",
"additionalProperties": false
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "Currency for every price, such as USD, GBP or EUR."
},
"servedAt": {
"type": "string",
"description": "When this comparison's data was read, as an ISO date-time."
},
"supplier": {
"anyOf": [
{
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string",
"description": "The supplier's id."
},
"name": {
"type": "string",
"description": "The supplier's name."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Set when the request asked for one supplier's offers."
},
"optionKey": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The configuration compared, from the product's options; null when the product has none."
},
"suppliers": {
"type": "array",
"items": {
"type": "object",
"required": [
"offer",
"otherOffers",
"otherOfferCount"
],
"properties": {
"offer": {
"type": "object",
"required": [
"supplierId",
"supplier",
"provider",
"product",
"price",
"shipping",
"duty",
"priceBasis",
"delivered",
"currency",
"available",
"comparable",
"cheapest",
"mostKept",
"isYourSupplier",
"profit",
"versusYours",
"note",
"criticalDifferences",
"differencesUnresolved",
"pricingPlan",
"deliveryDaysMin",
"deliveryDaysMax",
"checkedAt",
"actionUrl",
"productUrl",
"affiliate",
"facts"
],
"properties": {
"duty": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Supplier-billed duty in the response currency, separate from the delivered total; 0 when the supplier bills none, null when unverified."
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "How this offer's configuration differs from the one asked about, in words; null when there is nothing to add."
},
"facts": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"value"
],
"properties": {
"label": {
"type": "string",
"description": "What the fact is about."
},
"value": {
"type": "string",
"description": "The fact's value."
}
},
"additionalProperties": false
},
"description": "Labelled facts about this offer, such as print method, size range and quantity."
},
"price": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Product cost in the response currency, before shipping; null when unknown, never 0."
},
"profit": {
"anyOf": [
{
"oneOf": [
{
"type": "object",
"required": [
"status",
"dutyStatus",
"qualification",
"sale",
"supplierCost",
"fees",
"feeBreakdown",
"keep",
"margin"
],
"properties": {
"fees": {
"type": "number",
"description": "Platform fees for this sale in the response currency."
},
"keep": {
"type": "number",
"description": "What the seller keeps per sale before tax, in the response currency."
},
"sale": {
"type": "number",
"description": "The selling price in the response currency; with targetMargin, the price to charge."
},
"margin": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Share of the sale the seller keeps, 0 to 1; null when the sale is zero."
},
"status": {
"type": "string",
"const": "calculated",
"description": "Profit could be worked out for this offer."
},
"dutyStatus": {
"enum": [
"known",
"estimated",
"unknown"
],
"type": "string",
"description": "How well the supplier-billed duty is established: known, estimated from bounded quotes, or unknown."
},
"feeBreakdown": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"amount"
],
"properties": {
"label": {
"type": "string",
"description": "The fee's name, such as transaction fee."
},
"amount": {
"type": "number",
"description": "The fee amount in the response currency."
}
},
"additionalProperties": false
},
"description": "Each platform fee and its amount."
},
"supplierCost": {
"type": "number",
"description": "What the supplier charges in the response currency: product, shipping and any known duty."
},
"qualification": {
"type": "string",
"description": "In words, whether supplier-billed duty is included in or left out of this profit."
},
"estimatedDutyDeducted": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "The estimated duty deducted from the sale; null when duty is known or was not deducted."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"reason"
],
"properties": {
"reason": {
"enum": [
"missing_cost",
"fees_unavailable",
"target_not_reachable"
],
"type": "string",
"description": "Why: the supplier cost is unknown, the platform fees are unavailable, or the target margin cannot be reached."
},
"status": {
"type": "string",
"const": "unavailable",
"description": "Profit could not be worked out for this offer."
}
},
"additionalProperties": false
}
]
},
{
"type": "null"
}
],
"description": "This offer's profit when a selling price or target margin was given; null otherwise."
},
"product": {
"type": "string",
"description": "The supplier's own name for the product."
},
"taxNote": {
"type": "string",
"description": "How VAT or sales tax applies to this price, in words."
},
"cheapest": {
"type": "boolean",
"description": "Has the lowest product plus shipping total among comparable offers; false when the comparison cannot rank suppliers."
},
"currency": {
"anyOf": [
{
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "The currency these amounts are in; null when no price is known."
},
"mostKept": {
"type": "boolean",
"description": "Leaves the seller the most per sale; false unless profit is shown and every supplier-billed duty is known."
},
"provider": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The print provider that makes the order, for a marketplace; null for a direct supplier."
},
"shipping": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Shipping cost in the response currency; null when unknown, never 0."
},
"supplier": {
"type": "string",
"description": "The supplier's name."
},
"actionUrl": {
"type": "string",
"format": "uri",
"description": "The main link out to this offer: the supplier's product page, or its sign-up page when the affiliate programme pays only for sign-ups."
},
"affiliate": {
"type": "boolean",
"description": "Whether actionUrl earns a commission; it never changes prices or rankings."
},
"available": {
"type": "boolean",
"description": "The supplier sells this configuration and quotes it for the destination."
},
"checkedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When this price was last checked, as an ISO date-time; null when unknown."
},
"delivered": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Product plus shipping in the response currency; null when the supplier cannot price it, never 0."
},
"comparable": {
"type": "boolean",
"description": "The priced configuration matches the requested choice closely enough to compare."
},
"dutySource": {
"anyOf": [
{
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "number",
"minimum": 0,
"description": "The supplier's own duty amount, in its own currency."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "The currency the supplier states that duty in."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The supplier's own duty charge as it states it; null when none is published."
},
"priceBasis": {
"type": "string",
"const": "product-and-shipping",
"description": "What the delivered total covers: product and shipping."
},
"productUrl": {
"type": "string",
"format": "uri",
"description": "The supplier's page for this product and configuration."
},
"supplierId": {
"type": "string",
"description": "The supplier's id."
},
"dutyOutcome": {
"anyOf": [
{
"enum": [
"charged",
"not_applicable",
"estimated",
"unknown"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "charged when the supplier bills duty, not_applicable when none applies, estimated when only a range is known, unknown when unverified."
},
"pricingPlan": {
"type": "string",
"description": "The supplier plan this price uses, such as Standard pricing."
},
"versusYours": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Per sale against the seller's own supplier: positive means the seller keeps more here. Uses profit when shown, otherwise the delivered total; null when the two cannot be compared."
},
"dutyEstimate": {
"anyOf": [
{
"type": "object",
"required": [
"native",
"converted"
],
"properties": {
"native": {
"type": "object",
"required": [
"min",
"max",
"currency",
"basis"
],
"properties": {
"max": {
"type": "number",
"minimum": 0,
"description": "Highest amount in this duty range, in this currency."
},
"min": {
"type": "number",
"minimum": 0,
"description": "Lowest amount in this duty range, in this currency."
},
"basis": {
"type": "string",
"const": "line_net_x_compatible_product_rate",
"description": "How the estimate was derived: the line's net price times the supplier's per-product duty rate."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "The currency of these duty amounts."
}
},
"description": "The duty estimate in the supplier's own currency.",
"additionalProperties": false
},
"converted": {
"anyOf": [
{
"type": "object",
"required": [
"min",
"max",
"currency"
],
"properties": {
"max": {
"type": "number",
"minimum": 0,
"description": "Highest amount in this duty range, in this currency."
},
"min": {
"type": "number",
"minimum": 0,
"description": "Lowest amount in this duty range, in this currency."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "The currency of these duty amounts."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The same estimate in the response currency; null when it could not be converted."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The bounded duty estimate when only a range is known; absent otherwise."
},
"pricingBasis": {
"type": "string",
"description": "The selected price basis and any setup disclosure, in words."
},
"isYourSupplier": {
"type": "boolean",
"description": "The supplier the seller said they use today."
},
"pricingContext": {
"type": "object",
"required": [
"basis",
"policyId",
"policyVersion",
"source",
"recurringConditions",
"newDesignSetup",
"physicalSelections"
],
"properties": {
"basis": {
"enum": [
"existing-supplier-digitised-design",
"digitisation-included"
],
"type": "string",
"description": "What the price assumes: an existing design the seller already has, or included digitisation."
},
"source": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What the supplier states about this price, in its own words."
},
"policyId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Which pricing policy this context follows."
},
"policyVersion": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The version of that pricing policy."
},
"newDesignSetup": {
"oneOf": [
{
"type": "object",
"required": [
"status",
"fees",
"applicability",
"application",
"includedInDeliveredTotal"
],
"properties": {
"fees": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"amount",
"currency",
"taxBasis",
"scope",
"source",
"conditions"
],
"properties": {
"kind": {
"enum": [
"standard",
"text-only",
"image",
"adjustment",
"back-or-side",
"setup"
],
"type": "string",
"description": "What the fee is for: standard, text-only, image, adjustment, back-or-side or setup."
},
"scope": {
"enum": [
"per-design",
"per-design-and-area",
"per-order",
"per-unit",
"unknown"
],
"type": "string",
"description": "What the fee applies to: per design, per design and area, per order, per unit or unknown."
},
"amount": {
"type": "number",
"minimum": 0,
"description": "The fee amount in its own currency."
},
"source": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What the supplier states about this fee."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "Original supplier currency; never converted along with the unit price."
},
"taxBasis": {
"enum": [
"ex-vat",
"unknown"
],
"type": "string",
"description": "Whether the fee is quoted before VAT (ex-vat) or unclear."
},
"conditions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600,
"minLength": 1
},
"maxItems": 12,
"description": "What must hold for this fee to apply."
}
},
"additionalProperties": false
},
"maxItems": 8,
"minItems": 1,
"description": "The setup fees the supplier lists."
},
"status": {
"type": "string",
"const": "listed",
"description": "The supplier lists a setup charge."
},
"application": {
"type": "string",
"const": "not-modelled",
"description": "Always not-modelled: the charge is disclosed but never added to a total."
},
"applicability": {
"enum": [
"design-dependent",
"selected"
],
"type": "string",
"description": "design-dependent when the fee depends on the artwork, selected when one fee applies to this order."
},
"includedInDeliveredTotal": {
"type": "boolean",
"const": false,
"description": "Always false: setup charges stay outside the delivered total."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"source",
"conditions"
],
"properties": {
"source": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What the supplier states about the inclusion."
},
"status": {
"type": "string",
"const": "included",
"description": "Digitisation is included, so there is no setup charge."
},
"conditions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600,
"minLength": 1
},
"maxItems": 12,
"description": "What must hold for the inclusion."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"reason"
],
"properties": {
"reason": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "Why the setup charge is unknown."
},
"source": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What the supplier states, when it says anything."
},
"status": {
"type": "string",
"const": "unknown",
"description": "Whether a setup charge applies could not be established."
}
},
"additionalProperties": false
}
],
"description": "How a new design's setup is charged, or that it is included."
},
"physicalSelections": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"axisId",
"valueId",
"axisLabel",
"valueLabel"
],
"properties": {
"kind": {
"enum": [
"sku-option",
"standard-configuration"
],
"type": "string",
"description": "sku-option changes the unit price; standard-configuration is a fixed default."
},
"axisId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The option field's id, such as size."
},
"valueId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The chosen value's id."
},
"axisLabel": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The option field as shown, such as Size."
},
"valueLabel": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The chosen value as shown, such as Adult M."
}
},
"additionalProperties": false
},
"maxItems": 8,
"description": "The supplier options this price was quoted for."
},
"recurringConditions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600,
"minLength": 1
},
"maxItems": 12,
"description": "What must remain true for this recurring unit price."
}
},
"description": "Present when this price only holds under stated conditions, such as a design the seller already has.",
"additionalProperties": false
},
"sourceCurrency": {
"anyOf": [
{
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "The currency the supplier quoted its price in, before conversion to the response currency; null when no quote exists."
},
"deliveryDaysMax": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The supplier's longest stated delivery time, in days from order to arrival; null when unknown."
},
"deliveryDaysMin": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The supplier's shortest stated delivery time, in days from order to arrival; null when unknown."
},
"buyerImportWarning": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "A charge the buyer may pay on import, in words; null when there is none."
},
"criticalDifferences": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "Ways this product differs from the one asked about; empty for the same product."
},
"differencesUnresolved": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "null"
}
],
"description": "A difference that could not be confirmed; null when everything is known."
}
},
"description": "The offer this supplier's row shows.",
"additionalProperties": false
},
"otherOffers": {
"type": "array",
"items": {
"type": "object",
"required": [
"supplierId",
"supplier",
"provider",
"product",
"price",
"shipping",
"duty",
"priceBasis",
"delivered",
"currency",
"available",
"comparable",
"cheapest",
"mostKept",
"isYourSupplier",
"profit",
"versusYours",
"note",
"criticalDifferences",
"differencesUnresolved",
"pricingPlan",
"deliveryDaysMin",
"deliveryDaysMax",
"checkedAt",
"actionUrl",
"productUrl",
"affiliate",
"facts"
],
"properties": {
"duty": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Supplier-billed duty in the response currency, separate from the delivered total; 0 when the supplier bills none, null when unverified."
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "How this offer's configuration differs from the one asked about, in words; null when there is nothing to add."
},
"facts": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"value"
],
"properties": {
"label": {
"type": "string",
"description": "What the fact is about."
},
"value": {
"type": "string",
"description": "The fact's value."
}
},
"additionalProperties": false
},
"description": "Labelled facts about this offer, such as print method, size range and quantity."
},
"price": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Product cost in the response currency, before shipping; null when unknown, never 0."
},
"profit": {
"anyOf": [
{
"oneOf": [
{
"type": "object",
"required": [
"status",
"dutyStatus",
"qualification",
"sale",
"supplierCost",
"fees",
"feeBreakdown",
"keep",
"margin"
],
"properties": {
"fees": {
"type": "number",
"description": "Platform fees for this sale in the response currency."
},
"keep": {
"type": "number",
"description": "What the seller keeps per sale before tax, in the response currency."
},
"sale": {
"type": "number",
"description": "The selling price in the response currency; with targetMargin, the price to charge."
},
"margin": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Share of the sale the seller keeps, 0 to 1; null when the sale is zero."
},
"status": {
"type": "string",
"const": "calculated",
"description": "Profit could be worked out for this offer."
},
"dutyStatus": {
"enum": [
"known",
"estimated",
"unknown"
],
"type": "string",
"description": "How well the supplier-billed duty is established: known, estimated from bounded quotes, or unknown."
},
"feeBreakdown": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"amount"
],
"properties": {
"label": {
"type": "string",
"description": "The fee's name, such as transaction fee."
},
"amount": {
"type": "number",
"description": "The fee amount in the response currency."
}
},
"additionalProperties": false
},
"description": "Each platform fee and its amount."
},
"supplierCost": {
"type": "number",
"description": "What the supplier charges in the response currency: product, shipping and any known duty."
},
"qualification": {
"type": "string",
"description": "In words, whether supplier-billed duty is included in or left out of this profit."
},
"estimatedDutyDeducted": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "The estimated duty deducted from the sale; null when duty is known or was not deducted."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"reason"
],
"properties": {
"reason": {
"enum": [
"missing_cost",
"fees_unavailable",
"target_not_reachable"
],
"type": "string",
"description": "Why: the supplier cost is unknown, the platform fees are unavailable, or the target margin cannot be reached."
},
"status": {
"type": "string",
"const": "unavailable",
"description": "Profit could not be worked out for this offer."
}
},
"additionalProperties": false
}
]
},
{
"type": "null"
}
],
"description": "This offer's profit when a selling price or target margin was given; null otherwise."
},
"product": {
"type": "string",
"description": "The supplier's own name for the product."
},
"taxNote": {
"type": "string",
"description": "How VAT or sales tax applies to this price, in words."
},
"cheapest": {
"type": "boolean",
"description": "Has the lowest product plus shipping total among comparable offers; false when the comparison cannot rank suppliers."
},
"currency": {
"anyOf": [
{
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "The currency these amounts are in; null when no price is known."
},
"mostKept": {
"type": "boolean",
"description": "Leaves the seller the most per sale; false unless profit is shown and every supplier-billed duty is known."
},
"provider": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The print provider that makes the order, for a marketplace; null for a direct supplier."
},
"shipping": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Shipping cost in the response currency; null when unknown, never 0."
},
"supplier": {
"type": "string",
"description": "The supplier's name."
},
"actionUrl": {
"type": "string",
"format": "uri",
"description": "The main link out to this offer: the supplier's product page, or its sign-up page when the affiliate programme pays only for sign-ups."
},
"affiliate": {
"type": "boolean",
"description": "Whether actionUrl earns a commission; it never changes prices or rankings."
},
"available": {
"type": "boolean",
"description": "The supplier sells this configuration and quotes it for the destination."
},
"checkedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When this price was last checked, as an ISO date-time; null when unknown."
},
"delivered": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Product plus shipping in the response currency; null when the supplier cannot price it, never 0."
},
"comparable": {
"type": "boolean",
"description": "The priced configuration matches the requested choice closely enough to compare."
},
"dutySource": {
"anyOf": [
{
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "number",
"minimum": 0,
"description": "The supplier's own duty amount, in its own currency."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "The currency the supplier states that duty in."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The supplier's own duty charge as it states it; null when none is published."
},
"priceBasis": {
"type": "string",
"const": "product-and-shipping",
"description": "What the delivered total covers: product and shipping."
},
"productUrl": {
"type": "string",
"format": "uri",
"description": "The supplier's page for this product and configuration."
},
"supplierId": {
"type": "string",
"description": "The supplier's id."
},
"dutyOutcome": {
"anyOf": [
{
"enum": [
"charged",
"not_applicable",
"estimated",
"unknown"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "charged when the supplier bills duty, not_applicable when none applies, estimated when only a range is known, unknown when unverified."
},
"pricingPlan": {
"type": "string",
"description": "The supplier plan this price uses, such as Standard pricing."
},
"versusYours": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Per sale against the seller's own supplier: positive means the seller keeps more here. Uses profit when shown, otherwise the delivered total; null when the two cannot be compared."
},
"dutyEstimate": {
"anyOf": [
{
"type": "object",
"required": [
"native",
"converted"
],
"properties": {
"native": {
"type": "object",
"required": [
"min",
"max",
"currency",
"basis"
],
"properties": {
"max": {
"type": "number",
"minimum": 0,
"description": "Highest amount in this duty range, in this currency."
},
"min": {
"type": "number",
"minimum": 0,
"description": "Lowest amount in this duty range, in this currency."
},
"basis": {
"type": "string",
"const": "line_net_x_compatible_product_rate",
"description": "How the estimate was derived: the line's net price times the supplier's per-product duty rate."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "The currency of these duty amounts."
}
},
"description": "The duty estimate in the supplier's own currency.",
"additionalProperties": false
},
"converted": {
"anyOf": [
{
"type": "object",
"required": [
"min",
"max",
"currency"
],
"properties": {
"max": {
"type": "number",
"minimum": 0,
"description": "Highest amount in this duty range, in this currency."
},
"min": {
"type": "number",
"minimum": 0,
"description": "Lowest amount in this duty range, in this currency."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "The currency of these duty amounts."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The same estimate in the response currency; null when it could not be converted."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The bounded duty estimate when only a range is known; absent otherwise."
},
"pricingBasis": {
"type": "string",
"description": "The selected price basis and any setup disclosure, in words."
},
"isYourSupplier": {
"type": "boolean",
"description": "The supplier the seller said they use today."
},
"pricingContext": {
"type": "object",
"required": [
"basis",
"policyId",
"policyVersion",
"source",
"recurringConditions",
"newDesignSetup",
"physicalSelections"
],
"properties": {
"basis": {
"enum": [
"existing-supplier-digitised-design",
"digitisation-included"
],
"type": "string",
"description": "What the price assumes: an existing design the seller already has, or included digitisation."
},
"source": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What the supplier states about this price, in its own words."
},
"policyId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Which pricing policy this context follows."
},
"policyVersion": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The version of that pricing policy."
},
"newDesignSetup": {
"oneOf": [
{
"type": "object",
"required": [
"status",
"fees",
"applicability",
"application",
"includedInDeliveredTotal"
],
"properties": {
"fees": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"amount",
"currency",
"taxBasis",
"scope",
"source",
"conditions"
],
"properties": {
"kind": {
"enum": [
"standard",
"text-only",
"image",
"adjustment",
"back-or-side",
"setup"
],
"type": "string",
"description": "What the fee is for: standard, text-only, image, adjustment, back-or-side or setup."
},
"scope": {
"enum": [
"per-design",
"per-design-and-area",
"per-order",
"per-unit",
"unknown"
],
"type": "string",
"description": "What the fee applies to: per design, per design and area, per order, per unit or unknown."
},
"amount": {
"type": "number",
"minimum": 0,
"description": "The fee amount in its own currency."
},
"source": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What the supplier states about this fee."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "Original supplier currency; never converted along with the unit price."
},
"taxBasis": {
"enum": [
"ex-vat",
"unknown"
],
"type": "string",
"description": "Whether the fee is quoted before VAT (ex-vat) or unclear."
},
"conditions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600,
"minLength": 1
},
"maxItems": 12,
"description": "What must hold for this fee to apply."
}
},
"additionalProperties": false
},
"maxItems": 8,
"minItems": 1,
"description": "The setup fees the supplier lists."
},
"status": {
"type": "string",
"const": "listed",
"description": "The supplier lists a setup charge."
},
"application": {
"type": "string",
"const": "not-modelled",
"description": "Always not-modelled: the charge is disclosed but never added to a total."
},
"applicability": {
"enum": [
"design-dependent",
"selected"
],
"type": "string",
"description": "design-dependent when the fee depends on the artwork, selected when one fee applies to this order."
},
"includedInDeliveredTotal": {
"type": "boolean",
"const": false,
"description": "Always false: setup charges stay outside the delivered total."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"source",
"conditions"
],
"properties": {
"source": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What the supplier states about the inclusion."
},
"status": {
"type": "string",
"const": "included",
"description": "Digitisation is included, so there is no setup charge."
},
"conditions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600,
"minLength": 1
},
"maxItems": 12,
"description": "What must hold for the inclusion."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"reason"
],
"properties": {
"reason": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "Why the setup charge is unknown."
},
"source": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What the supplier states, when it says anything."
},
"status": {
"type": "string",
"const": "unknown",
"description": "Whether a setup charge applies could not be established."
}
},
"additionalProperties": false
}
],
"description": "How a new design's setup is charged, or that it is included."
},
"physicalSelections": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"axisId",
"valueId",
"axisLabel",
"valueLabel"
],
"properties": {
"kind": {
"enum": [
"sku-option",
"standard-configuration"
],
"type": "string",
"description": "sku-option changes the unit price; standard-configuration is a fixed default."
},
"axisId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The option field's id, such as size."
},
"valueId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The chosen value's id."
},
"axisLabel": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The option field as shown, such as Size."
},
"valueLabel": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The chosen value as shown, such as Adult M."
}
},
"additionalProperties": false
},
"maxItems": 8,
"description": "The supplier options this price was quoted for."
},
"recurringConditions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600,
"minLength": 1
},
"maxItems": 12,
"description": "What must remain true for this recurring unit price."
}
},
"description": "Present when this price only holds under stated conditions, such as a design the seller already has.",
"additionalProperties": false
},
"sourceCurrency": {
"anyOf": [
{
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "The currency the supplier quoted its price in, before conversion to the response currency; null when no quote exists."
},
"deliveryDaysMax": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The supplier's longest stated delivery time, in days from order to arrival; null when unknown."
},
"deliveryDaysMin": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The supplier's shortest stated delivery time, in days from order to arrival; null when unknown."
},
"buyerImportWarning": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "A charge the buyer may pay on import, in words; null when there is none."
},
"criticalDifferences": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "Ways this product differs from the one asked about; empty for the same product."
},
"differencesUnresolved": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "null"
}
],
"description": "A difference that could not be confirmed; null when everything is known."
}
},
"additionalProperties": false
},
"maxItems": 50,
"description": "This supplier's other products and print providers for the choice."
},
"otherOfferCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many other offers this supplier has, including any beyond otherOffers."
}
},
"additionalProperties": false
},
"description": "One entry per supplier, the seller's own pinned first when given, then most profit first when profit is shown."
},
"destination": {
"enum": [
"US",
"GB",
"DE",
"AU",
"CA"
],
"type": "string",
"description": "The buyer's country these prices are for."
},
"optionCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many configurations the product supports in total, before the 100 listed in options."
},
"optionLabel": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "That configuration in words, such as `Adult M / Black`; null when the product has none."
},
"pricingTier": {
"enum": [
"base",
"tier1",
"tier2"
],
"type": "string",
"description": "The supplier plan the prices come from: base is standard, tier1 and tier2 are paid plans."
},
"alternatives": {
"type": "array",
"items": {
"type": "object",
"required": [
"offer",
"otherOffers",
"otherOfferCount"
],
"properties": {
"offer": {
"type": "object",
"required": [
"supplierId",
"supplier",
"provider",
"product",
"price",
"shipping",
"duty",
"priceBasis",
"delivered",
"currency",
"available",
"comparable",
"cheapest",
"mostKept",
"isYourSupplier",
"profit",
"versusYours",
"note",
"criticalDifferences",
"differencesUnresolved",
"pricingPlan",
"deliveryDaysMin",
"deliveryDaysMax",
"checkedAt",
"actionUrl",
"productUrl",
"affiliate",
"facts"
],
"properties": {
"duty": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Supplier-billed duty in the response currency, separate from the delivered total; 0 when the supplier bills none, null when unverified."
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "How this offer's configuration differs from the one asked about, in words; null when there is nothing to add."
},
"facts": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"value"
],
"properties": {
"label": {
"type": "string",
"description": "What the fact is about."
},
"value": {
"type": "string",
"description": "The fact's value."
}
},
"additionalProperties": false
},
"description": "Labelled facts about this offer, such as print method, size range and quantity."
},
"price": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Product cost in the response currency, before shipping; null when unknown, never 0."
},
"profit": {
"anyOf": [
{
"oneOf": [
{
"type": "object",
"required": [
"status",
"dutyStatus",
"qualification",
"sale",
"supplierCost",
"fees",
"feeBreakdown",
"keep",
"margin"
],
"properties": {
"fees": {
"type": "number",
"description": "Platform fees for this sale in the response currency."
},
"keep": {
"type": "number",
"description": "What the seller keeps per sale before tax, in the response currency."
},
"sale": {
"type": "number",
"description": "The selling price in the response currency; with targetMargin, the price to charge."
},
"margin": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Share of the sale the seller keeps, 0 to 1; null when the sale is zero."
},
"status": {
"type": "string",
"const": "calculated",
"description": "Profit could be worked out for this offer."
},
"dutyStatus": {
"enum": [
"known",
"estimated",
"unknown"
],
"type": "string",
"description": "How well the supplier-billed duty is established: known, estimated from bounded quotes, or unknown."
},
"feeBreakdown": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"amount"
],
"properties": {
"label": {
"type": "string",
"description": "The fee's name, such as transaction fee."
},
"amount": {
"type": "number",
"description": "The fee amount in the response currency."
}
},
"additionalProperties": false
},
"description": "Each platform fee and its amount."
},
"supplierCost": {
"type": "number",
"description": "What the supplier charges in the response currency: product, shipping and any known duty."
},
"qualification": {
"type": "string",
"description": "In words, whether supplier-billed duty is included in or left out of this profit."
},
"estimatedDutyDeducted": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "The estimated duty deducted from the sale; null when duty is known or was not deducted."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"reason"
],
"properties": {
"reason": {
"enum": [
"missing_cost",
"fees_unavailable",
"target_not_reachable"
],
"type": "string",
"description": "Why: the supplier cost is unknown, the platform fees are unavailable, or the target margin cannot be reached."
},
"status": {
"type": "string",
"const": "unavailable",
"description": "Profit could not be worked out for this offer."
}
},
"additionalProperties": false
}
]
},
{
"type": "null"
}
],
"description": "This offer's profit when a selling price or target margin was given; null otherwise."
},
"product": {
"type": "string",
"description": "The supplier's own name for the product."
},
"taxNote": {
"type": "string",
"description": "How VAT or sales tax applies to this price, in words."
},
"cheapest": {
"type": "boolean",
"description": "Has the lowest product plus shipping total among comparable offers; false when the comparison cannot rank suppliers."
},
"currency": {
"anyOf": [
{
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "The currency these amounts are in; null when no price is known."
},
"mostKept": {
"type": "boolean",
"description": "Leaves the seller the most per sale; false unless profit is shown and every supplier-billed duty is known."
},
"provider": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The print provider that makes the order, for a marketplace; null for a direct supplier."
},
"shipping": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Shipping cost in the response currency; null when unknown, never 0."
},
"supplier": {
"type": "string",
"description": "The supplier's name."
},
"actionUrl": {
"type": "string",
"format": "uri",
"description": "The main link out to this offer: the supplier's product page, or its sign-up page when the affiliate programme pays only for sign-ups."
},
"affiliate": {
"type": "boolean",
"description": "Whether actionUrl earns a commission; it never changes prices or rankings."
},
"available": {
"type": "boolean",
"description": "The supplier sells this configuration and quotes it for the destination."
},
"checkedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When this price was last checked, as an ISO date-time; null when unknown."
},
"delivered": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Product plus shipping in the response currency; null when the supplier cannot price it, never 0."
},
"comparable": {
"type": "boolean",
"description": "The priced configuration matches the requested choice closely enough to compare."
},
"dutySource": {
"anyOf": [
{
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "number",
"minimum": 0,
"description": "The supplier's own duty amount, in its own currency."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "The currency the supplier states that duty in."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The supplier's own duty charge as it states it; null when none is published."
},
"priceBasis": {
"type": "string",
"const": "product-and-shipping",
"description": "What the delivered total covers: product and shipping."
},
"productUrl": {
"type": "string",
"format": "uri",
"description": "The supplier's page for this product and configuration."
},
"supplierId": {
"type": "string",
"description": "The supplier's id."
},
"dutyOutcome": {
"anyOf": [
{
"enum": [
"charged",
"not_applicable",
"estimated",
"unknown"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "charged when the supplier bills duty, not_applicable when none applies, estimated when only a range is known, unknown when unverified."
},
"pricingPlan": {
"type": "string",
"description": "The supplier plan this price uses, such as Standard pricing."
},
"versusYours": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Per sale against the seller's own supplier: positive means the seller keeps more here. Uses profit when shown, otherwise the delivered total; null when the two cannot be compared."
},
"dutyEstimate": {
"anyOf": [
{
"type": "object",
"required": [
"native",
"converted"
],
"properties": {
"native": {
"type": "object",
"required": [
"min",
"max",
"currency",
"basis"
],
"properties": {
"max": {
"type": "number",
"minimum": 0,
"description": "Highest amount in this duty range, in this currency."
},
"min": {
"type": "number",
"minimum": 0,
"description": "Lowest amount in this duty range, in this currency."
},
"basis": {
"type": "string",
"const": "line_net_x_compatible_product_rate",
"description": "How the estimate was derived: the line's net price times the supplier's per-product duty rate."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "The currency of these duty amounts."
}
},
"description": "The duty estimate in the supplier's own currency.",
"additionalProperties": false
},
"converted": {
"anyOf": [
{
"type": "object",
"required": [
"min",
"max",
"currency"
],
"properties": {
"max": {
"type": "number",
"minimum": 0,
"description": "Highest amount in this duty range, in this currency."
},
"min": {
"type": "number",
"minimum": 0,
"description": "Lowest amount in this duty range, in this currency."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "The currency of these duty amounts."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The same estimate in the response currency; null when it could not be converted."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The bounded duty estimate when only a range is known; absent otherwise."
},
"pricingBasis": {
"type": "string",
"description": "The selected price basis and any setup disclosure, in words."
},
"isYourSupplier": {
"type": "boolean",
"description": "The supplier the seller said they use today."
},
"pricingContext": {
"type": "object",
"required": [
"basis",
"policyId",
"policyVersion",
"source",
"recurringConditions",
"newDesignSetup",
"physicalSelections"
],
"properties": {
"basis": {
"enum": [
"existing-supplier-digitised-design",
"digitisation-included"
],
"type": "string",
"description": "What the price assumes: an existing design the seller already has, or included digitisation."
},
"source": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What the supplier states about this price, in its own words."
},
"policyId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Which pricing policy this context follows."
},
"policyVersion": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The version of that pricing policy."
},
"newDesignSetup": {
"oneOf": [
{
"type": "object",
"required": [
"status",
"fees",
"applicability",
"application",
"includedInDeliveredTotal"
],
"properties": {
"fees": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"amount",
"currency",
"taxBasis",
"scope",
"source",
"conditions"
],
"properties": {
"kind": {
"enum": [
"standard",
"text-only",
"image",
"adjustment",
"back-or-side",
"setup"
],
"type": "string",
"description": "What the fee is for: standard, text-only, image, adjustment, back-or-side or setup."
},
"scope": {
"enum": [
"per-design",
"per-design-and-area",
"per-order",
"per-unit",
"unknown"
],
"type": "string",
"description": "What the fee applies to: per design, per design and area, per order, per unit or unknown."
},
"amount": {
"type": "number",
"minimum": 0,
"description": "The fee amount in its own currency."
},
"source": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What the supplier states about this fee."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "Original supplier currency; never converted along with the unit price."
},
"taxBasis": {
"enum": [
"ex-vat",
"unknown"
],
"type": "string",
"description": "Whether the fee is quoted before VAT (ex-vat) or unclear."
},
"conditions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600,
"minLength": 1
},
"maxItems": 12,
"description": "What must hold for this fee to apply."
}
},
"additionalProperties": false
},
"maxItems": 8,
"minItems": 1,
"description": "The setup fees the supplier lists."
},
"status": {
"type": "string",
"const": "listed",
"description": "The supplier lists a setup charge."
},
"application": {
"type": "string",
"const": "not-modelled",
"description": "Always not-modelled: the charge is disclosed but never added to a total."
},
"applicability": {
"enum": [
"design-dependent",
"selected"
],
"type": "string",
"description": "design-dependent when the fee depends on the artwork, selected when one fee applies to this order."
},
"includedInDeliveredTotal": {
"type": "boolean",
"const": false,
"description": "Always false: setup charges stay outside the delivered total."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"source",
"conditions"
],
"properties": {
"source": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What the supplier states about the inclusion."
},
"status": {
"type": "string",
"const": "included",
"description": "Digitisation is included, so there is no setup charge."
},
"conditions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600,
"minLength": 1
},
"maxItems": 12,
"description": "What must hold for the inclusion."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"reason"
],
"properties": {
"reason": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "Why the setup charge is unknown."
},
"source": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What the supplier states, when it says anything."
},
"status": {
"type": "string",
"const": "unknown",
"description": "Whether a setup charge applies could not be established."
}
},
"additionalProperties": false
}
],
"description": "How a new design's setup is charged, or that it is included."
},
"physicalSelections": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"axisId",
"valueId",
"axisLabel",
"valueLabel"
],
"properties": {
"kind": {
"enum": [
"sku-option",
"standard-configuration"
],
"type": "string",
"description": "sku-option changes the unit price; standard-configuration is a fixed default."
},
"axisId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The option field's id, such as size."
},
"valueId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The chosen value's id."
},
"axisLabel": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The option field as shown, such as Size."
},
"valueLabel": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The chosen value as shown, such as Adult M."
}
},
"additionalProperties": false
},
"maxItems": 8,
"description": "The supplier options this price was quoted for."
},
"recurringConditions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600,
"minLength": 1
},
"maxItems": 12,
"description": "What must remain true for this recurring unit price."
}
},
"description": "Present when this price only holds under stated conditions, such as a design the seller already has.",
"additionalProperties": false
},
"sourceCurrency": {
"anyOf": [
{
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "The currency the supplier quoted its price in, before conversion to the response currency; null when no quote exists."
},
"deliveryDaysMax": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The supplier's longest stated delivery time, in days from order to arrival; null when unknown."
},
"deliveryDaysMin": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The supplier's shortest stated delivery time, in days from order to arrival; null when unknown."
},
"buyerImportWarning": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "A charge the buyer may pay on import, in words; null when there is none."
},
"criticalDifferences": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "Ways this product differs from the one asked about; empty for the same product."
},
"differencesUnresolved": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "null"
}
],
"description": "A difference that could not be confirmed; null when everything is known."
}
},
"description": "The offer this supplier's row shows.",
"additionalProperties": false
},
"otherOffers": {
"type": "array",
"items": {
"type": "object",
"required": [
"supplierId",
"supplier",
"provider",
"product",
"price",
"shipping",
"duty",
"priceBasis",
"delivered",
"currency",
"available",
"comparable",
"cheapest",
"mostKept",
"isYourSupplier",
"profit",
"versusYours",
"note",
"criticalDifferences",
"differencesUnresolved",
"pricingPlan",
"deliveryDaysMin",
"deliveryDaysMax",
"checkedAt",
"actionUrl",
"productUrl",
"affiliate",
"facts"
],
"properties": {
"duty": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Supplier-billed duty in the response currency, separate from the delivered total; 0 when the supplier bills none, null when unverified."
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "How this offer's configuration differs from the one asked about, in words; null when there is nothing to add."
},
"facts": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"value"
],
"properties": {
"label": {
"type": "string",
"description": "What the fact is about."
},
"value": {
"type": "string",
"description": "The fact's value."
}
},
"additionalProperties": false
},
"description": "Labelled facts about this offer, such as print method, size range and quantity."
},
"price": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Product cost in the response currency, before shipping; null when unknown, never 0."
},
"profit": {
"anyOf": [
{
"oneOf": [
{
"type": "object",
"required": [
"status",
"dutyStatus",
"qualification",
"sale",
"supplierCost",
"fees",
"feeBreakdown",
"keep",
"margin"
],
"properties": {
"fees": {
"type": "number",
"description": "Platform fees for this sale in the response currency."
},
"keep": {
"type": "number",
"description": "What the seller keeps per sale before tax, in the response currency."
},
"sale": {
"type": "number",
"description": "The selling price in the response currency; with targetMargin, the price to charge."
},
"margin": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Share of the sale the seller keeps, 0 to 1; null when the sale is zero."
},
"status": {
"type": "string",
"const": "calculated",
"description": "Profit could be worked out for this offer."
},
"dutyStatus": {
"enum": [
"known",
"estimated",
"unknown"
],
"type": "string",
"description": "How well the supplier-billed duty is established: known, estimated from bounded quotes, or unknown."
},
"feeBreakdown": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"amount"
],
"properties": {
"label": {
"type": "string",
"description": "The fee's name, such as transaction fee."
},
"amount": {
"type": "number",
"description": "The fee amount in the response currency."
}
},
"additionalProperties": false
},
"description": "Each platform fee and its amount."
},
"supplierCost": {
"type": "number",
"description": "What the supplier charges in the response currency: product, shipping and any known duty."
},
"qualification": {
"type": "string",
"description": "In words, whether supplier-billed duty is included in or left out of this profit."
},
"estimatedDutyDeducted": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "The estimated duty deducted from the sale; null when duty is known or was not deducted."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"reason"
],
"properties": {
"reason": {
"enum": [
"missing_cost",
"fees_unavailable",
"target_not_reachable"
],
"type": "string",
"description": "Why: the supplier cost is unknown, the platform fees are unavailable, or the target margin cannot be reached."
},
"status": {
"type": "string",
"const": "unavailable",
"description": "Profit could not be worked out for this offer."
}
},
"additionalProperties": false
}
]
},
{
"type": "null"
}
],
"description": "This offer's profit when a selling price or target margin was given; null otherwise."
},
"product": {
"type": "string",
"description": "The supplier's own name for the product."
},
"taxNote": {
"type": "string",
"description": "How VAT or sales tax applies to this price, in words."
},
"cheapest": {
"type": "boolean",
"description": "Has the lowest product plus shipping total among comparable offers; false when the comparison cannot rank suppliers."
},
"currency": {
"anyOf": [
{
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "The currency these amounts are in; null when no price is known."
},
"mostKept": {
"type": "boolean",
"description": "Leaves the seller the most per sale; false unless profit is shown and every supplier-billed duty is known."
},
"provider": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The print provider that makes the order, for a marketplace; null for a direct supplier."
},
"shipping": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Shipping cost in the response currency; null when unknown, never 0."
},
"supplier": {
"type": "string",
"description": "The supplier's name."
},
"actionUrl": {
"type": "string",
"format": "uri",
"description": "The main link out to this offer: the supplier's product page, or its sign-up page when the affiliate programme pays only for sign-ups."
},
"affiliate": {
"type": "boolean",
"description": "Whether actionUrl earns a commission; it never changes prices or rankings."
},
"available": {
"type": "boolean",
"description": "The supplier sells this configuration and quotes it for the destination."
},
"checkedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When this price was last checked, as an ISO date-time; null when unknown."
},
"delivered": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Product plus shipping in the response currency; null when the supplier cannot price it, never 0."
},
"comparable": {
"type": "boolean",
"description": "The priced configuration matches the requested choice closely enough to compare."
},
"dutySource": {
"anyOf": [
{
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "number",
"minimum": 0,
"description": "The supplier's own duty amount, in its own currency."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "The currency the supplier states that duty in."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The supplier's own duty charge as it states it; null when none is published."
},
"priceBasis": {
"type": "string",
"const": "product-and-shipping",
"description": "What the delivered total covers: product and shipping."
},
"productUrl": {
"type": "string",
"format": "uri",
"description": "The supplier's page for this product and configuration."
},
"supplierId": {
"type": "string",
"description": "The supplier's id."
},
"dutyOutcome": {
"anyOf": [
{
"enum": [
"charged",
"not_applicable",
"estimated",
"unknown"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "charged when the supplier bills duty, not_applicable when none applies, estimated when only a range is known, unknown when unverified."
},
"pricingPlan": {
"type": "string",
"description": "The supplier plan this price uses, such as Standard pricing."
},
"versusYours": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Per sale against the seller's own supplier: positive means the seller keeps more here. Uses profit when shown, otherwise the delivered total; null when the two cannot be compared."
},
"dutyEstimate": {
"anyOf": [
{
"type": "object",
"required": [
"native",
"converted"
],
"properties": {
"native": {
"type": "object",
"required": [
"min",
"max",
"currency",
"basis"
],
"properties": {
"max": {
"type": "number",
"minimum": 0,
"description": "Highest amount in this duty range, in this currency."
},
"min": {
"type": "number",
"minimum": 0,
"description": "Lowest amount in this duty range, in this currency."
},
"basis": {
"type": "string",
"const": "line_net_x_compatible_product_rate",
"description": "How the estimate was derived: the line's net price times the supplier's per-product duty rate."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "The currency of these duty amounts."
}
},
"description": "The duty estimate in the supplier's own currency.",
"additionalProperties": false
},
"converted": {
"anyOf": [
{
"type": "object",
"required": [
"min",
"max",
"currency"
],
"properties": {
"max": {
"type": "number",
"minimum": 0,
"description": "Highest amount in this duty range, in this currency."
},
"min": {
"type": "number",
"minimum": 0,
"description": "Lowest amount in this duty range, in this currency."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "The currency of these duty amounts."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The same estimate in the response currency; null when it could not be converted."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The bounded duty estimate when only a range is known; absent otherwise."
},
"pricingBasis": {
"type": "string",
"description": "The selected price basis and any setup disclosure, in words."
},
"isYourSupplier": {
"type": "boolean",
"description": "The supplier the seller said they use today."
},
"pricingContext": {
"type": "object",
"required": [
"basis",
"policyId",
"policyVersion",
"source",
"recurringConditions",
"newDesignSetup",
"physicalSelections"
],
"properties": {
"basis": {
"enum": [
"existing-supplier-digitised-design",
"digitisation-included"
],
"type": "string",
"description": "What the price assumes: an existing design the seller already has, or included digitisation."
},
"source": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What the supplier states about this price, in its own words."
},
"policyId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Which pricing policy this context follows."
},
"policyVersion": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The version of that pricing policy."
},
"newDesignSetup": {
"oneOf": [
{
"type": "object",
"required": [
"status",
"fees",
"applicability",
"application",
"includedInDeliveredTotal"
],
"properties": {
"fees": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"amount",
"currency",
"taxBasis",
"scope",
"source",
"conditions"
],
"properties": {
"kind": {
"enum": [
"standard",
"text-only",
"image",
"adjustment",
"back-or-side",
"setup"
],
"type": "string",
"description": "What the fee is for: standard, text-only, image, adjustment, back-or-side or setup."
},
"scope": {
"enum": [
"per-design",
"per-design-and-area",
"per-order",
"per-unit",
"unknown"
],
"type": "string",
"description": "What the fee applies to: per design, per design and area, per order, per unit or unknown."
},
"amount": {
"type": "number",
"minimum": 0,
"description": "The fee amount in its own currency."
},
"source": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What the supplier states about this fee."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "Original supplier currency; never converted along with the unit price."
},
"taxBasis": {
"enum": [
"ex-vat",
"unknown"
],
"type": "string",
"description": "Whether the fee is quoted before VAT (ex-vat) or unclear."
},
"conditions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600,
"minLength": 1
},
"maxItems": 12,
"description": "What must hold for this fee to apply."
}
},
"additionalProperties": false
},
"maxItems": 8,
"minItems": 1,
"description": "The setup fees the supplier lists."
},
"status": {
"type": "string",
"const": "listed",
"description": "The supplier lists a setup charge."
},
"application": {
"type": "string",
"const": "not-modelled",
"description": "Always not-modelled: the charge is disclosed but never added to a total."
},
"applicability": {
"enum": [
"design-dependent",
"selected"
],
"type": "string",
"description": "design-dependent when the fee depends on the artwork, selected when one fee applies to this order."
},
"includedInDeliveredTotal": {
"type": "boolean",
"const": false,
"description": "Always false: setup charges stay outside the delivered total."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"source",
"conditions"
],
"properties": {
"source": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What the supplier states about the inclusion."
},
"status": {
"type": "string",
"const": "included",
"description": "Digitisation is included, so there is no setup charge."
},
"conditions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600,
"minLength": 1
},
"maxItems": 12,
"description": "What must hold for the inclusion."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"reason"
],
"properties": {
"reason": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "Why the setup charge is unknown."
},
"source": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What the supplier states, when it says anything."
},
"status": {
"type": "string",
"const": "unknown",
"description": "Whether a setup charge applies could not be established."
}
},
"additionalProperties": false
}
],
"description": "How a new design's setup is charged, or that it is included."
},
"physicalSelections": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"axisId",
"valueId",
"axisLabel",
"valueLabel"
],
"properties": {
"kind": {
"enum": [
"sku-option",
"standard-configuration"
],
"type": "string",
"description": "sku-option changes the unit price; standard-configuration is a fixed default."
},
"axisId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The option field's id, such as size."
},
"valueId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The chosen value's id."
},
"axisLabel": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The option field as shown, such as Size."
},
"valueLabel": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The chosen value as shown, such as Adult M."
}
},
"additionalProperties": false
},
"maxItems": 8,
"description": "The supplier options this price was quoted for."
},
"recurringConditions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600,
"minLength": 1
},
"maxItems": 12,
"description": "What must remain true for this recurring unit price."
}
},
"description": "Present when this price only holds under stated conditions, such as a design the seller already has.",
"additionalProperties": false
},
"sourceCurrency": {
"anyOf": [
{
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "The currency the supplier quoted its price in, before conversion to the response currency; null when no quote exists."
},
"deliveryDaysMax": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The supplier's longest stated delivery time, in days from order to arrival; null when unknown."
},
"deliveryDaysMin": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The supplier's shortest stated delivery time, in days from order to arrival; null when unknown."
},
"buyerImportWarning": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "A charge the buyer may pay on import, in words; null when there is none."
},
"criticalDifferences": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "Ways this product differs from the one asked about; empty for the same product."
},
"differencesUnresolved": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "null"
}
],
"description": "A difference that could not be confirmed; null when everything is known."
}
},
"additionalProperties": false
},
"maxItems": 50,
"description": "This supplier's other products and print providers for the choice."
},
"otherOfferCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many other offers this supplier has, including any beyond otherOffers."
}
},
"additionalProperties": false
},
"description": "Similar products compared alongside, kept separate from the same product's suppliers."
},
"priceContext": {
"type": "string",
"description": "What the prices cover and which option they reflect, in words."
},
"yourSupplier": {
"anyOf": [
{
"type": "object",
"required": [
"id",
"name",
"sellsProduct"
],
"properties": {
"id": {
"type": "string",
"description": "The supplier's id."
},
"name": {
"type": "string",
"description": "The supplier's name."
},
"sellsProduct": {
"type": "boolean",
"description": "False when the supplier does not sell this product in this configuration."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The supplier the seller said they use; null when they did not say."
},
"optionChoices": {
"type": "object",
"description": "The selected option by field, such as { size: \"Adult M\", color: \"Black\" }.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"affiliateDisclosure": {
"type": "string",
"description": "The commission disclosure that applies to affiliate links."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"ok",
"error"
],
"properties": {
"ok": {
"type": "boolean",
"const": false
},
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"enum": [
"invalid_input",
"not_found",
"product_not_found",
"invalid_option",
"comparison_unavailable",
"unavailable",
"rate_limited"
],
"type": "string",
"description": "The machine-readable reason the call failed."
},
"message": {
"type": "string",
"description": "What went wrong, in words, and what to do next."
},
"retryable": {
"type": "boolean",
"description": "Whether calling again could succeed."
}
},
"description": "The error this call returned instead of a result.",
"additionalProperties": false
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
Original tool metadata
{
"name": "compare_product",
"title": "Compare print-on-demand suppliers",
"description": "Use this when a seller asks which print-on-demand (POD) supplier costs less for a product, wants a Printify vs Printful comparison, or needs product prices, shipping, delivered totals or delivery times. Compares Printify, Printful, Gelato, Prodigi, Apliiq, Artelo, CustomCat, Fourthwall, Inkthreadable and merchOne for one product and configuration, destination and currency. Search products first; for a specific size or color pass choices or an optionKey from get_product_options, otherwise it uses the product's usual configuration and returns its label. Totals and rankings are product + shipping; unknown costs stay null; similar products stay separate; affiliate links never change rankings. pricingTier base is standard pricing; use paid plans only when asked. supplier lists one supplier's every product and print provider for the choice. Seller context, only when the seller already said it: yourSupplier pins their current supplier first with the difference per sale; sellingPrice or targetMargin with salesChannel and shopLocation applies approved platform fees. When the seller mentions any of these, call again with them instead of estimating profit yourself; if salesChannel or shopLocation is missing, the result lists what to ask. Profit is an estimate before tax. Supplier-billed duty is separate: established, zero, a bounded estimate or unverified. Profit deducts established duty or a converted estimate; unverified duty or an unconverted native estimate leaves profit before that charge. Show one estimated duty amount (the converted upper endpoint, or the native one marked not converted), never a min–max range. Estimated or unverified duty and conditional design/setup prices never support a winner, gap or best-profit claim. VAT, sales tax and customer-paid import charges are excluded or marked unknown. Supported destinations: US, GB, DE, AU, CA. Not for ordering, store integrations, print-quality rankings or other destinations.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"canonicalProductId",
"destination",
"currency"
],
"properties": {
"choices": {
"type": "object",
"description": "Choices by field, such as { \"size\": \"m\", \"color\": \"black\" }. Values match a value key, its last part or its label, case-insensitively; get_product_options lists them.",
"propertyNames": {
"type": "string",
"maxLength": 60,
"minLength": 1
},
"additionalProperties": {
"type": "string",
"maxLength": 120,
"minLength": 1
}
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "Currency for every price, such as USD, GBP or EUR."
},
"supplier": {
"enum": [
"apliiq",
"artelo",
"merchone",
"customcat",
"fourthwall",
"gelato",
"inkthreadable",
"printful",
"printify",
"prodigi"
],
"type": "string",
"description": "Show only this supplier, with every product and print provider it offers for the choice."
},
"optionKey": {
"type": "string",
"maxLength": 2048,
"minLength": 1,
"description": "An exact key from get_product_options."
},
"destination": {
"enum": [
"US",
"GB",
"DE",
"AU",
"CA"
],
"type": "string",
"description": "The buyer's country, where the order ships. Product cost, shipping and duty depend on it."
},
"pricingTier": {
"enum": [
"base",
"tier1",
"tier2"
],
"type": "string",
"default": "base",
"description": "base is each supplier's standard price; tier1 and tier2 are its paid plans."
},
"salesChannel": {
"enum": [
"etsy",
"shopify",
"woocommerce",
"tiktok-shop"
],
"type": "string",
"description": "The platform the seller sells on. Needed with sellingPrice or targetMargin for platform fees."
},
"sellingPrice": {
"type": "number",
"maximum": 100000,
"description": "What the seller's customer pays for one selected configuration or pack, in the chosen currency, including any shipping the seller charges. Only when the seller said so.",
"exclusiveMinimum": 0
},
"shopLocation": {
"enum": [
"US",
"GB",
"DE",
"AU",
"CA"
],
"type": "string",
"description": "The country the seller's shop is based in, which can differ from the destination the order ships to. Needed with sellingPrice or targetMargin for platform fees."
},
"targetMargin": {
"type": "number",
"description": "The share of the sale, in percent, the seller wants to keep after supplier cost and platform fees. Returns the price to charge with each supplier. Use instead of sellingPrice.",
"exclusiveMaximum": 95,
"exclusiveMinimum": 0
},
"yourSupplier": {
"enum": [
"apliiq",
"artelo",
"merchone",
"customcat",
"fourthwall",
"gelato",
"inkthreadable",
"printful",
"printify",
"prodigi"
],
"type": "string",
"description": "The supplier the seller uses today. Only when the seller said so; never guess."
},
"canonicalProductId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]*$",
"description": "A product id from search_products or resolve_supplier_link, such as `cotton-ringer-tee`."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"oneOf": [
{
"type": "object",
"required": [
"ok",
"product",
"destination",
"currency",
"pricingTier",
"optionKey",
"optionLabel",
"optionChoices",
"profit",
"yourSupplier",
"supplier",
"options",
"optionCount",
"suppliers",
"alternatives",
"priceContext",
"servedAt",
"affiliateDisclosure"
],
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"profit": {
"oneOf": [
{
"type": "object",
"required": [
"status"
],
"properties": {
"status": {
"type": "string",
"const": "off",
"description": "No selling price or target margin was given, so profit is not calculated."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"missing",
"message"
],
"properties": {
"status": {
"type": "string",
"const": "needs_input",
"description": "Profit needs the sales channel or the shop country before it can be calculated."
},
"message": {
"type": "string",
"description": "What to ask the seller, in words."
},
"missing": {
"type": "array",
"items": {
"enum": [
"salesChannel",
"shopLocation"
],
"type": "string"
},
"minItems": 1,
"description": "What to ask the seller for."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"message"
],
"properties": {
"status": {
"type": "string",
"const": "unavailable",
"description": "Profit cannot be calculated for this comparison."
},
"message": {
"type": "string",
"description": "Why profit is unavailable, in words."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"mode",
"sellingPrice",
"targetMargin",
"salesChannel",
"salesChannelLabel",
"shopLocation",
"fallbackFromLabel",
"feesCheckedAt"
],
"properties": {
"mode": {
"enum": [
"selling-price",
"target-margin"
],
"type": "string",
"description": "selling-price uses the price the seller gave; target-margin returns the price to charge."
},
"status": {
"type": "string",
"const": "ready",
"description": "Profit is calculated for every offer whose supplier cost is complete."
},
"salesChannel": {
"enum": [
"etsy",
"shopify",
"woocommerce",
"tiktok-shop"
],
"type": "string",
"description": "The sales channel whose platform fees apply."
},
"sellingPrice": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The selling price given, in the response currency; null with targetMargin."
},
"shopLocation": {
"enum": [
"US",
"GB",
"DE",
"AU",
"CA"
],
"type": "string",
"description": "The country the seller's shop is based in, which sets the fees."
},
"targetMargin": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The target margin in percent; null with sellingPrice."
},
"feesCheckedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The date of the fee research in use, as `YYYY-MM-DD`; null when unknown."
},
"fallbackFromLabel": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Set when the requested channel has no fees for the shop, so another was used."
},
"salesChannelLabel": {
"type": "string",
"description": "That sales channel as a person would say it."
}
},
"additionalProperties": false
}
],
"description": "Whether profit is shown, and the selling price or target margin it uses."
},
"options": {
"type": "array",
"items": {
"type": "object",
"required": [
"key",
"label"
],
"properties": {
"key": {
"type": "string",
"description": "The configuration's key, to pass as optionKey."
},
"label": {
"type": "string",
"description": "The configuration in words, such as `Adult M / Black`."
}
},
"additionalProperties": false
},
"maxItems": 100,
"description": "Up to 100 configurations the product supports, to pass as optionKey."
},
"product": {
"type": "object",
"required": [
"id",
"name",
"subtitle",
"category",
"url"
],
"properties": {
"id": {
"type": "string",
"description": "The product's id."
},
"url": {
"type": "string",
"format": "uri",
"description": "The product's comparison page with these choices applied."
},
"name": {
"type": "string",
"description": "The product's name."
},
"category": {
"type": "string",
"description": "The category slug from the product's path, such as `t-shirts`."
},
"subtitle": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "A short qualifier under the name; null when there is none."
}
},
"description": "The product that was compared.",
"additionalProperties": false
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "Currency for every price, such as USD, GBP or EUR."
},
"servedAt": {
"type": "string",
"description": "When this comparison's data was read, as an ISO date-time."
},
"supplier": {
"anyOf": [
{
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string",
"description": "The supplier's id."
},
"name": {
"type": "string",
"description": "The supplier's name."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Set when the request asked for one supplier's offers."
},
"optionKey": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The configuration compared, from the product's options; null when the product has none."
},
"suppliers": {
"type": "array",
"items": {
"type": "object",
"required": [
"offer",
"otherOffers",
"otherOfferCount"
],
"properties": {
"offer": {
"type": "object",
"required": [
"supplierId",
"supplier",
"provider",
"product",
"price",
"shipping",
"duty",
"priceBasis",
"delivered",
"currency",
"available",
"comparable",
"cheapest",
"mostKept",
"isYourSupplier",
"profit",
"versusYours",
"note",
"criticalDifferences",
"differencesUnresolved",
"pricingPlan",
"deliveryDaysMin",
"deliveryDaysMax",
"checkedAt",
"actionUrl",
"productUrl",
"affiliate",
"facts"
],
"properties": {
"duty": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Supplier-billed duty in the response currency, separate from the delivered total; 0 when the supplier bills none, null when unverified."
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "How this offer's configuration differs from the one asked about, in words; null when there is nothing to add."
},
"facts": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"value"
],
"properties": {
"label": {
"type": "string",
"description": "What the fact is about."
},
"value": {
"type": "string",
"description": "The fact's value."
}
},
"additionalProperties": false
},
"description": "Labelled facts about this offer, such as print method, size range and quantity."
},
"price": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Product cost in the response currency, before shipping; null when unknown, never 0."
},
"profit": {
"anyOf": [
{
"oneOf": [
{
"type": "object",
"required": [
"status",
"dutyStatus",
"qualification",
"sale",
"supplierCost",
"fees",
"feeBreakdown",
"keep",
"margin"
],
"properties": {
"fees": {
"type": "number",
"description": "Platform fees for this sale in the response currency."
},
"keep": {
"type": "number",
"description": "What the seller keeps per sale before tax, in the response currency."
},
"sale": {
"type": "number",
"description": "The selling price in the response currency; with targetMargin, the price to charge."
},
"margin": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Share of the sale the seller keeps, 0 to 1; null when the sale is zero."
},
"status": {
"type": "string",
"const": "calculated",
"description": "Profit could be worked out for this offer."
},
"dutyStatus": {
"enum": [
"known",
"estimated",
"unknown"
],
"type": "string",
"description": "How well the supplier-billed duty is established: known, estimated from bounded quotes, or unknown."
},
"feeBreakdown": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"amount"
],
"properties": {
"label": {
"type": "string",
"description": "The fee's name, such as transaction fee."
},
"amount": {
"type": "number",
"description": "The fee amount in the response currency."
}
},
"additionalProperties": false
},
"description": "Each platform fee and its amount."
},
"supplierCost": {
"type": "number",
"description": "What the supplier charges in the response currency: product, shipping and any known duty."
},
"qualification": {
"type": "string",
"description": "In words, whether supplier-billed duty is included in or left out of this profit."
},
"estimatedDutyDeducted": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "The estimated duty deducted from the sale; null when duty is known or was not deducted."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"reason"
],
"properties": {
"reason": {
"enum": [
"missing_cost",
"fees_unavailable",
"target_not_reachable"
],
"type": "string",
"description": "Why: the supplier cost is unknown, the platform fees are unavailable, or the target margin cannot be reached."
},
"status": {
"type": "string",
"const": "unavailable",
"description": "Profit could not be worked out for this offer."
}
},
"additionalProperties": false
}
]
},
{
"type": "null"
}
],
"description": "This offer's profit when a selling price or target margin was given; null otherwise."
},
"product": {
"type": "string",
"description": "The supplier's own name for the product."
},
"taxNote": {
"type": "string",
"description": "How VAT or sales tax applies to this price, in words."
},
"cheapest": {
"type": "boolean",
"description": "Has the lowest product plus shipping total among comparable offers; false when the comparison cannot rank suppliers."
},
"currency": {
"anyOf": [
{
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "The currency these amounts are in; null when no price is known."
},
"mostKept": {
"type": "boolean",
"description": "Leaves the seller the most per sale; false unless profit is shown and every supplier-billed duty is known."
},
"provider": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The print provider that makes the order, for a marketplace; null for a direct supplier."
},
"shipping": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Shipping cost in the response currency; null when unknown, never 0."
},
"supplier": {
"type": "string",
"description": "The supplier's name."
},
"actionUrl": {
"type": "string",
"format": "uri",
"description": "The main link out to this offer: the supplier's product page, or its sign-up page when the affiliate programme pays only for sign-ups."
},
"affiliate": {
"type": "boolean",
"description": "Whether actionUrl earns a commission; it never changes prices or rankings."
},
"available": {
"type": "boolean",
"description": "The supplier sells this configuration and quotes it for the destination."
},
"checkedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When this price was last checked, as an ISO date-time; null when unknown."
},
"delivered": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Product plus shipping in the response currency; null when the supplier cannot price it, never 0."
},
"comparable": {
"type": "boolean",
"description": "The priced configuration matches the requested choice closely enough to compare."
},
"dutySource": {
"anyOf": [
{
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "number",
"minimum": 0,
"description": "The supplier's own duty amount, in its own currency."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "The currency the supplier states that duty in."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The supplier's own duty charge as it states it; null when none is published."
},
"priceBasis": {
"type": "string",
"const": "product-and-shipping",
"description": "What the delivered total covers: product and shipping."
},
"productUrl": {
"type": "string",
"format": "uri",
"description": "The supplier's page for this product and configuration."
},
"supplierId": {
"type": "string",
"description": "The supplier's id."
},
"dutyOutcome": {
"anyOf": [
{
"enum": [
"charged",
"not_applicable",
"estimated",
"unknown"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "charged when the supplier bills duty, not_applicable when none applies, estimated when only a range is known, unknown when unverified."
},
"pricingPlan": {
"type": "string",
"description": "The supplier plan this price uses, such as Standard pricing."
},
"versusYours": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Per sale against the seller's own supplier: positive means the seller keeps more here. Uses profit when shown, otherwise the delivered total; null when the two cannot be compared."
},
"dutyEstimate": {
"anyOf": [
{
"type": "object",
"required": [
"native",
"converted"
],
"properties": {
"native": {
"type": "object",
"required": [
"min",
"max",
"currency",
"basis"
],
"properties": {
"max": {
"type": "number",
"minimum": 0,
"description": "Highest amount in this duty range, in this currency."
},
"min": {
"type": "number",
"minimum": 0,
"description": "Lowest amount in this duty range, in this currency."
},
"basis": {
"type": "string",
"const": "line_net_x_compatible_product_rate",
"description": "How the estimate was derived: the line's net price times the supplier's per-product duty rate."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "The currency of these duty amounts."
}
},
"description": "The duty estimate in the supplier's own currency.",
"additionalProperties": false
},
"converted": {
"anyOf": [
{
"type": "object",
"required": [
"min",
"max",
"currency"
],
"properties": {
"max": {
"type": "number",
"minimum": 0,
"description": "Highest amount in this duty range, in this currency."
},
"min": {
"type": "number",
"minimum": 0,
"description": "Lowest amount in this duty range, in this currency."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "The currency of these duty amounts."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The same estimate in the response currency; null when it could not be converted."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The bounded duty estimate when only a range is known; absent otherwise."
},
"pricingBasis": {
"type": "string",
"description": "The selected price basis and any setup disclosure, in words."
},
"isYourSupplier": {
"type": "boolean",
"description": "The supplier the seller said they use today."
},
"pricingContext": {
"type": "object",
"required": [
"basis",
"policyId",
"policyVersion",
"source",
"recurringConditions",
"newDesignSetup",
"physicalSelections"
],
"properties": {
"basis": {
"enum": [
"existing-supplier-digitised-design",
"digitisation-included"
],
"type": "string",
"description": "What the price assumes: an existing design the seller already has, or included digitisation."
},
"source": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What the supplier states about this price, in its own words."
},
"policyId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Which pricing policy this context follows."
},
"policyVersion": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The version of that pricing policy."
},
"newDesignSetup": {
"oneOf": [
{
"type": "object",
"required": [
"status",
"fees",
"applicability",
"application",
"includedInDeliveredTotal"
],
"properties": {
"fees": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"amount",
"currency",
"taxBasis",
"scope",
"source",
"conditions"
],
"properties": {
"kind": {
"enum": [
"standard",
"text-only",
"image",
"adjustment",
"back-or-side",
"setup"
],
"type": "string",
"description": "What the fee is for: standard, text-only, image, adjustment, back-or-side or setup."
},
"scope": {
"enum": [
"per-design",
"per-design-and-area",
"per-order",
"per-unit",
"unknown"
],
"type": "string",
"description": "What the fee applies to: per design, per design and area, per order, per unit or unknown."
},
"amount": {
"type": "number",
"minimum": 0,
"description": "The fee amount in its own currency."
},
"source": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What the supplier states about this fee."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "Original supplier currency; never converted along with the unit price."
},
"taxBasis": {
"enum": [
"ex-vat",
"unknown"
],
"type": "string",
"description": "Whether the fee is quoted before VAT (ex-vat) or unclear."
},
"conditions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600,
"minLength": 1
},
"maxItems": 12,
"description": "What must hold for this fee to apply."
}
},
"additionalProperties": false
},
"maxItems": 8,
"minItems": 1,
"description": "The setup fees the supplier lists."
},
"status": {
"type": "string",
"const": "listed",
"description": "The supplier lists a setup charge."
},
"application": {
"type": "string",
"const": "not-modelled",
"description": "Always not-modelled: the charge is disclosed but never added to a total."
},
"applicability": {
"enum": [
"design-dependent",
"selected"
],
"type": "string",
"description": "design-dependent when the fee depends on the artwork, selected when one fee applies to this order."
},
"includedInDeliveredTotal": {
"type": "boolean",
"const": false,
"description": "Always false: setup charges stay outside the delivered total."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"source",
"conditions"
],
"properties": {
"source": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What the supplier states about the inclusion."
},
"status": {
"type": "string",
"const": "included",
"description": "Digitisation is included, so there is no setup charge."
},
"conditions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600,
"minLength": 1
},
"maxItems": 12,
"description": "What must hold for the inclusion."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"reason"
],
"properties": {
"reason": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "Why the setup charge is unknown."
},
"source": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What the supplier states, when it says anything."
},
"status": {
"type": "string",
"const": "unknown",
"description": "Whether a setup charge applies could not be established."
}
},
"additionalProperties": false
}
],
"description": "How a new design's setup is charged, or that it is included."
},
"physicalSelections": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"axisId",
"valueId",
"axisLabel",
"valueLabel"
],
"properties": {
"kind": {
"enum": [
"sku-option",
"standard-configuration"
],
"type": "string",
"description": "sku-option changes the unit price; standard-configuration is a fixed default."
},
"axisId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The option field's id, such as size."
},
"valueId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The chosen value's id."
},
"axisLabel": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The option field as shown, such as Size."
},
"valueLabel": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The chosen value as shown, such as Adult M."
}
},
"additionalProperties": false
},
"maxItems": 8,
"description": "The supplier options this price was quoted for."
},
"recurringConditions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600,
"minLength": 1
},
"maxItems": 12,
"description": "What must remain true for this recurring unit price."
}
},
"description": "Present when this price only holds under stated conditions, such as a design the seller already has.",
"additionalProperties": false
},
"sourceCurrency": {
"anyOf": [
{
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "The currency the supplier quoted its price in, before conversion to the response currency; null when no quote exists."
},
"deliveryDaysMax": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The supplier's longest stated delivery time, in days from order to arrival; null when unknown."
},
"deliveryDaysMin": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The supplier's shortest stated delivery time, in days from order to arrival; null when unknown."
},
"buyerImportWarning": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "A charge the buyer may pay on import, in words; null when there is none."
},
"criticalDifferences": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "Ways this product differs from the one asked about; empty for the same product."
},
"differencesUnresolved": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "null"
}
],
"description": "A difference that could not be confirmed; null when everything is known."
}
},
"description": "The offer this supplier's row shows.",
"additionalProperties": false
},
"otherOffers": {
"type": "array",
"items": {
"type": "object",
"required": [
"supplierId",
"supplier",
"provider",
"product",
"price",
"shipping",
"duty",
"priceBasis",
"delivered",
"currency",
"available",
"comparable",
"cheapest",
"mostKept",
"isYourSupplier",
"profit",
"versusYours",
"note",
"criticalDifferences",
"differencesUnresolved",
"pricingPlan",
"deliveryDaysMin",
"deliveryDaysMax",
"checkedAt",
"actionUrl",
"productUrl",
"affiliate",
"facts"
],
"properties": {
"duty": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Supplier-billed duty in the response currency, separate from the delivered total; 0 when the supplier bills none, null when unverified."
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "How this offer's configuration differs from the one asked about, in words; null when there is nothing to add."
},
"facts": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"value"
],
"properties": {
"label": {
"type": "string",
"description": "What the fact is about."
},
"value": {
"type": "string",
"description": "The fact's value."
}
},
"additionalProperties": false
},
"description": "Labelled facts about this offer, such as print method, size range and quantity."
},
"price": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Product cost in the response currency, before shipping; null when unknown, never 0."
},
"profit": {
"anyOf": [
{
"oneOf": [
{
"type": "object",
"required": [
"status",
"dutyStatus",
"qualification",
"sale",
"supplierCost",
"fees",
"feeBreakdown",
"keep",
"margin"
],
"properties": {
"fees": {
"type": "number",
"description": "Platform fees for this sale in the response currency."
},
"keep": {
"type": "number",
"description": "What the seller keeps per sale before tax, in the response currency."
},
"sale": {
"type": "number",
"description": "The selling price in the response currency; with targetMargin, the price to charge."
},
"margin": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Share of the sale the seller keeps, 0 to 1; null when the sale is zero."
},
"status": {
"type": "string",
"const": "calculated",
"description": "Profit could be worked out for this offer."
},
"dutyStatus": {
"enum": [
"known",
"estimated",
"unknown"
],
"type": "string",
"description": "How well the supplier-billed duty is established: known, estimated from bounded quotes, or unknown."
},
"feeBreakdown": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"amount"
],
"properties": {
"label": {
"type": "string",
"description": "The fee's name, such as transaction fee."
},
"amount": {
"type": "number",
"description": "The fee amount in the response currency."
}
},
"additionalProperties": false
},
"description": "Each platform fee and its amount."
},
"supplierCost": {
"type": "number",
"description": "What the supplier charges in the response currency: product, shipping and any known duty."
},
"qualification": {
"type": "string",
"description": "In words, whether supplier-billed duty is included in or left out of this profit."
},
"estimatedDutyDeducted": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "The estimated duty deducted from the sale; null when duty is known or was not deducted."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"reason"
],
"properties": {
"reason": {
"enum": [
"missing_cost",
"fees_unavailable",
"target_not_reachable"
],
"type": "string",
"description": "Why: the supplier cost is unknown, the platform fees are unavailable, or the target margin cannot be reached."
},
"status": {
"type": "string",
"const": "unavailable",
"description": "Profit could not be worked out for this offer."
}
},
"additionalProperties": false
}
]
},
{
"type": "null"
}
],
"description": "This offer's profit when a selling price or target margin was given; null otherwise."
},
"product": {
"type": "string",
"description": "The supplier's own name for the product."
},
"taxNote": {
"type": "string",
"description": "How VAT or sales tax applies to this price, in words."
},
"cheapest": {
"type": "boolean",
"description": "Has the lowest product plus shipping total among comparable offers; false when the comparison cannot rank suppliers."
},
"currency": {
"anyOf": [
{
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "The currency these amounts are in; null when no price is known."
},
"mostKept": {
"type": "boolean",
"description": "Leaves the seller the most per sale; false unless profit is shown and every supplier-billed duty is known."
},
"provider": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The print provider that makes the order, for a marketplace; null for a direct supplier."
},
"shipping": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Shipping cost in the response currency; null when unknown, never 0."
},
"supplier": {
"type": "string",
"description": "The supplier's name."
},
"actionUrl": {
"type": "string",
"format": "uri",
"description": "The main link out to this offer: the supplier's product page, or its sign-up page when the affiliate programme pays only for sign-ups."
},
"affiliate": {
"type": "boolean",
"description": "Whether actionUrl earns a commission; it never changes prices or rankings."
},
"available": {
"type": "boolean",
"description": "The supplier sells this configuration and quotes it for the destination."
},
"checkedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When this price was last checked, as an ISO date-time; null when unknown."
},
"delivered": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Product plus shipping in the response currency; null when the supplier cannot price it, never 0."
},
"comparable": {
"type": "boolean",
"description": "The priced configuration matches the requested choice closely enough to compare."
},
"dutySource": {
"anyOf": [
{
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "number",
"minimum": 0,
"description": "The supplier's own duty amount, in its own currency."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "The currency the supplier states that duty in."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The supplier's own duty charge as it states it; null when none is published."
},
"priceBasis": {
"type": "string",
"const": "product-and-shipping",
"description": "What the delivered total covers: product and shipping."
},
"productUrl": {
"type": "string",
"format": "uri",
"description": "The supplier's page for this product and configuration."
},
"supplierId": {
"type": "string",
"description": "The supplier's id."
},
"dutyOutcome": {
"anyOf": [
{
"enum": [
"charged",
"not_applicable",
"estimated",
"unknown"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "charged when the supplier bills duty, not_applicable when none applies, estimated when only a range is known, unknown when unverified."
},
"pricingPlan": {
"type": "string",
"description": "The supplier plan this price uses, such as Standard pricing."
},
"versusYours": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Per sale against the seller's own supplier: positive means the seller keeps more here. Uses profit when shown, otherwise the delivered total; null when the two cannot be compared."
},
"dutyEstimate": {
"anyOf": [
{
"type": "object",
"required": [
"native",
"converted"
],
"properties": {
"native": {
"type": "object",
"required": [
"min",
"max",
"currency",
"basis"
],
"properties": {
"max": {
"type": "number",
"minimum": 0,
"description": "Highest amount in this duty range, in this currency."
},
"min": {
"type": "number",
"minimum": 0,
"description": "Lowest amount in this duty range, in this currency."
},
"basis": {
"type": "string",
"const": "line_net_x_compatible_product_rate",
"description": "How the estimate was derived: the line's net price times the supplier's per-product duty rate."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "The currency of these duty amounts."
}
},
"description": "The duty estimate in the supplier's own currency.",
"additionalProperties": false
},
"converted": {
"anyOf": [
{
"type": "object",
"required": [
"min",
"max",
"currency"
],
"properties": {
"max": {
"type": "number",
"minimum": 0,
"description": "Highest amount in this duty range, in this currency."
},
"min": {
"type": "number",
"minimum": 0,
"description": "Lowest amount in this duty range, in this currency."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "The currency of these duty amounts."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The same estimate in the response currency; null when it could not be converted."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The bounded duty estimate when only a range is known; absent otherwise."
},
"pricingBasis": {
"type": "string",
"description": "The selected price basis and any setup disclosure, in words."
},
"isYourSupplier": {
"type": "boolean",
"description": "The supplier the seller said they use today."
},
"pricingContext": {
"type": "object",
"required": [
"basis",
"policyId",
"policyVersion",
"source",
"recurringConditions",
"newDesignSetup",
"physicalSelections"
],
"properties": {
"basis": {
"enum": [
"existing-supplier-digitised-design",
"digitisation-included"
],
"type": "string",
"description": "What the price assumes: an existing design the seller already has, or included digitisation."
},
"source": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What the supplier states about this price, in its own words."
},
"policyId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Which pricing policy this context follows."
},
"policyVersion": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The version of that pricing policy."
},
"newDesignSetup": {
"oneOf": [
{
"type": "object",
"required": [
"status",
"fees",
"applicability",
"application",
"includedInDeliveredTotal"
],
"properties": {
"fees": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"amount",
"currency",
"taxBasis",
"scope",
"source",
"conditions"
],
"properties": {
"kind": {
"enum": [
"standard",
"text-only",
"image",
"adjustment",
"back-or-side",
"setup"
],
"type": "string",
"description": "What the fee is for: standard, text-only, image, adjustment, back-or-side or setup."
},
"scope": {
"enum": [
"per-design",
"per-design-and-area",
"per-order",
"per-unit",
"unknown"
],
"type": "string",
"description": "What the fee applies to: per design, per design and area, per order, per unit or unknown."
},
"amount": {
"type": "number",
"minimum": 0,
"description": "The fee amount in its own currency."
},
"source": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What the supplier states about this fee."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "Original supplier currency; never converted along with the unit price."
},
"taxBasis": {
"enum": [
"ex-vat",
"unknown"
],
"type": "string",
"description": "Whether the fee is quoted before VAT (ex-vat) or unclear."
},
"conditions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600,
"minLength": 1
},
"maxItems": 12,
"description": "What must hold for this fee to apply."
}
},
"additionalProperties": false
},
"maxItems": 8,
"minItems": 1,
"description": "The setup fees the supplier lists."
},
"status": {
"type": "string",
"const": "listed",
"description": "The supplier lists a setup charge."
},
"application": {
"type": "string",
"const": "not-modelled",
"description": "Always not-modelled: the charge is disclosed but never added to a total."
},
"applicability": {
"enum": [
"design-dependent",
"selected"
],
"type": "string",
"description": "design-dependent when the fee depends on the artwork, selected when one fee applies to this order."
},
"includedInDeliveredTotal": {
"type": "boolean",
"const": false,
"description": "Always false: setup charges stay outside the delivered total."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"source",
"conditions"
],
"properties": {
"source": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What the supplier states about the inclusion."
},
"status": {
"type": "string",
"const": "included",
"description": "Digitisation is included, so there is no setup charge."
},
"conditions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600,
"minLength": 1
},
"maxItems": 12,
"description": "What must hold for the inclusion."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"reason"
],
"properties": {
"reason": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "Why the setup charge is unknown."
},
"source": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What the supplier states, when it says anything."
},
"status": {
"type": "string",
"const": "unknown",
"description": "Whether a setup charge applies could not be established."
}
},
"additionalProperties": false
}
],
"description": "How a new design's setup is charged, or that it is included."
},
"physicalSelections": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"axisId",
"valueId",
"axisLabel",
"valueLabel"
],
"properties": {
"kind": {
"enum": [
"sku-option",
"standard-configuration"
],
"type": "string",
"description": "sku-option changes the unit price; standard-configuration is a fixed default."
},
"axisId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The option field's id, such as size."
},
"valueId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The chosen value's id."
},
"axisLabel": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The option field as shown, such as Size."
},
"valueLabel": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The chosen value as shown, such as Adult M."
}
},
"additionalProperties": false
},
"maxItems": 8,
"description": "The supplier options this price was quoted for."
},
"recurringConditions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600,
"minLength": 1
},
"maxItems": 12,
"description": "What must remain true for this recurring unit price."
}
},
"description": "Present when this price only holds under stated conditions, such as a design the seller already has.",
"additionalProperties": false
},
"sourceCurrency": {
"anyOf": [
{
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "The currency the supplier quoted its price in, before conversion to the response currency; null when no quote exists."
},
"deliveryDaysMax": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The supplier's longest stated delivery time, in days from order to arrival; null when unknown."
},
"deliveryDaysMin": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The supplier's shortest stated delivery time, in days from order to arrival; null when unknown."
},
"buyerImportWarning": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "A charge the buyer may pay on import, in words; null when there is none."
},
"criticalDifferences": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "Ways this product differs from the one asked about; empty for the same product."
},
"differencesUnresolved": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "null"
}
],
"description": "A difference that could not be confirmed; null when everything is known."
}
},
"additionalProperties": false
},
"maxItems": 50,
"description": "This supplier's other products and print providers for the choice."
},
"otherOfferCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many other offers this supplier has, including any beyond otherOffers."
}
},
"additionalProperties": false
},
"description": "One entry per supplier, the seller's own pinned first when given, then most profit first when profit is shown."
},
"destination": {
"enum": [
"US",
"GB",
"DE",
"AU",
"CA"
],
"type": "string",
"description": "The buyer's country these prices are for."
},
"optionCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many configurations the product supports in total, before the 100 listed in options."
},
"optionLabel": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "That configuration in words, such as `Adult M / Black`; null when the product has none."
},
"pricingTier": {
"enum": [
"base",
"tier1",
"tier2"
],
"type": "string",
"description": "The supplier plan the prices come from: base is standard, tier1 and tier2 are paid plans."
},
"alternatives": {
"type": "array",
"items": {
"type": "object",
"required": [
"offer",
"otherOffers",
"otherOfferCount"
],
"properties": {
"offer": {
"type": "object",
"required": [
"supplierId",
"supplier",
"provider",
"product",
"price",
"shipping",
"duty",
"priceBasis",
"delivered",
"currency",
"available",
"comparable",
"cheapest",
"mostKept",
"isYourSupplier",
"profit",
"versusYours",
"note",
"criticalDifferences",
"differencesUnresolved",
"pricingPlan",
"deliveryDaysMin",
"deliveryDaysMax",
"checkedAt",
"actionUrl",
"productUrl",
"affiliate",
"facts"
],
"properties": {
"duty": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Supplier-billed duty in the response currency, separate from the delivered total; 0 when the supplier bills none, null when unverified."
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "How this offer's configuration differs from the one asked about, in words; null when there is nothing to add."
},
"facts": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"value"
],
"properties": {
"label": {
"type": "string",
"description": "What the fact is about."
},
"value": {
"type": "string",
"description": "The fact's value."
}
},
"additionalProperties": false
},
"description": "Labelled facts about this offer, such as print method, size range and quantity."
},
"price": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Product cost in the response currency, before shipping; null when unknown, never 0."
},
"profit": {
"anyOf": [
{
"oneOf": [
{
"type": "object",
"required": [
"status",
"dutyStatus",
"qualification",
"sale",
"supplierCost",
"fees",
"feeBreakdown",
"keep",
"margin"
],
"properties": {
"fees": {
"type": "number",
"description": "Platform fees for this sale in the response currency."
},
"keep": {
"type": "number",
"description": "What the seller keeps per sale before tax, in the response currency."
},
"sale": {
"type": "number",
"description": "The selling price in the response currency; with targetMargin, the price to charge."
},
"margin": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Share of the sale the seller keeps, 0 to 1; null when the sale is zero."
},
"status": {
"type": "string",
"const": "calculated",
"description": "Profit could be worked out for this offer."
},
"dutyStatus": {
"enum": [
"known",
"estimated",
"unknown"
],
"type": "string",
"description": "How well the supplier-billed duty is established: known, estimated from bounded quotes, or unknown."
},
"feeBreakdown": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"amount"
],
"properties": {
"label": {
"type": "string",
"description": "The fee's name, such as transaction fee."
},
"amount": {
"type": "number",
"description": "The fee amount in the response currency."
}
},
"additionalProperties": false
},
"description": "Each platform fee and its amount."
},
"supplierCost": {
"type": "number",
"description": "What the supplier charges in the response currency: product, shipping and any known duty."
},
"qualification": {
"type": "string",
"description": "In words, whether supplier-billed duty is included in or left out of this profit."
},
"estimatedDutyDeducted": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "The estimated duty deducted from the sale; null when duty is known or was not deducted."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"reason"
],
"properties": {
"reason": {
"enum": [
"missing_cost",
"fees_unavailable",
"target_not_reachable"
],
"type": "string",
"description": "Why: the supplier cost is unknown, the platform fees are unavailable, or the target margin cannot be reached."
},
"status": {
"type": "string",
"const": "unavailable",
"description": "Profit could not be worked out for this offer."
}
},
"additionalProperties": false
}
]
},
{
"type": "null"
}
],
"description": "This offer's profit when a selling price or target margin was given; null otherwise."
},
"product": {
"type": "string",
"description": "The supplier's own name for the product."
},
"taxNote": {
"type": "string",
"description": "How VAT or sales tax applies to this price, in words."
},
"cheapest": {
"type": "boolean",
"description": "Has the lowest product plus shipping total among comparable offers; false when the comparison cannot rank suppliers."
},
"currency": {
"anyOf": [
{
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "The currency these amounts are in; null when no price is known."
},
"mostKept": {
"type": "boolean",
"description": "Leaves the seller the most per sale; false unless profit is shown and every supplier-billed duty is known."
},
"provider": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The print provider that makes the order, for a marketplace; null for a direct supplier."
},
"shipping": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Shipping cost in the response currency; null when unknown, never 0."
},
"supplier": {
"type": "string",
"description": "The supplier's name."
},
"actionUrl": {
"type": "string",
"format": "uri",
"description": "The main link out to this offer: the supplier's product page, or its sign-up page when the affiliate programme pays only for sign-ups."
},
"affiliate": {
"type": "boolean",
"description": "Whether actionUrl earns a commission; it never changes prices or rankings."
},
"available": {
"type": "boolean",
"description": "The supplier sells this configuration and quotes it for the destination."
},
"checkedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When this price was last checked, as an ISO date-time; null when unknown."
},
"delivered": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Product plus shipping in the response currency; null when the supplier cannot price it, never 0."
},
"comparable": {
"type": "boolean",
"description": "The priced configuration matches the requested choice closely enough to compare."
},
"dutySource": {
"anyOf": [
{
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "number",
"minimum": 0,
"description": "The supplier's own duty amount, in its own currency."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "The currency the supplier states that duty in."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The supplier's own duty charge as it states it; null when none is published."
},
"priceBasis": {
"type": "string",
"const": "product-and-shipping",
"description": "What the delivered total covers: product and shipping."
},
"productUrl": {
"type": "string",
"format": "uri",
"description": "The supplier's page for this product and configuration."
},
"supplierId": {
"type": "string",
"description": "The supplier's id."
},
"dutyOutcome": {
"anyOf": [
{
"enum": [
"charged",
"not_applicable",
"estimated",
"unknown"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "charged when the supplier bills duty, not_applicable when none applies, estimated when only a range is known, unknown when unverified."
},
"pricingPlan": {
"type": "string",
"description": "The supplier plan this price uses, such as Standard pricing."
},
"versusYours": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Per sale against the seller's own supplier: positive means the seller keeps more here. Uses profit when shown, otherwise the delivered total; null when the two cannot be compared."
},
"dutyEstimate": {
"anyOf": [
{
"type": "object",
"required": [
"native",
"converted"
],
"properties": {
"native": {
"type": "object",
"required": [
"min",
"max",
"currency",
"basis"
],
"properties": {
"max": {
"type": "number",
"minimum": 0,
"description": "Highest amount in this duty range, in this currency."
},
"min": {
"type": "number",
"minimum": 0,
"description": "Lowest amount in this duty range, in this currency."
},
"basis": {
"type": "string",
"const": "line_net_x_compatible_product_rate",
"description": "How the estimate was derived: the line's net price times the supplier's per-product duty rate."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "The currency of these duty amounts."
}
},
"description": "The duty estimate in the supplier's own currency.",
"additionalProperties": false
},
"converted": {
"anyOf": [
{
"type": "object",
"required": [
"min",
"max",
"currency"
],
"properties": {
"max": {
"type": "number",
"minimum": 0,
"description": "Highest amount in this duty range, in this currency."
},
"min": {
"type": "number",
"minimum": 0,
"description": "Lowest amount in this duty range, in this currency."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "The currency of these duty amounts."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The same estimate in the response currency; null when it could not be converted."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The bounded duty estimate when only a range is known; absent otherwise."
},
"pricingBasis": {
"type": "string",
"description": "The selected price basis and any setup disclosure, in words."
},
"isYourSupplier": {
"type": "boolean",
"description": "The supplier the seller said they use today."
},
"pricingContext": {
"type": "object",
"required": [
"basis",
"policyId",
"policyVersion",
"source",
"recurringConditions",
"newDesignSetup",
"physicalSelections"
],
"properties": {
"basis": {
"enum": [
"existing-supplier-digitised-design",
"digitisation-included"
],
"type": "string",
"description": "What the price assumes: an existing design the seller already has, or included digitisation."
},
"source": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What the supplier states about this price, in its own words."
},
"policyId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Which pricing policy this context follows."
},
"policyVersion": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The version of that pricing policy."
},
"newDesignSetup": {
"oneOf": [
{
"type": "object",
"required": [
"status",
"fees",
"applicability",
"application",
"includedInDeliveredTotal"
],
"properties": {
"fees": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"amount",
"currency",
"taxBasis",
"scope",
"source",
"conditions"
],
"properties": {
"kind": {
"enum": [
"standard",
"text-only",
"image",
"adjustment",
"back-or-side",
"setup"
],
"type": "string",
"description": "What the fee is for: standard, text-only, image, adjustment, back-or-side or setup."
},
"scope": {
"enum": [
"per-design",
"per-design-and-area",
"per-order",
"per-unit",
"unknown"
],
"type": "string",
"description": "What the fee applies to: per design, per design and area, per order, per unit or unknown."
},
"amount": {
"type": "number",
"minimum": 0,
"description": "The fee amount in its own currency."
},
"source": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What the supplier states about this fee."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "Original supplier currency; never converted along with the unit price."
},
"taxBasis": {
"enum": [
"ex-vat",
"unknown"
],
"type": "string",
"description": "Whether the fee is quoted before VAT (ex-vat) or unclear."
},
"conditions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600,
"minLength": 1
},
"maxItems": 12,
"description": "What must hold for this fee to apply."
}
},
"additionalProperties": false
},
"maxItems": 8,
"minItems": 1,
"description": "The setup fees the supplier lists."
},
"status": {
"type": "string",
"const": "listed",
"description": "The supplier lists a setup charge."
},
"application": {
"type": "string",
"const": "not-modelled",
"description": "Always not-modelled: the charge is disclosed but never added to a total."
},
"applicability": {
"enum": [
"design-dependent",
"selected"
],
"type": "string",
"description": "design-dependent when the fee depends on the artwork, selected when one fee applies to this order."
},
"includedInDeliveredTotal": {
"type": "boolean",
"const": false,
"description": "Always false: setup charges stay outside the delivered total."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"source",
"conditions"
],
"properties": {
"source": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What the supplier states about the inclusion."
},
"status": {
"type": "string",
"const": "included",
"description": "Digitisation is included, so there is no setup charge."
},
"conditions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600,
"minLength": 1
},
"maxItems": 12,
"description": "What must hold for the inclusion."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"reason"
],
"properties": {
"reason": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "Why the setup charge is unknown."
},
"source": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What the supplier states, when it says anything."
},
"status": {
"type": "string",
"const": "unknown",
"description": "Whether a setup charge applies could not be established."
}
},
"additionalProperties": false
}
],
"description": "How a new design's setup is charged, or that it is included."
},
"physicalSelections": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"axisId",
"valueId",
"axisLabel",
"valueLabel"
],
"properties": {
"kind": {
"enum": [
"sku-option",
"standard-configuration"
],
"type": "string",
"description": "sku-option changes the unit price; standard-configuration is a fixed default."
},
"axisId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The option field's id, such as size."
},
"valueId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The chosen value's id."
},
"axisLabel": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The option field as shown, such as Size."
},
"valueLabel": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The chosen value as shown, such as Adult M."
}
},
"additionalProperties": false
},
"maxItems": 8,
"description": "The supplier options this price was quoted for."
},
"recurringConditions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600,
"minLength": 1
},
"maxItems": 12,
"description": "What must remain true for this recurring unit price."
}
},
"description": "Present when this price only holds under stated conditions, such as a design the seller already has.",
"additionalProperties": false
},
"sourceCurrency": {
"anyOf": [
{
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "The currency the supplier quoted its price in, before conversion to the response currency; null when no quote exists."
},
"deliveryDaysMax": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The supplier's longest stated delivery time, in days from order to arrival; null when unknown."
},
"deliveryDaysMin": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The supplier's shortest stated delivery time, in days from order to arrival; null when unknown."
},
"buyerImportWarning": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "A charge the buyer may pay on import, in words; null when there is none."
},
"criticalDifferences": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "Ways this product differs from the one asked about; empty for the same product."
},
"differencesUnresolved": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "null"
}
],
"description": "A difference that could not be confirmed; null when everything is known."
}
},
"description": "The offer this supplier's row shows.",
"additionalProperties": false
},
"otherOffers": {
"type": "array",
"items": {
"type": "object",
"required": [
"supplierId",
"supplier",
"provider",
"product",
"price",
"shipping",
"duty",
"priceBasis",
"delivered",
"currency",
"available",
"comparable",
"cheapest",
"mostKept",
"isYourSupplier",
"profit",
"versusYours",
"note",
"criticalDifferences",
"differencesUnresolved",
"pricingPlan",
"deliveryDaysMin",
"deliveryDaysMax",
"checkedAt",
"actionUrl",
"productUrl",
"affiliate",
"facts"
],
"properties": {
"duty": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Supplier-billed duty in the response currency, separate from the delivered total; 0 when the supplier bills none, null when unverified."
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "How this offer's configuration differs from the one asked about, in words; null when there is nothing to add."
},
"facts": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"value"
],
"properties": {
"label": {
"type": "string",
"description": "What the fact is about."
},
"value": {
"type": "string",
"description": "The fact's value."
}
},
"additionalProperties": false
},
"description": "Labelled facts about this offer, such as print method, size range and quantity."
},
"price": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Product cost in the response currency, before shipping; null when unknown, never 0."
},
"profit": {
"anyOf": [
{
"oneOf": [
{
"type": "object",
"required": [
"status",
"dutyStatus",
"qualification",
"sale",
"supplierCost",
"fees",
"feeBreakdown",
"keep",
"margin"
],
"properties": {
"fees": {
"type": "number",
"description": "Platform fees for this sale in the response currency."
},
"keep": {
"type": "number",
"description": "What the seller keeps per sale before tax, in the response currency."
},
"sale": {
"type": "number",
"description": "The selling price in the response currency; with targetMargin, the price to charge."
},
"margin": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Share of the sale the seller keeps, 0 to 1; null when the sale is zero."
},
"status": {
"type": "string",
"const": "calculated",
"description": "Profit could be worked out for this offer."
},
"dutyStatus": {
"enum": [
"known",
"estimated",
"unknown"
],
"type": "string",
"description": "How well the supplier-billed duty is established: known, estimated from bounded quotes, or unknown."
},
"feeBreakdown": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"amount"
],
"properties": {
"label": {
"type": "string",
"description": "The fee's name, such as transaction fee."
},
"amount": {
"type": "number",
"description": "The fee amount in the response currency."
}
},
"additionalProperties": false
},
"description": "Each platform fee and its amount."
},
"supplierCost": {
"type": "number",
"description": "What the supplier charges in the response currency: product, shipping and any known duty."
},
"qualification": {
"type": "string",
"description": "In words, whether supplier-billed duty is included in or left out of this profit."
},
"estimatedDutyDeducted": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "The estimated duty deducted from the sale; null when duty is known or was not deducted."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"reason"
],
"properties": {
"reason": {
"enum": [
"missing_cost",
"fees_unavailable",
"target_not_reachable"
],
"type": "string",
"description": "Why: the supplier cost is unknown, the platform fees are unavailable, or the target margin cannot be reached."
},
"status": {
"type": "string",
"const": "unavailable",
"description": "Profit could not be worked out for this offer."
}
},
"additionalProperties": false
}
]
},
{
"type": "null"
}
],
"description": "This offer's profit when a selling price or target margin was given; null otherwise."
},
"product": {
"type": "string",
"description": "The supplier's own name for the product."
},
"taxNote": {
"type": "string",
"description": "How VAT or sales tax applies to this price, in words."
},
"cheapest": {
"type": "boolean",
"description": "Has the lowest product plus shipping total among comparable offers; false when the comparison cannot rank suppliers."
},
"currency": {
"anyOf": [
{
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "The currency these amounts are in; null when no price is known."
},
"mostKept": {
"type": "boolean",
"description": "Leaves the seller the most per sale; false unless profit is shown and every supplier-billed duty is known."
},
"provider": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The print provider that makes the order, for a marketplace; null for a direct supplier."
},
"shipping": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Shipping cost in the response currency; null when unknown, never 0."
},
"supplier": {
"type": "string",
"description": "The supplier's name."
},
"actionUrl": {
"type": "string",
"format": "uri",
"description": "The main link out to this offer: the supplier's product page, or its sign-up page when the affiliate programme pays only for sign-ups."
},
"affiliate": {
"type": "boolean",
"description": "Whether actionUrl earns a commission; it never changes prices or rankings."
},
"available": {
"type": "boolean",
"description": "The supplier sells this configuration and quotes it for the destination."
},
"checkedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When this price was last checked, as an ISO date-time; null when unknown."
},
"delivered": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Product plus shipping in the response currency; null when the supplier cannot price it, never 0."
},
"comparable": {
"type": "boolean",
"description": "The priced configuration matches the requested choice closely enough to compare."
},
"dutySource": {
"anyOf": [
{
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "number",
"minimum": 0,
"description": "The supplier's own duty amount, in its own currency."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "The currency the supplier states that duty in."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The supplier's own duty charge as it states it; null when none is published."
},
"priceBasis": {
"type": "string",
"const": "product-and-shipping",
"description": "What the delivered total covers: product and shipping."
},
"productUrl": {
"type": "string",
"format": "uri",
"description": "The supplier's page for this product and configuration."
},
"supplierId": {
"type": "string",
"description": "The supplier's id."
},
"dutyOutcome": {
"anyOf": [
{
"enum": [
"charged",
"not_applicable",
"estimated",
"unknown"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "charged when the supplier bills duty, not_applicable when none applies, estimated when only a range is known, unknown when unverified."
},
"pricingPlan": {
"type": "string",
"description": "The supplier plan this price uses, such as Standard pricing."
},
"versusYours": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Per sale against the seller's own supplier: positive means the seller keeps more here. Uses profit when shown, otherwise the delivered total; null when the two cannot be compared."
},
"dutyEstimate": {
"anyOf": [
{
"type": "object",
"required": [
"native",
"converted"
],
"properties": {
"native": {
"type": "object",
"required": [
"min",
"max",
"currency",
"basis"
],
"properties": {
"max": {
"type": "number",
"minimum": 0,
"description": "Highest amount in this duty range, in this currency."
},
"min": {
"type": "number",
"minimum": 0,
"description": "Lowest amount in this duty range, in this currency."
},
"basis": {
"type": "string",
"const": "line_net_x_compatible_product_rate",
"description": "How the estimate was derived: the line's net price times the supplier's per-product duty rate."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "The currency of these duty amounts."
}
},
"description": "The duty estimate in the supplier's own currency.",
"additionalProperties": false
},
"converted": {
"anyOf": [
{
"type": "object",
"required": [
"min",
"max",
"currency"
],
"properties": {
"max": {
"type": "number",
"minimum": 0,
"description": "Highest amount in this duty range, in this currency."
},
"min": {
"type": "number",
"minimum": 0,
"description": "Lowest amount in this duty range, in this currency."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "The currency of these duty amounts."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The same estimate in the response currency; null when it could not be converted."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The bounded duty estimate when only a range is known; absent otherwise."
},
"pricingBasis": {
"type": "string",
"description": "The selected price basis and any setup disclosure, in words."
},
"isYourSupplier": {
"type": "boolean",
"description": "The supplier the seller said they use today."
},
"pricingContext": {
"type": "object",
"required": [
"basis",
"policyId",
"policyVersion",
"source",
"recurringConditions",
"newDesignSetup",
"physicalSelections"
],
"properties": {
"basis": {
"enum": [
"existing-supplier-digitised-design",
"digitisation-included"
],
"type": "string",
"description": "What the price assumes: an existing design the seller already has, or included digitisation."
},
"source": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What the supplier states about this price, in its own words."
},
"policyId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Which pricing policy this context follows."
},
"policyVersion": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The version of that pricing policy."
},
"newDesignSetup": {
"oneOf": [
{
"type": "object",
"required": [
"status",
"fees",
"applicability",
"application",
"includedInDeliveredTotal"
],
"properties": {
"fees": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"amount",
"currency",
"taxBasis",
"scope",
"source",
"conditions"
],
"properties": {
"kind": {
"enum": [
"standard",
"text-only",
"image",
"adjustment",
"back-or-side",
"setup"
],
"type": "string",
"description": "What the fee is for: standard, text-only, image, adjustment, back-or-side or setup."
},
"scope": {
"enum": [
"per-design",
"per-design-and-area",
"per-order",
"per-unit",
"unknown"
],
"type": "string",
"description": "What the fee applies to: per design, per design and area, per order, per unit or unknown."
},
"amount": {
"type": "number",
"minimum": 0,
"description": "The fee amount in its own currency."
},
"source": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What the supplier states about this fee."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "Original supplier currency; never converted along with the unit price."
},
"taxBasis": {
"enum": [
"ex-vat",
"unknown"
],
"type": "string",
"description": "Whether the fee is quoted before VAT (ex-vat) or unclear."
},
"conditions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600,
"minLength": 1
},
"maxItems": 12,
"description": "What must hold for this fee to apply."
}
},
"additionalProperties": false
},
"maxItems": 8,
"minItems": 1,
"description": "The setup fees the supplier lists."
},
"status": {
"type": "string",
"const": "listed",
"description": "The supplier lists a setup charge."
},
"application": {
"type": "string",
"const": "not-modelled",
"description": "Always not-modelled: the charge is disclosed but never added to a total."
},
"applicability": {
"enum": [
"design-dependent",
"selected"
],
"type": "string",
"description": "design-dependent when the fee depends on the artwork, selected when one fee applies to this order."
},
"includedInDeliveredTotal": {
"type": "boolean",
"const": false,
"description": "Always false: setup charges stay outside the delivered total."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"source",
"conditions"
],
"properties": {
"source": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What the supplier states about the inclusion."
},
"status": {
"type": "string",
"const": "included",
"description": "Digitisation is included, so there is no setup charge."
},
"conditions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600,
"minLength": 1
},
"maxItems": 12,
"description": "What must hold for the inclusion."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"reason"
],
"properties": {
"reason": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "Why the setup charge is unknown."
},
"source": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What the supplier states, when it says anything."
},
"status": {
"type": "string",
"const": "unknown",
"description": "Whether a setup charge applies could not be established."
}
},
"additionalProperties": false
}
],
"description": "How a new design's setup is charged, or that it is included."
},
"physicalSelections": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"axisId",
"valueId",
"axisLabel",
"valueLabel"
],
"properties": {
"kind": {
"enum": [
"sku-option",
"standard-configuration"
],
"type": "string",
"description": "sku-option changes the unit price; standard-configuration is a fixed default."
},
"axisId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The option field's id, such as size."
},
"valueId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The chosen value's id."
},
"axisLabel": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The option field as shown, such as Size."
},
"valueLabel": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The chosen value as shown, such as Adult M."
}
},
"additionalProperties": false
},
"maxItems": 8,
"description": "The supplier options this price was quoted for."
},
"recurringConditions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600,
"minLength": 1
},
"maxItems": 12,
"description": "What must remain true for this recurring unit price."
}
},
"description": "Present when this price only holds under stated conditions, such as a design the seller already has.",
"additionalProperties": false
},
"sourceCurrency": {
"anyOf": [
{
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "The currency the supplier quoted its price in, before conversion to the response currency; null when no quote exists."
},
"deliveryDaysMax": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The supplier's longest stated delivery time, in days from order to arrival; null when unknown."
},
"deliveryDaysMin": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The supplier's shortest stated delivery time, in days from order to arrival; null when unknown."
},
"buyerImportWarning": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "A charge the buyer may pay on import, in words; null when there is none."
},
"criticalDifferences": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "Ways this product differs from the one asked about; empty for the same product."
},
"differencesUnresolved": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "null"
}
],
"description": "A difference that could not be confirmed; null when everything is known."
}
},
"additionalProperties": false
},
"maxItems": 50,
"description": "This supplier's other products and print providers for the choice."
},
"otherOfferCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many other offers this supplier has, including any beyond otherOffers."
}
},
"additionalProperties": false
},
"description": "Similar products compared alongside, kept separate from the same product's suppliers."
},
"priceContext": {
"type": "string",
"description": "What the prices cover and which option they reflect, in words."
},
"yourSupplier": {
"anyOf": [
{
"type": "object",
"required": [
"id",
"name",
"sellsProduct"
],
"properties": {
"id": {
"type": "string",
"description": "The supplier's id."
},
"name": {
"type": "string",
"description": "The supplier's name."
},
"sellsProduct": {
"type": "boolean",
"description": "False when the supplier does not sell this product in this configuration."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The supplier the seller said they use; null when they did not say."
},
"optionChoices": {
"type": "object",
"description": "The selected option by field, such as { size: \"Adult M\", color: \"Black\" }.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"affiliateDisclosure": {
"type": "string",
"description": "The commission disclosure that applies to affiliate links."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"ok",
"error"
],
"properties": {
"ok": {
"type": "boolean",
"const": false
},
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"enum": [
"invalid_input",
"not_found",
"product_not_found",
"invalid_option",
"comparison_unavailable",
"unavailable",
"rate_limited"
],
"type": "string",
"description": "The machine-readable reason the call failed."
},
"message": {
"type": "string",
"description": "What went wrong, in words, and what to do next."
},
"retryable": {
"type": "boolean",
"description": "Whether calling again could succeed."
}
},
"description": "The error this call returned instead of a result.",
"additionalProperties": false
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
},
"annotations": {
"title": "Compare print-on-demand suppliers",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description97/100
Use this when a seller pastes a supplier product link (Printify, Printful, Gelato, Prodigi, Apliiq, Artelo, CustomCat, Fourthwall, Inkthreadable or merchOne). Returns the matching POD Benchmark product and any colour the link selects, ready for compare_product with yourSupplier set to that supplier. It never opens the link.
The description explains the capability, when to use it, and what to expect.
Inputs75/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
url
A supplier's product page, such as a Printify or Printful product link.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
Annotations100/100
All four behavior hints are declared.
{
"title": "Find the product behind a supplier link",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
Output schema91/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"oneOf": [
{
"type": "object",
"required": [
"ok",
"status",
"matches",
"message"
],
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"status": {
"enum": [
"resolved",
"ambiguous",
"unsupported",
"no-match",
"configuration-unavailable",
"unavailable"
],
"type": "string",
"description": "resolved when one product matched, ambiguous when several did, otherwise why nothing matched."
},
"matches": {
"type": "array",
"items": {
"type": "object",
"required": [
"canonicalProductId",
"name",
"supplierId",
"supplierProductName",
"url",
"choices"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "The product's page on POD Benchmark."
},
"name": {
"type": "string",
"description": "The product's name."
},
"choices": {
"type": "object",
"description": "What the link selects, ready for compare_product `choices`; empty for the product's usual choice.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"supplierId": {
"type": "string",
"description": "The supplier the link points at."
},
"canonicalProductId": {
"type": "string",
"description": "The product's id, to pass to compare_product."
},
"supplierProductName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The product's name at that supplier; null when unknown."
}
},
"additionalProperties": false
},
"description": "The matched product, or every candidate when ambiguous; empty when nothing matched."
},
"message": {
"type": "string",
"description": "What to do next, in words."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"ok",
"error"
],
"properties": {
"ok": {
"type": "boolean",
"const": false
},
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"enum": [
"invalid_input",
"not_found",
"product_not_found",
"invalid_option",
"comparison_unavailable",
"unavailable",
"rate_limited"
],
"type": "string",
"description": "The machine-readable reason the call failed."
},
"message": {
"type": "string",
"description": "What went wrong, in words, and what to do next."
},
"retryable": {
"type": "boolean",
"description": "Whether calling again could succeed."
}
},
"description": "The error this call returned instead of a result.",
"additionalProperties": false
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
Original tool metadata
{
"name": "resolve_supplier_link",
"title": "Find the product behind a supplier link",
"description": "Use this when a seller pastes a supplier product link (Printify, Printful, Gelato, Prodigi, Apliiq, Artelo, CustomCat, Fourthwall, Inkthreadable or merchOne). Returns the matching POD Benchmark product and any colour the link selects, ready for compare_product with yourSupplier set to that supplier. It never opens the link.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"maxLength": 4096,
"minLength": 1,
"description": "A supplier's product page, such as a Printify or Printful product link."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"oneOf": [
{
"type": "object",
"required": [
"ok",
"status",
"matches",
"message"
],
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"status": {
"enum": [
"resolved",
"ambiguous",
"unsupported",
"no-match",
"configuration-unavailable",
"unavailable"
],
"type": "string",
"description": "resolved when one product matched, ambiguous when several did, otherwise why nothing matched."
},
"matches": {
"type": "array",
"items": {
"type": "object",
"required": [
"canonicalProductId",
"name",
"supplierId",
"supplierProductName",
"url",
"choices"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "The product's page on POD Benchmark."
},
"name": {
"type": "string",
"description": "The product's name."
},
"choices": {
"type": "object",
"description": "What the link selects, ready for compare_product `choices`; empty for the product's usual choice.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"supplierId": {
"type": "string",
"description": "The supplier the link points at."
},
"canonicalProductId": {
"type": "string",
"description": "The product's id, to pass to compare_product."
},
"supplierProductName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The product's name at that supplier; null when unknown."
}
},
"additionalProperties": false
},
"description": "The matched product, or every candidate when ambiguous; empty when nothing matched."
},
"message": {
"type": "string",
"description": "What to do next, in words."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"ok",
"error"
],
"properties": {
"ok": {
"type": "boolean",
"const": false
},
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"enum": [
"invalid_input",
"not_found",
"product_not_found",
"invalid_option",
"comparison_unavailable",
"unavailable",
"rate_limited"
],
"type": "string",
"description": "The machine-readable reason the call failed."
},
"message": {
"type": "string",
"description": "What went wrong, in words, and what to do next."
},
"retryable": {
"type": "boolean",
"description": "Whether calling again could succeed."
}
},
"description": "The error this call returned instead of a result.",
"additionalProperties": false
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
},
"annotations": {
"title": "Find the product behind a supplier link",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description95/100
Use this when a seller asks which print-on-demand suppliers POD Benchmark covers, or needs a supplier id for get_supplier, get_supplier_prices or compare_product. Returns each supplier's id, name, whether it prints orders itself or routes them to print providers, its website and its POD Benchmark profile. Filter by name with query.
The description explains the capability, when to use it, and what to expect.
Inputs83/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
query
Words in the supplier name, such as `print`. Leave empty for all.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
limit
How many results to return.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
offset
How many results to skip. Pass nextOffset from the previous page.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description91/100
Use this when a seller asks how a supplier works: plans and monthly fees, custom branding, who handles checkout, support and refunds, where it prints, or which print providers a marketplace uses. Choose what to return with include: facts (plans, fees, branding, who handles checkout, support and refunds), locations (where it reports printing) or providers (a marketplace's print providers). Facts carry their verification date and sources. Production locations are what the supplier reports, not a promise that a given product ships from there.
The description explains the capability, when to use it, and what to expect.
Inputs79/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
supplierId
The supplier to read, such as printify or gelato. list_suppliers lists them.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
include
facts: plans, fees, branding and who handles what. locations: where it reports printing. providers: a marketplace's print providers.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
country
Only production locations in this country, such as US.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
provider
Only this print provider, by id such as `printify:14`, from the providers list.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
limit
How many results to return.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
offset
How many results to skip. Pass nextOffset from the previous page.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description93/100
Use this when a seller asks how a supplier's prices compare overall, by category, or against one other supplier: how many products it is the cheapest for, where it costs more, and by how much. Uses each product's usual configuration delivered to the destination; checkedAt is when that supplier's prices were last checked. For one product's prices, use compare_product.
The description explains the capability, when to use it, and what to expect.
Inputs92/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
supplierId
The supplier whose prices to rank, such as printify. list_suppliers lists them.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
versus
Compare against this supplier only, instead of every other one.
Clear enough to supply this argument.
category
Only this category, by id from list_categories, such as `mugs`.
Clear enough to supply this argument.
search
Only products matching these words, such as `hoodie`.
Clear enough to supply this argument.
within › oneOf › 0 › kind
Measure closeness as a fixed amount of money.
Clear enough to supply this argument.
within › oneOf › 0 › amount
How far above the cheapest price still counts, in the response currency.
Clear enough to supply this argument.
within › oneOf › 1 › kind
Measure closeness as a share of the cheapest price.
Clear enough to supply this argument.
within › oneOf › 1 › percent
How far above the cheapest price still counts, as a percent of it.
Clear enough to supply this argument.
pricingTier
base is each supplier's standard price; tier1 and tier2 are its paid plans.
Clear enough to supply this argument.
destination
The buyer's country, where the order ships. Product cost, shipping and duty depend on it.
Clear enough to supply this argument.
currency
Currency for every price. Defaults to the destination's own currency.
Clear enough to supply this argument.
limit
How many results to return.
Clear enough to supply this argument.
offset
How many results to skip. Pass nextOffset from the previous page.
Clear enough to supply this argument.
categoryLimit
How many per-category tallies to return. 0 skips them.
Clear enough to supply this argument.
Annotations100/100
All four behavior hints are declared.
{
"title": "Where a supplier is cheapest",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
Output schema90/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"oneOf": [
{
"type": "object",
"required": [
"ok",
"status",
"destination",
"currency",
"checkedAt",
"overview",
"categories",
"cheapest",
"cheaperElsewhere"
],
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"status": {
"enum": [
"ready",
"unavailable"
],
"type": "string",
"description": "ready when prices could be compared, unavailable when not."
},
"cheapest": {
"type": "object",
"required": [
"items",
"totalCount",
"nextOffset"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"canonicalProductId",
"name",
"url",
"option",
"delivered",
"otherDelivered",
"otherSupplier",
"gap"
],
"properties": {
"gap": {
"type": "number",
"description": "How far apart the two delivered prices are, in the response currency, always positive."
},
"url": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
],
"description": "The product's page on POD Benchmark; null when it has none."
},
"name": {
"type": "string",
"description": "The product's name."
},
"option": {
"type": "string",
"description": "The configuration both prices refer to."
},
"delivered": {
"type": "number",
"description": "This supplier's delivered price, product plus shipping, in the response currency."
},
"otherSupplier": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The other supplier's id; null when unknown."
},
"otherDelivered": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The other supplier's delivered price in the response currency; null when unknown."
},
"canonicalProductId": {
"type": "string",
"description": "The product's id, to pass to compare_product."
}
},
"additionalProperties": false
},
"description": "One product each."
},
"nextOffset": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
],
"description": "Offset to pass for the next page; null on the last page."
},
"totalCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many results match in total, across every page."
}
},
"description": "Products where this supplier is cheapest, largest gap first.",
"additionalProperties": false
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "Currency for every price, such as USD, GBP or EUR."
},
"overview": {
"anyOf": [
{
"type": "object",
"required": [
"compared",
"cheapest",
"tied",
"cheaperElsewhere",
"nearCheapest",
"medianWinningGap",
"medianLosingGap"
],
"properties": {
"tied": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many where it ties another supplier as cheapest."
},
"cheapest": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many of them it wins outright, costing less than every other supplier."
},
"compared": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many products were compared."
},
"nearCheapest": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many of those are within the near-cheapest amount."
},
"medianLosingGap": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The typical amount it loses by, in the response currency; null when it never loses."
},
"cheaperElsewhere": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many where another supplier is cheaper."
},
"medianWinningGap": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The typical amount it wins by, in the response currency; null when it never wins."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The comparison across every product; null when unavailable."
},
"checkedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When this supplier's prices were last checked, as an ISO date-time; null when unknown."
},
"categories": {
"type": "array",
"items": {
"type": "object",
"required": [
"compared",
"cheapest",
"tied",
"cheaperElsewhere",
"nearCheapest",
"medianWinningGap",
"medianLosingGap",
"id",
"name"
],
"properties": {
"id": {
"type": "string",
"description": "The category id."
},
"name": {
"type": "string",
"description": "The category's display name."
},
"tied": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many where it ties another supplier as cheapest."
},
"cheapest": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many of them it wins outright, costing less than every other supplier."
},
"compared": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many products were compared."
},
"nearCheapest": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many of those are within the near-cheapest amount."
},
"medianLosingGap": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The typical amount it loses by, in the response currency; null when it never loses."
},
"cheaperElsewhere": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many where another supplier is cheaper."
},
"medianWinningGap": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The typical amount it wins by, in the response currency; null when it never wins."
}
},
"additionalProperties": false
},
"description": "The same counts per category."
},
"destination": {
"enum": [
"US",
"GB",
"DE",
"AU",
"CA"
],
"type": "string",
"description": "The buyer's country these prices are for."
},
"cheaperElsewhere": {
"type": "object",
"required": [
"items",
"totalCount",
"nextOffset"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"canonicalProductId",
"name",
"url",
"option",
"delivered",
"otherDelivered",
"otherSupplier",
"gap"
],
"properties": {
"gap": {
"type": "number",
"description": "How far apart the two delivered prices are, in the response currency, always positive."
},
"url": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
],
"description": "The product's page on POD Benchmark; null when it has none."
},
"name": {
"type": "string",
"description": "The product's name."
},
"option": {
"type": "string",
"description": "The configuration both prices refer to."
},
"delivered": {
"type": "number",
"description": "This supplier's delivered price, product plus shipping, in the response currency."
},
"otherSupplier": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The other supplier's id; null when unknown."
},
"otherDelivered": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The other supplier's delivered price in the response currency; null when unknown."
},
"canonicalProductId": {
"type": "string",
"description": "The product's id, to pass to compare_product."
}
},
"additionalProperties": false
},
"description": "One product each."
},
"nextOffset": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
],
"description": "Offset to pass for the next page; null on the last page."
},
"totalCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many results match in total, across every page."
}
},
"description": "Products where another supplier is cheaper, largest gap first.",
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"ok",
"error"
],
"properties": {
"ok": {
"type": "boolean",
"const": false
},
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"enum": [
"invalid_input",
"not_found",
"product_not_found",
"invalid_option",
"comparison_unavailable",
"unavailable",
"rate_limited"
],
"type": "string",
"description": "The machine-readable reason the call failed."
},
"message": {
"type": "string",
"description": "What went wrong, in words, and what to do next."
},
"retryable": {
"type": "boolean",
"description": "Whether calling again could succeed."
}
},
"description": "The error this call returned instead of a result.",
"additionalProperties": false
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
Original tool metadata
{
"name": "get_supplier_prices",
"title": "Where a supplier is cheapest",
"description": "Use this when a seller asks how a supplier's prices compare overall, by category, or against one other supplier: how many products it is the cheapest for, where it costs more, and by how much. Uses each product's usual configuration delivered to the destination; checkedAt is when that supplier's prices were last checked. For one product's prices, use compare_product.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"supplierId"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1,
"description": "How many results to return."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 100000,
"minimum": 0,
"description": "How many results to skip. Pass nextOffset from the previous page."
},
"search": {
"type": "string",
"default": "",
"maxLength": 200,
"description": "Only products matching these words, such as `hoodie`."
},
"versus": {
"enum": [
"apliiq",
"artelo",
"merchone",
"customcat",
"fourthwall",
"gelato",
"inkthreadable",
"printful",
"printify",
"prodigi"
],
"type": "string",
"description": "Compare against this supplier only, instead of every other one."
},
"within": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"amount"
],
"properties": {
"kind": {
"type": "string",
"const": "amount",
"description": "Measure closeness as a fixed amount of money."
},
"amount": {
"type": "number",
"maximum": 1000,
"minimum": 0,
"description": "How far above the cheapest price still counts, in the response currency."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"percent"
],
"properties": {
"kind": {
"type": "string",
"const": "percent",
"description": "Measure closeness as a share of the cheapest price."
},
"percent": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "How far above the cheapest price still counts, as a percent of it."
}
},
"additionalProperties": false
}
],
"default": {
"kind": "amount",
"amount": 1
},
"description": "How close to the cheapest still counts as near-cheapest."
},
"category": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Only this category, by id from list_categories, such as `mugs`."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "Currency for every price. Defaults to the destination's own currency."
},
"supplierId": {
"enum": [
"apliiq",
"artelo",
"merchone",
"customcat",
"fourthwall",
"gelato",
"inkthreadable",
"printful",
"printify",
"prodigi"
],
"type": "string",
"description": "The supplier whose prices to rank, such as printify. list_suppliers lists them."
},
"destination": {
"enum": [
"US",
"GB",
"DE",
"AU",
"CA"
],
"type": "string",
"default": "US",
"description": "The buyer's country, where the order ships. Product cost, shipping and duty depend on it."
},
"pricingTier": {
"enum": [
"base",
"tier1",
"tier2"
],
"type": "string",
"default": "base",
"description": "base is each supplier's standard price; tier1 and tier2 are its paid plans."
},
"categoryLimit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 0,
"description": "How many per-category tallies to return. 0 skips them."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"oneOf": [
{
"type": "object",
"required": [
"ok",
"status",
"destination",
"currency",
"checkedAt",
"overview",
"categories",
"cheapest",
"cheaperElsewhere"
],
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"status": {
"enum": [
"ready",
"unavailable"
],
"type": "string",
"description": "ready when prices could be compared, unavailable when not."
},
"cheapest": {
"type": "object",
"required": [
"items",
"totalCount",
"nextOffset"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"canonicalProductId",
"name",
"url",
"option",
"delivered",
"otherDelivered",
"otherSupplier",
"gap"
],
"properties": {
"gap": {
"type": "number",
"description": "How far apart the two delivered prices are, in the response currency, always positive."
},
"url": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
],
"description": "The product's page on POD Benchmark; null when it has none."
},
"name": {
"type": "string",
"description": "The product's name."
},
"option": {
"type": "string",
"description": "The configuration both prices refer to."
},
"delivered": {
"type": "number",
"description": "This supplier's delivered price, product plus shipping, in the response currency."
},
"otherSupplier": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The other supplier's id; null when unknown."
},
"otherDelivered": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The other supplier's delivered price in the response currency; null when unknown."
},
"canonicalProductId": {
"type": "string",
"description": "The product's id, to pass to compare_product."
}
},
"additionalProperties": false
},
"description": "One product each."
},
"nextOffset": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
],
"description": "Offset to pass for the next page; null on the last page."
},
"totalCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many results match in total, across every page."
}
},
"description": "Products where this supplier is cheapest, largest gap first.",
"additionalProperties": false
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "Currency for every price, such as USD, GBP or EUR."
},
"overview": {
"anyOf": [
{
"type": "object",
"required": [
"compared",
"cheapest",
"tied",
"cheaperElsewhere",
"nearCheapest",
"medianWinningGap",
"medianLosingGap"
],
"properties": {
"tied": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many where it ties another supplier as cheapest."
},
"cheapest": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many of them it wins outright, costing less than every other supplier."
},
"compared": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many products were compared."
},
"nearCheapest": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many of those are within the near-cheapest amount."
},
"medianLosingGap": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The typical amount it loses by, in the response currency; null when it never loses."
},
"cheaperElsewhere": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many where another supplier is cheaper."
},
"medianWinningGap": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The typical amount it wins by, in the response currency; null when it never wins."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The comparison across every product; null when unavailable."
},
"checkedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When this supplier's prices were last checked, as an ISO date-time; null when unknown."
},
"categories": {
"type": "array",
"items": {
"type": "object",
"required": [
"compared",
"cheapest",
"tied",
"cheaperElsewhere",
"nearCheapest",
"medianWinningGap",
"medianLosingGap",
"id",
"name"
],
"properties": {
"id": {
"type": "string",
"description": "The category id."
},
"name": {
"type": "string",
"description": "The category's display name."
},
"tied": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many where it ties another supplier as cheapest."
},
"cheapest": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many of them it wins outright, costing less than every other supplier."
},
"compared": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many products were compared."
},
"nearCheapest": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many of those are within the near-cheapest amount."
},
"medianLosingGap": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The typical amount it loses by, in the response currency; null when it never loses."
},
"cheaperElsewhere": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many where another supplier is cheaper."
},
"medianWinningGap": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The typical amount it wins by, in the response currency; null when it never wins."
}
},
"additionalProperties": false
},
"description": "The same counts per category."
},
"destination": {
"enum": [
"US",
"GB",
"DE",
"AU",
"CA"
],
"type": "string",
"description": "The buyer's country these prices are for."
},
"cheaperElsewhere": {
"type": "object",
"required": [
"items",
"totalCount",
"nextOffset"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"canonicalProductId",
"name",
"url",
"option",
"delivered",
"otherDelivered",
"otherSupplier",
"gap"
],
"properties": {
"gap": {
"type": "number",
"description": "How far apart the two delivered prices are, in the response currency, always positive."
},
"url": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
],
"description": "The product's page on POD Benchmark; null when it has none."
},
"name": {
"type": "string",
"description": "The product's name."
},
"option": {
"type": "string",
"description": "The configuration both prices refer to."
},
"delivered": {
"type": "number",
"description": "This supplier's delivered price, product plus shipping, in the response currency."
},
"otherSupplier": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The other supplier's id; null when unknown."
},
"otherDelivered": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The other supplier's delivered price in the response currency; null when unknown."
},
"canonicalProductId": {
"type": "string",
"description": "The product's id, to pass to compare_product."
}
},
"additionalProperties": false
},
"description": "One product each."
},
"nextOffset": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
],
"description": "Offset to pass for the next page; null on the last page."
},
"totalCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many results match in total, across every page."
}
},
"description": "Products where another supplier is cheaper, largest gap first.",
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"ok",
"error"
],
"properties": {
"ok": {
"type": "boolean",
"const": false
},
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"enum": [
"invalid_input",
"not_found",
"product_not_found",
"invalid_option",
"comparison_unavailable",
"unavailable",
"rate_limited"
],
"type": "string",
"description": "The machine-readable reason the call failed."
},
"message": {
"type": "string",
"description": "What went wrong, in words, and what to do next."
},
"retryable": {
"type": "boolean",
"description": "Whether calling again could succeed."
}
},
"description": "The error this call returned instead of a result.",
"additionalProperties": false
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
},
"annotations": {
"title": "Where a supplier is cheapest",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description95/100
Use this when a seller is choosing a supplier for a product type (t-shirts, hoodies, mugs, wall art, stickers or phone cases) and their shop: where buyers are, the platform, whether they need custom branding, want to start free, or want to choose their print provider. Returns suppliers that fit, that need a check, and that don't, each with dated reasons and sources, plus a delivered price range for an example product. No AI ranking.
The description explains the capability, when to use it, and what to expect.
Inputs93/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
productType
What the seller wants to sell.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
destination
The buyer's country, where the order ships. Product cost, shipping and duty depend on it.
Clear enough to supply this argument.
salesChannel
Where the seller sells. Leave out if they haven't decided.
Clear enough to supply this argument.
shopLocation
The country the seller's shop is based in, for platform fees. Leave out if they haven't said.
Clear enough to supply this argument.
needsCustomBranding
The seller wants their own branding on packaging, labels or inserts.
Clear enough to supply this argument.
wantsFreeStart
The seller wants to start without a monthly fee.
Clear enough to supply this argument.
wantsToChooseProvider
The seller wants to pick the print provider that makes each order.
Clear enough to supply this argument.
limit
How many results to return.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
offset
How many results to skip. Pass nextOffset from the previous page.
Clear enough to supply this argument.
Annotations100/100
All four behavior hints are declared.
{
"title": "Which suppliers fit a shop",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
Output schema89/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"oneOf": [
{
"type": "object",
"required": [
"ok",
"state",
"productType",
"destination",
"exampleProduct",
"fits",
"needsCheck",
"doesNotFit",
"deliveredRange"
],
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"fits": {
"type": "object",
"required": [
"items",
"totalCount",
"nextOffset"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"supplierId",
"name",
"url",
"reasons"
],
"properties": {
"url": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
],
"description": "The supplier's profile page on POD Benchmark; null when it has none."
},
"name": {
"type": "string",
"description": "The supplier's name."
},
"reasons": {
"type": "array",
"items": {
"type": "object",
"required": [
"status",
"label",
"detail",
"checkedAt",
"source"
],
"properties": {
"label": {
"type": "string",
"description": "The condition, such as monthly fee."
},
"detail": {
"type": "string",
"description": "What the supplier states about it."
},
"source": {
"anyOf": [
{
"type": "object",
"required": [
"label",
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "The source page itself."
},
"label": {
"type": "string",
"description": "What the source is, such as the supplier's pricing page."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Where the answer comes from; null when there is no source."
},
"status": {
"type": "string",
"description": "met when the condition holds, qualified when it holds with conditions, unknown when unconfirmed, blocked when it fails."
},
"checkedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When it was checked, as an ISO date-time; null when unknown."
}
},
"additionalProperties": false
},
"description": "Why it fits, needs a check or does not fit."
},
"supplierId": {
"type": "string",
"description": "The supplier's id."
}
},
"additionalProperties": false
},
"description": "One supplier each."
},
"nextOffset": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
],
"description": "Offset to pass for the next page; null on the last page."
},
"totalCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many results match in total, across every page."
}
},
"description": "Suppliers that fit the shop.",
"additionalProperties": false
},
"state": {
"type": "string",
"description": "ready when suppliers were assessed; coverage-unknown when no product data covers this choice."
},
"doesNotFit": {
"type": "object",
"required": [
"items",
"totalCount",
"nextOffset"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"supplierId",
"name",
"url",
"reasons"
],
"properties": {
"url": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
],
"description": "The supplier's profile page on POD Benchmark; null when it has none."
},
"name": {
"type": "string",
"description": "The supplier's name."
},
"reasons": {
"type": "array",
"items": {
"type": "object",
"required": [
"status",
"label",
"detail",
"checkedAt",
"source"
],
"properties": {
"label": {
"type": "string",
"description": "The condition, such as monthly fee."
},
"detail": {
"type": "string",
"description": "What the supplier states about it."
},
"source": {
"anyOf": [
{
"type": "object",
"required": [
"label",
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "The source page itself."
},
"label": {
"type": "string",
"description": "What the source is, such as the supplier's pricing page."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Where the answer comes from; null when there is no source."
},
"status": {
"type": "string",
"description": "met when the condition holds, qualified when it holds with conditions, unknown when unconfirmed, blocked when it fails."
},
"checkedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When it was checked, as an ISO date-time; null when unknown."
}
},
"additionalProperties": false
},
"description": "Why it fits, needs a check or does not fit."
},
"supplierId": {
"type": "string",
"description": "The supplier's id."
}
},
"additionalProperties": false
},
"description": "One supplier each."
},
"nextOffset": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
],
"description": "Offset to pass for the next page; null on the last page."
},
"totalCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many results match in total, across every page."
}
},
"description": "Suppliers that do not fit.",
"additionalProperties": false
},
"needsCheck": {
"type": "object",
"required": [
"items",
"totalCount",
"nextOffset"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"supplierId",
"name",
"url",
"reasons"
],
"properties": {
"url": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
],
"description": "The supplier's profile page on POD Benchmark; null when it has none."
},
"name": {
"type": "string",
"description": "The supplier's name."
},
"reasons": {
"type": "array",
"items": {
"type": "object",
"required": [
"status",
"label",
"detail",
"checkedAt",
"source"
],
"properties": {
"label": {
"type": "string",
"description": "The condition, such as monthly fee."
},
"detail": {
"type": "string",
"description": "What the supplier states about it."
},
"source": {
"anyOf": [
{
"type": "object",
"required": [
"label",
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "The source page itself."
},
"label": {
"type": "string",
"description": "What the source is, such as the supplier's pricing page."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Where the answer comes from; null when there is no source."
},
"status": {
"type": "string",
"description": "met when the condition holds, qualified when it holds with conditions, unknown when unconfirmed, blocked when it fails."
},
"checkedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When it was checked, as an ISO date-time; null when unknown."
}
},
"additionalProperties": false
},
"description": "Why it fits, needs a check or does not fit."
},
"supplierId": {
"type": "string",
"description": "The supplier's id."
}
},
"additionalProperties": false
},
"description": "One supplier each."
},
"nextOffset": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
],
"description": "Offset to pass for the next page; null on the last page."
},
"totalCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many results match in total, across every page."
}
},
"description": "Suppliers that might fit but need something confirmed first.",
"additionalProperties": false
},
"destination": {
"enum": [
"US",
"GB",
"DE",
"AU",
"CA"
],
"type": "string",
"description": "The buyer's country these prices are for."
},
"productType": {
"type": "string",
"description": "The product type the guide answers for."
},
"deliveredRange": {
"anyOf": [
{
"type": "object",
"required": [
"minimum",
"maximum",
"currency"
],
"properties": {
"maximum": {
"type": "number",
"description": "The highest delivered price, in this currency."
},
"minimum": {
"type": "number",
"description": "The lowest delivered price, in this currency."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "The currency of this range."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The delivered price range across the suppliers that fit; null when unavailable."
},
"exampleProduct": {
"anyOf": [
{
"type": "object",
"required": [
"canonicalProductId",
"name",
"option",
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "The example product's comparison page on POD Benchmark."
},
"name": {
"type": "string",
"description": "The example product's name."
},
"option": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The configuration the prices refer to; null when none."
},
"canonicalProductId": {
"type": "string",
"description": "The example product's id, to pass to compare_product."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The product the delivered prices refer to; null when none."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"ok",
"error"
],
"properties": {
"ok": {
"type": "boolean",
"const": false
},
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"enum": [
"invalid_input",
"not_found",
"product_not_found",
"invalid_option",
"comparison_unavailable",
"unavailable",
"rate_limited"
],
"type": "string",
"description": "The machine-readable reason the call failed."
},
"message": {
"type": "string",
"description": "What went wrong, in words, and what to do next."
},
"retryable": {
"type": "boolean",
"description": "Whether calling again could succeed."
}
},
"description": "The error this call returned instead of a result.",
"additionalProperties": false
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
Original tool metadata
{
"name": "supplier_guide",
"title": "Which suppliers fit a shop",
"description": "Use this when a seller is choosing a supplier for a product type (t-shirts, hoodies, mugs, wall art, stickers or phone cases) and their shop: where buyers are, the platform, whether they need custom branding, want to start free, or want to choose their print provider. Returns suppliers that fit, that need a check, and that don't, each with dated reasons and sources, plus a delivered price range for an example product. No AI ranking.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1,
"description": "How many results to return."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 100000,
"minimum": 0,
"description": "How many results to skip. Pass nextOffset from the previous page."
},
"destination": {
"enum": [
"US",
"GB",
"DE",
"AU",
"CA"
],
"type": "string",
"default": "US",
"description": "The buyer's country, where the order ships. Product cost, shipping and duty depend on it."
},
"productType": {
"enum": [
"t-shirts",
"hoodies",
"mugs",
"wall-art",
"stickers",
"phone-cases"
],
"type": "string",
"default": "t-shirts",
"description": "What the seller wants to sell."
},
"salesChannel": {
"enum": [
"etsy",
"shopify",
"woocommerce",
"tiktok-shop"
],
"type": "string",
"description": "Where the seller sells. Leave out if they haven't decided."
},
"shopLocation": {
"enum": [
"US",
"GB",
"DE",
"AU",
"CA"
],
"type": "string",
"description": "The country the seller's shop is based in, for platform fees. Leave out if they haven't said."
},
"wantsFreeStart": {
"type": "boolean",
"default": false,
"description": "The seller wants to start without a monthly fee."
},
"needsCustomBranding": {
"type": "boolean",
"default": false,
"description": "The seller wants their own branding on packaging, labels or inserts."
},
"wantsToChooseProvider": {
"type": "boolean",
"default": false,
"description": "The seller wants to pick the print provider that makes each order."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"oneOf": [
{
"type": "object",
"required": [
"ok",
"state",
"productType",
"destination",
"exampleProduct",
"fits",
"needsCheck",
"doesNotFit",
"deliveredRange"
],
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"fits": {
"type": "object",
"required": [
"items",
"totalCount",
"nextOffset"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"supplierId",
"name",
"url",
"reasons"
],
"properties": {
"url": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
],
"description": "The supplier's profile page on POD Benchmark; null when it has none."
},
"name": {
"type": "string",
"description": "The supplier's name."
},
"reasons": {
"type": "array",
"items": {
"type": "object",
"required": [
"status",
"label",
"detail",
"checkedAt",
"source"
],
"properties": {
"label": {
"type": "string",
"description": "The condition, such as monthly fee."
},
"detail": {
"type": "string",
"description": "What the supplier states about it."
},
"source": {
"anyOf": [
{
"type": "object",
"required": [
"label",
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "The source page itself."
},
"label": {
"type": "string",
"description": "What the source is, such as the supplier's pricing page."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Where the answer comes from; null when there is no source."
},
"status": {
"type": "string",
"description": "met when the condition holds, qualified when it holds with conditions, unknown when unconfirmed, blocked when it fails."
},
"checkedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When it was checked, as an ISO date-time; null when unknown."
}
},
"additionalProperties": false
},
"description": "Why it fits, needs a check or does not fit."
},
"supplierId": {
"type": "string",
"description": "The supplier's id."
}
},
"additionalProperties": false
},
"description": "One supplier each."
},
"nextOffset": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
],
"description": "Offset to pass for the next page; null on the last page."
},
"totalCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many results match in total, across every page."
}
},
"description": "Suppliers that fit the shop.",
"additionalProperties": false
},
"state": {
"type": "string",
"description": "ready when suppliers were assessed; coverage-unknown when no product data covers this choice."
},
"doesNotFit": {
"type": "object",
"required": [
"items",
"totalCount",
"nextOffset"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"supplierId",
"name",
"url",
"reasons"
],
"properties": {
"url": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
],
"description": "The supplier's profile page on POD Benchmark; null when it has none."
},
"name": {
"type": "string",
"description": "The supplier's name."
},
"reasons": {
"type": "array",
"items": {
"type": "object",
"required": [
"status",
"label",
"detail",
"checkedAt",
"source"
],
"properties": {
"label": {
"type": "string",
"description": "The condition, such as monthly fee."
},
"detail": {
"type": "string",
"description": "What the supplier states about it."
},
"source": {
"anyOf": [
{
"type": "object",
"required": [
"label",
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "The source page itself."
},
"label": {
"type": "string",
"description": "What the source is, such as the supplier's pricing page."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Where the answer comes from; null when there is no source."
},
"status": {
"type": "string",
"description": "met when the condition holds, qualified when it holds with conditions, unknown when unconfirmed, blocked when it fails."
},
"checkedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When it was checked, as an ISO date-time; null when unknown."
}
},
"additionalProperties": false
},
"description": "Why it fits, needs a check or does not fit."
},
"supplierId": {
"type": "string",
"description": "The supplier's id."
}
},
"additionalProperties": false
},
"description": "One supplier each."
},
"nextOffset": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
],
"description": "Offset to pass for the next page; null on the last page."
},
"totalCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many results match in total, across every page."
}
},
"description": "Suppliers that do not fit.",
"additionalProperties": false
},
"needsCheck": {
"type": "object",
"required": [
"items",
"totalCount",
"nextOffset"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"supplierId",
"name",
"url",
"reasons"
],
"properties": {
"url": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
],
"description": "The supplier's profile page on POD Benchmark; null when it has none."
},
"name": {
"type": "string",
"description": "The supplier's name."
},
"reasons": {
"type": "array",
"items": {
"type": "object",
"required": [
"status",
"label",
"detail",
"checkedAt",
"source"
],
"properties": {
"label": {
"type": "string",
"description": "The condition, such as monthly fee."
},
"detail": {
"type": "string",
"description": "What the supplier states about it."
},
"source": {
"anyOf": [
{
"type": "object",
"required": [
"label",
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "The source page itself."
},
"label": {
"type": "string",
"description": "What the source is, such as the supplier's pricing page."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Where the answer comes from; null when there is no source."
},
"status": {
"type": "string",
"description": "met when the condition holds, qualified when it holds with conditions, unknown when unconfirmed, blocked when it fails."
},
"checkedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When it was checked, as an ISO date-time; null when unknown."
}
},
"additionalProperties": false
},
"description": "Why it fits, needs a check or does not fit."
},
"supplierId": {
"type": "string",
"description": "The supplier's id."
}
},
"additionalProperties": false
},
"description": "One supplier each."
},
"nextOffset": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
],
"description": "Offset to pass for the next page; null on the last page."
},
"totalCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many results match in total, across every page."
}
},
"description": "Suppliers that might fit but need something confirmed first.",
"additionalProperties": false
},
"destination": {
"enum": [
"US",
"GB",
"DE",
"AU",
"CA"
],
"type": "string",
"description": "The buyer's country these prices are for."
},
"productType": {
"type": "string",
"description": "The product type the guide answers for."
},
"deliveredRange": {
"anyOf": [
{
"type": "object",
"required": [
"minimum",
"maximum",
"currency"
],
"properties": {
"maximum": {
"type": "number",
"description": "The highest delivered price, in this currency."
},
"minimum": {
"type": "number",
"description": "The lowest delivered price, in this currency."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"CAD"
],
"type": "string",
"description": "The currency of this range."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The delivered price range across the suppliers that fit; null when unavailable."
},
"exampleProduct": {
"anyOf": [
{
"type": "object",
"required": [
"canonicalProductId",
"name",
"option",
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "The example product's comparison page on POD Benchmark."
},
"name": {
"type": "string",
"description": "The example product's name."
},
"option": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The configuration the prices refer to; null when none."
},
"canonicalProductId": {
"type": "string",
"description": "The example product's id, to pass to compare_product."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The product the delivered prices refer to; null when none."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"ok",
"error"
],
"properties": {
"ok": {
"type": "boolean",
"const": false
},
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"enum": [
"invalid_input",
"not_found",
"product_not_found",
"invalid_option",
"comparison_unavailable",
"unavailable",
"rate_limited"
],
"type": "string",
"description": "The machine-readable reason the call failed."
},
"message": {
"type": "string",
"description": "What went wrong, in words, and what to do next."
},
"retryable": {
"type": "boolean",
"description": "Whether calling again could succeed."
}
},
"description": "The error this call returned instead of a result.",
"additionalProperties": false
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
},
"annotations": {
"title": "Which suppliers fit a shop",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}
Loading score analytics…
Put your MCP to the test
A few tasks worth trying with this server, chosen from its reviewed tools. These have not been run.
01Search POD Benchmark productsUse this when a seller wants to find a print-on-demand (POD) product to compare across suppliers such as Printify, Printful, Gelato, Prodigi, Apliiq, Artelo,…
02List product categoriesUse this when a seller wants to browse what POD Benchmark compares, or needs a category id to narrow search_products.
03List suppliersUse this when a seller asks which print-on-demand suppliers POD Benchmark covers, or needs a supplier id for get_supplier, get_supplier_prices or compare_pro…
04Which suppliers fit a shopUse this when a seller is choosing a supplier for a product type (t-shirts, hoodies, mugs, wall art, stickers or phone cases) and their shop: where buyers ar…
05Read a supplier's factsUse this when a seller asks how a supplier works: plans and monthly fees, custom branding, who handles checkout, support and refunds, where it prints, or whi…
Want to run these tasks against your MCP server with us?
POD Benchmark setup, tools, quality score, publishing readiness, and alternatives.
How do I add POD Benchmark to Claude, ChatGPT, or Cursor?
Add POD Benchmark to Claude, ChatGPT, or Cursor by connecting its remote MCP URL in each client's MCP settings. In Claude, add a custom connector. In ChatGPT, add an MCP app. In Cursor, add an MCP server under Settings. The MCP URL is https://podbenchmark.com/api/mcp.
Is POD Benchmark MCP ready for ChatGPT and Claude?
As of November 17, 2026, POD Benchmark scores 100/100 on Manufact's MCP publishing checklist. The scan meets ChatGPT publishing checks and meets Claude publishing checks. Passing these checks does not guarantee marketplace approval.
How clear is POD Benchmark's MCP tool documentation?
As of November 17, 2026, POD Benchmark scores 93/100 in Manufact's review of tool titles, descriptions, input and output schemas, and behavior annotations. The review covers 10 of 10 discovered tools. The quality score measures documentation clarity; runtime behavior and marketplace readiness require separate checks.
What are the best alternatives to POD Benchmark?
As of November 17, 2026, alternatives to POD Benchmark in commerce-shopping on the Manufact MCP leaderboard include REMAX Europe, Product Hunt, Square Yards, eno.vn Partner API, and HLPlanet Keyboard Sizes.
Not your MCP?
Review any public or OAuth MCP server for protocol compatibility, tool documentation, and ChatGPT and Claude publishing readiness. No account required.