Sign inGet a free API keyDashboard
Menu

APIs / Marketplaces / Wayfair

1 credit per call5 endpoints19 datapoints

Wayfair API

Wayfair API for furniture and home product search, category listings, product details and reviews in the US, Canada and UK as JSON. 1 credit per call.

Get a free API keyRun it below
Wayfair
GET/v1/wayfair/search?query=sofa
{
  "success": true,
  "data": {
    "query": "sofa",
    "pagination": {
      "page": 1,
      "per_page": 48,
      "total": 262340,
      "total_pages": 5466,
      "has_next_page": true
    },
    "sort": "recommended",
    "category_url": "https://www.wayfair.com/furniture/sb0/sofas-c413892.html",
    "products": [
      {
        "position": 1,
        "sku": "W006759421",
        "variant_id": "BQ04011156",
        "title": "Barton 80.31'' Faux Leather Square Arm Sofa",
        "brand": "Ebern Designs",
        "url": "https://www.wayfair.com/furniture/pdp/ebern-designs-barton-8031-faux-leather-square-arm-sofa-w006759421.html",
        "price": {
          "amount": 415.99,
          "currency": "USD"
        },
        "original_price": {
          "amount": 699.99,
          "currency": "USD"
        },
        "on_sale": true,
        "savings_percent": 41,
        "rating": 4.48,
        "review_count": 1463,
        "image_urls": [
          "https://assets.wfcdn.com/im/00000000/resize-h800-w800%5Ecompr-r85/4306/430660494/image.jpg",
          "https://assets.wfcdn.com/im/00000000/resize-h800-w800%5Ecompr-r85/3705/370591211/image.jpg"
        ],
        "flag": "Early Black Friday",
        "is_best_value": true,
        "delivery": {
          "promise": "FREE 1-Day Delivery",
          "estimated_arrival": "Get it Tomorrow"
        },
        "stock_message": "619 Left in Stock",
        "selected_options": [
          {
            "name": "Upholstery Color",
            "value": "Chestnut Performance Faux Leather"
          }
        ],
        "sponsored": true
      },
      {
        "position": 2,
        "sku": "W008221555",
        "variant_id": "AG38006862",
        "title": "Carmencita 65\" Linen Upholstered Square Arm Loveseat",
        "brand": "Wade Logan®",
        "url": "https://www.wayfair.com/furniture/pdp/wade-logan-carmencita-65-linen-upholstered-square-arm-loveseat-w008221555.html",
        "price": {
          "amount": 319.99,
          "currency": "USD"
        },
        "original_price": {
          "amount": 460,
          "currency": "USD"
        },
        "on_sale": true,
        "savings_percent": 30,
        "rating": 4.51,
        "review_count": 1965,
        "image_urls": [
          "https://assets.wfcdn.com/im/00000000/resize-h800-w800%5Ecompr-r85/2473/247335722/image.jpg",
          "https://assets.wfcdn.com/im/00000000/resize-h800-w800%5Ecompr-r85/3743/374335315/image.jpg"
        ],
        "flag": "Early Black Friday",
        "is_best_value": true,
        "delivery": {
          "promise": "FREE 1-Day Delivery",
          "estimated_arrival": "Get it Tomorrow"
        },
        "stock_message": "820 Left in Stock",
        "selected_options": [
          {
            "name": "Upholstery Color",
            "value": "Gray Linen"
          },
          {
            "name": "Support",
            "value": "Solid Wood"
          }
        ],
        "sponsored": true
      },
      {
        "position": 3,
        "sku": "W118436057",
        "variant_id": "QC80853726",
        "title": "108\" Cloud L-Shaped Modular Sectional Sofa, 2 Washable Cover Sets with Ottoman, Oversized Deep Seat Living Room Couch for DIY Color Switch, Boneless Style (White & Grey)",
        "brand": "Latitude Run®",
        "url": "https://www.wayfair.com/furniture/pdp/latitude-run-boneless-108-boneless-cloud-modular-sectional-sofa-with-2-washable-cover-sets-l-shape-deep-seat-couch-with-ottoman-toss-pillows-oversized-comfy-living-room-sofa-diy-color-refresh-white-grey…",
        "price": {
          "amount": 869.99,
          "currency": "USD"
        },
        "original_price": {
          "amount": 1899.99,
          "currency": "USD"
        },
        "on_sale": true,
        "savings_percent": 54,
        "rating": 4.15,
        "review_count": 99,
        "image_urls": [
          "https://assets.wfcdn.com/im/00000000/resize-h800-w800%5Ecompr-r85/4955/495561351/image.jpg",
          "https://assets.wfcdn.com/im/00000000/resize-h800-w800%5Ecompr-r85/4944/494417986/image.jpg"
        ],
        "flag": "Buy More, Save More",
        "is_best_value": false,
        "delivery": {
          "promise": "FREE Fast Delivery",
          "estimated_arrival": "Get it by Mon, Nov 16"
        },
        "stock_message": "136 Left in Stock",
        "selected_options": [
          {
            "name": "Upholstery Material",
            "value": "White/Gray"
          }
        ],
        "sponsored": true
      }
    ],
    "filters": [
      {
        "id": "69278",
        "name": "Sale",
        "type": "options",
        "options": [
          {
            "id": "8",
            "name": "Sale",
            "selected": false,
            "enabled": true
          }
        ]
      },
      {
        "id": "1234567890",
        "name": "Fast Delivery",
        "type": "options",
        "options": [
          {
            "id": "2147483646",
            "name": "Fast Delivery",
            "selected": false,
            "enabled": true
          }
        ]
      },
      {
        "id": "160734",
        "name": "Wayfair Verified",
        "type": "options",
        "options": [
          {
            "id": "579585",
            "name": "Wayfair Verified",
            "selected": false,
            "enabled": true
          }
        ]
      }
    ]
  },
  "meta": {
    "endpoint_family": "search",
    "request_id": "req_bcf29e822d57479191b3a2ea2a6544cd",
    "credits_charged": 1,
    "credits_remaining": 1944
  }
}
200 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.

Sample data

What one call returns

A recorded run of search: the fields and shapes you will get, shortened to 3 items.

#positionintegerskustringvariant_idstringtitlestringbrandstringurlurlpriceobjectoriginal_priceobjecton_salebooleansavings_percentintegerratingnumberreview_countintegerimage_urlsstring[]flagstringis_best_valuebooleandeliveryobjectstock_messagestringselected_optionsobject[]sponsoredboolean
11W006759421BQ04011156Barton 80.31'' Faux Leather Square Arm SofaEbern Designshttps://www.wayfair.com/furniture/pdp/ebern-designs-barton-8031-faux-leather-square-arm-sofa-w006759421.html{2 fields}{2 fields}true414.481463[2 items]Early Black Fridaytrue{2 fields}619 Left in Stock[1 item]true
22W008221555AG38006862Carmencita 65" Linen Upholstered Square Arm LoveseatWade Logan®https://www.wayfair.com/furniture/pdp/wade-logan-carmencita-65-linen-upholstered-square-arm-loveseat-w008221555.html{2 fields}{2 fields}true304.511965[2 items]Early Black Fridaytrue{2 fields}820 Left in Stock[2 items]true
33W118436057QC80853726108" Cloud L-Shaped Modular Sectional Sofa, 2 Washable Cover Sets with Ottoman, Oversized Deep Seat Living Room Couch for DIY Color Switch, Boneless Style (White & Grey)Latitude Run®https://www.wayfair.com/furniture/pdp/latitude-run-boneless-108-boneless-cloud-modular-sectional-sofa-with-2-washable-cover-sets-l-shape-deep-seat-couch-with-ottoman-toss-pillows-oversized-comfy-living-room-sofa-diy-color-refresh-white-grey…{2 fields}{2 fields}true544.1599[2 items]Buy More, Save Morefalse{2 fields}136 Left in Stock[1 item]true

Recorded from our API · 3 items shown · 19 datapoints per itemGET /v1/wayfair/search?query=sofa

19 datapoints

Identity

  • skustring
  • variant_idstring
  • titlestring
  • brandstring

Contact

  • urlurl
  • image_urlsstring[]

Reputation

  • ratingnumber
  • review_countinteger

Price

  • priceobject
  • original_priceobject

Other

  • positioninteger
  • on_saleboolean
  • savings_percentinteger
  • flagstring
  • is_best_valueboolean
  • deliveryobject
  • stock_messagestring
  • selected_optionsobject[]
  • sponsoredboolean

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/wayfair/search?query=sofa" \
  -H "X-API-Key: $API_KEY"

Wayfair · 5 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/wayfair/autocomplete
query+1 optional
1 credit
GET/v1/wayfair/category
none+8 optional
1 credit
GET/v1/wayfair/product
none+4 optional
1 credit
GET/v1/wayfair/reviews
variant_id+7 optional
1 credit
GET/v1/wayfair/search
query+2 optional
1 credit

Overview

What you can get

The Wayfair API returns Wayfair product data as JSON through 5 endpoints. Each takes a domain of com, ca or co.uk.

  • Search: search takes a query, with page. autocomplete takes a partial query.
  • Categories: category takes a category_id or a category url, with page, filters, price_min, price_max and sort (recommended, price_asc, price_desc, rating, most_purchased, biggest_savings, popularity, total_price_asc or total_price_desc).
  • Products: product takes a sku or a product url, with option_ids.
  • Reviews: reviews takes a variant_id, with limit, cursor, ratings, aspects, search and sort (RELEVANCE_DESC, HELPFULNESS_DESC, RATING_DESC, RATING_ASC, DATE_DESC or PHOTOS_COUNT_DESC).

The recorded search for "sofa" returns products, each with position, sku, variant_id, title, brand, url, price and original_price (amount and currency), on_sale, savings_percent, rating, review_count, image_urls, delivery, stock_message, selected_options and sponsored. It also returns pagination with total (262,340 in that recording), total_pages and has_next_page, the category_url the search maps to, and filters.

How a call works

Search, then look up: GET /v1/wayfair/search?query=sofa with your key in the X-API-Key header returns each product's sku and variant_id; product takes the sku and reviews takes the variant_id. To page a category instead, send GET /v1/wayfair/category?category_id=413892&sort=price_asc. Check has_next_page before asking for the next page. Every successful call costs 1 credit; failed calls cost nothing.

MarketplacesJSONRESTMCP

More marketplaces APIs

About YouadidasAliExpressAllegroAmazonASOSBilliger.debol.comChrono24CostcoCraigslistDBA

Use cases

Track Wayfair prices and sale discounts for a product list

Use the Wayfair API to track Wayfair prices and sale discounts for a product list

Compare prices across the US, Canada and UK sites with `domain`

Use the Wayfair API to compare prices across the US, Canada and UK sites with `domain`

Rank a category by biggest savings or most purchased

Use the Wayfair API to rank a category by biggest savings or most purchased

Watch stock messages and delivery promises for products

Use the Wayfair API to watch stock messages and delivery promises for products

FAQ

Questions

How much does the Wayfair API cost?

Each successful call costs one credit, and each search or category page is one call. New accounts get free credits to start, and credit packs bring the price down as you scale.

Which Wayfair sites can I query?

Wayfair in the US, Canada and the UK: pass `domain` as com, ca or co.uk.

Do I need a Wayfair account?

No. You call this Wayfair API with your Perceptlayer key in the `X-API-Key` header, with no Wayfair login.

What format are responses in?

Every endpoint returns JSON, with no HTML parsing on your side.

Should I build a Wayfair scraper instead?

You can, but a Wayfair scraper is code you maintain: page changes break it, requests get blocked, and Wayfair's terms govern how you collect data. The Wayfair API gives you 5 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first.

Try the Wayfair API with 100 free credits

No credit card. Failed calls are never billed.

Get a free API keyRead the docs