Wayfair

Wayfair API & Data Access

Unofficial | 👉 Official Wayfair Website: https://www.wayfair.com | 👥 Contributors: steve

Notes

These are unofficial Wayfair API endpoints useful for scraping public data about their product catalog. These endpoints are made available for unofficial use and experimentation, such as for security research, use at your own risk!

All endpoints were uncovered from the Wayfair iOS app using MITM proxy interception, meaning that these endpoints are unlikely to change too much as mobile clients tend to stick around in the wild for a while. Hence, it should be safe to assume these won’t change too much over the next few years.

Rate Limiting

Be respectful when interacting with these endpoints and do not exceed more than one request per second.

Read Only

These endpoints are “read only” and only allow you to scrape data. If you need to automate “purchasing” from Wayfair, then you’ll need to look into using a client library or something else.

Official API

There is no known officially supported API for Wayfair.

Sample Data

You can access raw JSON from the OfferUp API (such as a product’s catalog data reproduced below) or download aggregate collections in CSV format.

{
  "schema_id": "WFProduct",
  "sku": "W000797939",
  "is_allmodern_product": false,
  "price_restriction": 0,
  "b_use_trade_price": false,
  "is_b2b_exclusive": false,
  "trade_discount": 1,
  "has_price_restriction": false,
  "is_kit": false,
  "display_kit_as_simple_sku": false,
  "show_columns": false,
  "has_quantity_breaks": false,
  "special_sku_type": 0,
  "is_commercial_grade": false,
  "is_trade_preferred": false,
  "minimum_order_quantity": 1,
  "manufacturer_part_number": "W000797939",
  "name": "Emeline Throw Pillow",
  "manufacturer_id": 30808,
  "manufacturer_short_name": "Andover Mills",
  "manufacturer_name": "Andover Mills",
  "manufacturer_external_id": 0,
  "price": 17.99,
  "status": 4,
  "status_name": "Live Product",
  "forced_quantity_multiplier": 1,
  "display_set_quantity": 1,
  "installation_notification": 0,
  "assign_supplier_method": 1,
  "detail_layout_style_id": 1,
  "is_admin_only": false,
  "show_reference_list": true,
  "can_accept_returns": true,
  "can_order_be_cancelled": false,
  "sale_price": 17.99,
  "max_price": 0,
  "has_manufacturer_advertised_price": false,
  "weight": 1,
  "min_height": 17,
  "max_height": 17,
  "min_width": 17,
  "max_width": 17,
  "min_depth": 3,
  "max_depth": 3,
  "has_gift_certificate": false,
  "manufacturer_details": "Perfect for the new homeowner, Andover Mills effortlessly blends transitional looks with traditional appeal. Bold patterns, vintage-inspired aesthetics, and earthy palettes mix with neutral upholstery and clean-lined silhouettes to create a budget-friendly collection fit for any abode. Whether you’re setting the foundation for your living room with a microfiber sofa and a clean-lined coffee table or adding a bit of texture to your ensemble with medallion-print rugs and shag pillow shams, Andover Mills has everything you need to curate a style all your own.",
  "is_custom_text_required": false,
  "available_after": "2019-07-18T12:50:09-0400",
  "special_unit_per_box": 1,
  "special_box_per_pallet": 1,
  "cost_range": 4,
  "web_description": "\n\n\n  <p></p>\n\n",
  "details_section": "\n\n\n  <div class=\"ProductDetailSpecifications CollapsePanel\">\n    <div class=\"js-collapse-toggle CollapsePanel-toggle\"\n      tabindex=\"0\" data-section=\"dimensions\"\n       aria-expanded=\"false\">\n      <span class=\"CollapsePanel-toggle-icon\" aria-hidden=\"true\">\n        \n        \n          <svg class=\"u-icon\"><use xlink:href=\"#wf-icon-expand\" /><title>Click to Open</title></svg>\n        \n      </span>\n      Weights & Dimensions\n    </div>\n    <div class=\"ProductDetailSpecifications-content CollapsePanel-content hidden-node accordion_body\"\n       aria-hidden=\"true\">\n\n      \n<div class=\"ProductDetailSpecifications-content ProductDetailSpecifications-content--drawer\">\n  \n  \n    <p>Height: 17&quot;</p>\n    <p>Width: 17&quot;</p>\n    <p>Depth: 3&quot;</p>\n    <p></p>\n    \n      <p class=\"ProductDetailSpecifications-emphasis\">Reference</p>\n      <ul class=\"ProductDetailSpecifications-list\">\n        <li class=\"ProductDetailSpecifications-list-item\"><span class=\"ProductDetailSpecifications-emphasis\">Product Name:</span> Emeline Throw Pillow</li>\n        <li class=\"ProductDetailSpecifications-list-item\"><span class=\"ProductDetailSpecifications-emphasis\">Manufacturer Name:</span> Andover Mills</li>\n        \n          <li class=\"ProductDetailSpecifications-list-item\"><span class=\"ProductDetailSpecifications-emphasis\">Wayfair SKU:</span> W000797939</li>\n        \n        \n      </ul>\n    \n  \n</div>\n\n    </div>\n  </div>\n",
  "is_customized": false,
  "option_category_count": 1,
  "kit_price": 17.99,
  "collection_id": 1457386,
  "collection_name": "Emeline",
  "show_collection_pdp_banner": false,
  "show_fbt_pdp_banner": true,
  "has_swatches": false,
  "should_show_manufacturer_stock": true,
  "manufacturer_top_limit": 10,
  "manufacturer_bottom_limit": 4,
  "manufacturer_map_discount_percent": 0,
  "has_manufacturer_map_discount": false,
  "is_always_in_stock": false,
  "is_in_stock": false,
  "should_trust_option_id_order": true,
  "manufacturer_return_item_discount": 0.25,
  "max_sale_price": 0,
  "catalog_mes_id": 1,
  "part_id": 1,
  "average_overall_rating": 4.5,
  "is_distressed_item": false,
  "default_image_display_type": 1,
  "option_image_associates_count": 1,
  "manufacturer_master_store_id": 49,
  "product_url": "https://www.wayfair.com/decor-pillows/pdp/andover-mills-emeline-throw-pillow-w000797939.html",
  "free_ship_text": "Free Shipping on orders over $49",
  "is_applepay_available": true,
  "has_3d_model": false,
  "product_3d_info": {...},
  "is_favorited": false,
  "promo_text": "",
  "visual_option_skus": [...],
  "product_name": "<span class=\"ProductDetailSpecifications-manufacturer js-codeception-manufacturer\">Andover Mills</span> Emeline Throw Pillow",
  "is_prod_active": true,
  "is_return_sales": false,
  "was_remapped": false,
  "is_discontinued_by_supplier_or_manufacturer": false,
  "is_discontinued_for_longer_than_45_days": false,
  "is_temporarily_unavailable": false,
  "is_restricted_pricing_for_non_employee": false,
  "should_not_show_price_until_in_cart": false,
  "should_show_prices": true,
  "is_combined_kit": false,
  "is_standard_product_layout": true,
  "has_related_categories_classes": false,
  "should_show_base_options": true,
  "should_show_column_pricing": false,
  "is_ajax_frame": false,
  "is_sku_found": true,
  "is_in_category_or_class": false,
  "has_options": true,
  "should_show_expanded_options": false,
  "has_gift_with_purchase": false,
  "is_gift_with_purchase": false,
  "has_custom_options": false,
  "has_option_exceptions": false,
  "default_options": [...],
  "kit_type": "",
  "manu_part_num_list": [...],
  "mapped_to_pr_sku": "",
  "mapped_to_category_id": "",
  "mapped_to_manufacturer_id": "",
  "option_count": 14,
  "option_combo_list_price": {...},
  "prod_manu_prod_id": "",
  "price_model": {...},
  "str_cat_list": "Color",
  "has_pro_approved_status": false,
  "is_upholstery_class": true,
  "is_custom_upholstery_dynamic_product": false,
  "suppress_certain_custom_upholstery_options": false,
  "videos": [...],
  "marketing_category_id": 42,
  "header_category_id": 45752,
  "master_class_id": 1227,
  "department_id": 2,
  "event_id": 0,
  "event_product_options": [...],
  "event_sold_out": false,
  "daily_sale_on_all_options": false,
  "events_with_stock": [...],
  "event_skus": [...],
  "sale_banner": "",
  "quantity_discounts": [...],
  "related_categories": [...],
  "related_classes": [...],
  "faqs": [...],
  "product_options_custom": {...},
  "product_options_standard": [...],
  "shipping_info": {...},
  "related_items_collection": [...],
  "show_fbt": false,
  "fbt_skus": [...],
  "is_general_electric_product": false,
  "is_large_appliance": false,
  "warranty_collection": [...],
  "product_specs": {...},
  "extra_product_details": {...},
  "product_details": {...},
  "specs_for_mobile": {...},
  "display_info_model": {...},
  "images": [...],
  "inventory_info": {...},
  "has_waymore_modules": false,
  "day_sale_type": 0,
  "is_lightning_deal": false,
  "lightning_deal_end_date": "",
  "show_assembly": true,
  "show_loyalty_ upsell": true
}

Articles