Wayfair

Search Wayfair by keyword: sku, name, brand, price, list price, rating, review count, stock, link and image, about 600,000 results per credit. Sort by price or rating and filter to sale items. There is no product lookup by sku.

Embed
Preview of the card
<a href="https://scrapelyserp.com/docs/wayfair-products"><img src="https://scrapelyserp.com/docs/_api/public/orgs/affc5b0f-d3c2-423a-8143-9d10db5736ae/spaces/981e6275-da3f-446c-82de-889f59c83b6f/pages/6299fd59-55a1-4f86-8445-9edc6d2de5b2/social-card.svg?v=3e7ae33eec8b" alt="Wayfair" width="600" height="315"></a>

Search Wayfair by keyword: sku, name, brand, price, list price, rating, review count, stock, link and image, about 600,000 results per credit. Sort by price or rating and filter to sale items. There is no product lookup by sku.

At a glance

Property

Value

platform

wayfair

Marketplaces

Live: us.

Search

GET /v1/structured/wayfair/search by keyword, up to 100 results per request (48 by default), about 600,000 results per credit (an estimate until production traffic measures it).

Typical call

2–8 s for a page of 48

Product lookup

Not available. POST /v1/products does not take wayfair: no way to look a product up by sku exists, so the data comes from search. The id of a result is the sku.

Results are always returned

A keyword that matches nothing is not answered with an empty list: Wayfair returns its popular products instead, so you cannot tell "no match" from a match by the count. total_results is always null because the total Wayfair gives changes from one request to the next and is not a match count. Judge relevance from the titles. Only the first 1,920 results of a query can be reached (page × size at most 1,920).

Sponsored results move

Sponsored products are included and flagged sponsored: true. Wayfair places them per request, so a sponsored product can appear on two pages, or move. Everything else keeps its place.

A busy moment can fail a call

Wayfair turns away about one request in four. We retry on other connections inside the call; when every try is turned away you get a 502 TARGET_FAILED, which is not charged: ask again.

Example

curl -G "https://api.scrapelyserp.com/v1/structured/wayfair/search" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  --data-urlencode "query=standing desk lamp" \
  -d sort=price_low \
  -d sale=true \
  -d size=24

Wayfair fields

Each result has the common search fields and a wayfair object.

Field

Description

id

The sku (W005077765, or a brand code like TMK6855). It is not accepted by POST /v1/products.

price, list_price

The price on the card, and the struck-through price (null when the card shows none). Prices are for one fixed delivery area, and the price of an option you pick on the product page can differ.

rating, reviews_count

Wayfair's own average and number of reviews. null (never 0) for a product with no reviews.

in_stock

true only when Wayfair marks the product in stock (including low stock), false when it marks it out of stock, null when the card says neither. null is unknown, not "in stock".

wayfair.stock_status

in_stock, low_stock (in stock, but low) or out_of_stock; null when unknown.

wayfair.stock_message

The card's own text: Low Stock, 13 Left in Stock, Out of Stock. null when there is none.

sponsored

true for a sponsored placement.

brand

The manufacturer's name as Wayfair shows it, ® included.

url, image

The product page, and a picture of the product.

Not given

Descriptions, dimensions, options, shipping costs and delivery dates, and a category parameter (search is by keyword).

Sort order

price_low and price_high order by price per item, so a listing sold as a set can sit slightly out of order against its shown price. top_rated orders by review rating. sale=true keeps products that are marked down.

Updated