changedOutput schema / description
Previous value: -"One row per distinct identifier, in the order sent. A row is a catalogue fact, not an offer: it says whether WEM holds the product and what the lowest price is, and links to WEM’s product page. Call compare_offers with product.slug for the retailer offers and their links."New value: +"One row per distinct identifier, in the order sent. A row is a catalogue fact, not the full offer list: it says whether WEM holds the product and what the lowest price is, links to WEM’s product page, and gives the shop’s link for each price it quotes (`lowPriceLink`, `marketplaceLowLink`). compare_offers with product.slug lists every retailer offer and its link."
changedOutput schema / properties / links / description
Previous value: -"The WEM product-page links for found rows, pre-formatted to quote. Give these to the user when you name a found product."New value: +"Lines to give the user, pre-formatted. First the prices the rows quote, each with the retailer page it was read on (the rows’ `lowPriceLink`, cheapest first, then any `marketplaceLowLink`, a seller’s price and not a retail floor). Then one line per found product to WEM’s product page, which lists every retailer WEM holds and carries no price. Give the price’s own line when you name a price; a retailer URL found elsewhere may be a different listing or price."
addedOutput schema / properties / links / items / properties / affiliate
Added value: +{
+ "description": "False when this link earns WEM nothing: the shop has no affiliate programme with WEM, or this link does not carry one. It is still a real offer, and its link is not affiliate-tracked. Absent (or true) means the link is affiliate-tracked. `disclosure` states whether all, some or none of the links are tracked.",
+ "type": "boolean"
+}
addedOutput schema / properties / links / items / properties / currency
Added value: +{
+ "type": "string"
+}
addedOutput schema / properties / links / items / properties / input / description
Added value: +"The identifier of the row this line belongs to."
addedOutput schema / properties / links / items / properties / markdown / description
Added value: +"The same link as `[Title at Retailer — £0.00](url)`, or `[Title on WEM](url)` for a product page."
addedOutput schema / properties / links / items / properties / price
Added value: +{
+ "description": "Present on a price’s line. A WEM product-page line has none.",
+ "type": "number"
+}
addedOutput schema / properties / links / items / properties / provider
Added value: +{
+ "description": "Present on a price’s line: the shop’s key, as WEM’s other tools give it.",
+ "type": "string"
+}
addedOutput schema / properties / links / items / properties / retailer
Added value: +{
+ "description": "Present on a price’s line: the retailer quoting it.",
+ "type": "string"
+}
addedOutput schema / properties / links / items / properties / url / description
Added value: +"A price’s line: WEM tracked link to the page that price was read on. A product-page line: WEM’s page for the product. The full URL; a shortened or rewritten form is a different link."
addedOutput schema / properties / results / items / properties / lowPriceLink
Added value: +{
+ "description": "The retailer page for lowPrice: that offer’s retailer, price and WEM tracked link. Present beside a lowPrice WEM holds a link for; absent when lowPrice is null. A retailer URL found elsewhere may be a different listing or price.",
+ "properties": {
+ "affiliate": {
+ "description": "False when this link earns WEM nothing: the shop has no affiliate programme with WEM, or this link does not carry one. It is still a real offer, and its link is not affiliate-tracked. Absent (or true) means the link is affiliate-tracked. `disclosure` states whether all, some or none of the links are tracked.",
+ "type": "boolean"
+ },
+ "currency": {
+ "type": "string"
+ },
+ "markdown": {
+ "description": "The same link as `[Retailer — £0.00](url)`, for hosts rendering markdown.",
+ "type": "string"
+ },
+ "price": {
+ "type": "number"
+ },
+ "provider": {
+ "description": "The shop’s key, as WEM’s other tools give it.",
+ "type": "string"
+ },
+ "retailer": {
+ "type": "string"
+ },
+ "url": {
+ "description": "WEM tracked link to the page this price was read on. The full URL; a shortened or rewritten form is a different link.",
+ "type": "string"
+ }
+ },
+ "type": "object"
+}
addedOutput schema / properties / results / items / properties / lowPriceRetailer / description
Added value: +"The named retailer quoting lowPrice. Its link is lowPriceLink."
addedOutput schema / properties / results / items / properties / marketplaceLowLink
Added value: +{
+ "description": "The listing for marketplaceLowPrice: its seller’s marketplace, price and WEM tracked link. A seller’s price, not a retail floor, like marketplaceLowPrice.",
+ "properties": {
+ "affiliate": {
+ "description": "False when this link earns WEM nothing: the shop has no affiliate programme with WEM, or this link does not carry one. It is still a real offer, and its link is not affiliate-tracked. Absent (or true) means the link is affiliate-tracked. `disclosure` states whether all, some or none of the links are tracked.",
+ "type": "boolean"
+ },
+ "currency": {
+ "type": "string"
+ },
+ "markdown": {
+ "description": "The same link as `[Retailer — £0.00](url)`, for hosts rendering markdown.",
+ "type": "string"
+ },
+ "price": {
+ "type": "number"
+ },
+ "provider": {
+ "description": "The shop’s key, as WEM’s other tools give it.",
+ "type": "string"
+ },
+ "retailer": {
+ "type": "string"
+ },
+ "url": {
+ "description": "WEM tracked link to the page this price was read on. The full URL; a shortened or rewritten form is a different link.",
+ "type": "string"
+ }
+ },
+ "type": "object"
+}