wayfair-api

Installation
SKILL.md

Wayfair API - Product Prices, Sale and Was Price, Reviews, Delivery

Read Wayfair product data on wayfair.com, wayfair.ca (English or French), wayfair.co.uk and wayfair.ie, and on Wayfair's US banner sites AllModern, Birch Lane, Joss & Main and Perigold: keyword search and category listings with Wayfair's own sorts and filters, one product in full by SKU or link (every option, the price and stock of one option, the review summary and a delivery estimate to a ZIP or postal code), and the market's current sale events. All 4 endpoints return structured JSON and cost 1 credit each.

The job this skill is for: Wayfair price history. Wayfair shows no price history on its pages, and Wayfair's terms state "We do not price match", so shoppers and pricing teams watch prices themselves. Build the history by polling: read price, sale_price, was_price, price_label and badge for the same SKU (and the same option_id) on a schedule, store each reading with its time, and compare runs. Captured 2026-11-14 for the Shiflett Oriental area rug, SKU W005006988, on wayfair.com:

Field Value
price USD 82.99
sale_price USD 82.99
was_price USD 197.99
price_label Sale
percent_off 58
badge Early Black Friday

What the was price and the Sale label mean, in Wayfair's own words. was_price is the strikethrough price on the page. Wayfair's US terms ("About Our Prices") state: "Where a product listing on our Sites references a higher price, typically denoted by a strikethrough (e.g. '$549'), such higher price represents the retail price suggested by the manufacturer or supplier. In the absence of a price suggested by the manufacturer or supplier, this price represents the highest price at which we offered or sold the product at some point in the past." On the Sale tag: "The 'Sale' tag on a product listing on our Sites signifies that we are selling the product at a discount from a price in the previous 90 days." So was_price is not yesterday's price, and a percent off against it is not a measured price drop. To tell whether a price really fell, compare your own stored readings.

Wayfair's APIs are for its suppliers (orders, inventory and catalog through Partner Home). Wayfair publishes no public API for its catalog, prices or reviews.

Installs
2
GitHub Stars
73
First Seen
Today