Wayfair Product Data API
A GET request to the /api/getter/?platform="wayfair_detail" endpoint allows you to scrape product data for any product listing URL on Wayfair.com in real-time.
Example
Here's an example showing how you can scrape details about a specific sofa from Wayfair, you can use the following command:
1 | |
Note
When using curl, it is necessary to add the option -L to get the data back. This is because in some cases our server responds with a 301 and curl does not follow the redirect by default.
Query Parameters
As you can see in the example above, our endpoint needs the following query parameters:
Product URL
url
Required
Product listing's URL on Wayfair. Please remove unnecessary query parameters and encode the URL.
Other Required Parameters
platform
Required
Specifies the scraping engine you wish to invoke. In this case, the value should be wayfair_detail.
api_key
Required
Your account's token—which can be obtained by signing up here.
Note
The value of the query parameter url must be URL or percent encoded. If you're using Python, this can be done with the function urlencode.
Results
The response will include the following attributes for the product:
| Attributes Returned | Data Type | Information Represented |
|---|---|---|
| name | string | Name of product listing |
| brand | string | Brand of product listing |
| description | string | Full description of the product |
| overview | string | Overview of the product listing |
| images | list | List of product listing's image URLs |
| price | float | Current price of product |
| reviews | list | List of reviews with reviewer name, rating, text and date |
| rating | float | Average rating of product |
| total_reviews | int | Total number of reviews received |
| sku_id | string | Product's unique identifier (SKU) on Wayfair |
Response Example
Here's the response you will receive for the request showcased above:
{
"success": true,
"product_url": "https://www.wayfair.com/furniture/pdp/mercury-row-benitez-twin-or-smaller-76-wide-faux-leather-tufted-back-convertible-sofa-w005404809.html",
"result_count": 1,
"detail": {
"name": "Benitez Twin 76'' Faux Leather Tufted Convertible Sofa",
"images": [
"https://assets.wfcdn.com/im/86243993/compr-r85/1928/192892042/benitez-twin-76-faux-leather-tufted-convertible-sofa.jpg",
"https://assets.wfcdn.com/im/28061152/resize-h755-w755%5Ecompr-r85/1928/192892042/Benitez+Twin+76%27%27+Faux+Leather+Tufted+Convertible+Sofa.jpg",
"https://assets.wfcdn.com/im/26402115/scale-w72%5Ecompr-r85/8155/81553826/Black.jpg",
"https://assets.wfcdn.com/im/80108901/scale-w72%5Ecompr-r85/2683/268383990/White.jpg",
"https://assets.wfcdn.com/im/57927073/scale-w72%5Ecompr-r85/1268/126800234/Camel.jpg"
],
"price": 293.99,
"currency": "USD",
"description": "This futon features a convertible design that lets you transform from a sofa to a twin-size bed whenever you need an extra spot to sleep. It has a solid and engineered wood frame that rests on tapered dowel legs for a mid-century modern feel. Wrapped in faux leather, this sleeper sofa comes in a neutral tone to match almost any style or color scheme. The cushions are foam-filled with eight-way hand-tied strings to provide ample support as you relax or have an afternoon snooze. Its split-back design lets guests adjust their angle of comfort, while a tufted back and track arms complete the look.",
"overview": "Product OverviewAssembly Tools IncludedFrame Material: Solid + Manufactured WoodAssembly RequiredDescriptionThis futon features a convertible design that lets you transform from a sofa to a twin-size bed whenever you need an extra spot to sleep. It has a solid and engineered wood frame that rests on tapered dowel legs for a mid-century modern feel. Wrapped in faux leather, this sleeper sofa comes in a neutral tone to match almost any style or color scheme. The cushions are foam-filled with eight-way hand-tied strings to provide ample support as you relax or have an afternoon snooze. Its split-back design lets guests adjust their angle of comfort, while a tufted back and track arms complete the look.FeaturesMulti-functional piece is ideal for small living spaces. Converts easily from couch to sleeper.Ships in one box. Quick and easy assembly is required. Available in multiple colors and finishes. 1-year limited warranty.Split back design provides multiple positions of comfortSee MoreWeights & DimensionsSpecifications",
"sku_id": "W005404809",
"brand": "Mercury Row®",
"rating": 4.5,
"total_reviews": 4337,
"reviews": [
{
"reviewer_name": "Sulkiro",
"rating": 5,
"date": "2017-06-23",
"review_text": "So good! the cushion is very thick so very comfortable. the assembly is very easy. Good for 2~3 family."
},
{
"reviewer_name": "Iryna",
"rating": 5,
"date": "2019-03-06",
"review_text": "Fast delivery, good quality for the price, easy to assemble no damages, easy to clean, good size."
},
{
"reviewer_name": "Dara",
"rating": 5,
"date": "2018-04-09",
"review_text": "Love it!! Easy to assemble and very comfy. Worth every penny! I’m 5’10 and it’s plenty long for me to lay on."
},
{
"reviewer_name": "Gilda",
"rating": 5,
"date": "2018-03-21",
"review_text": "I absolutely love this sofa! I've only had it for a little well but it's a great purchase. Since I work from home, I needed something comfortable to sit on when I'm not at my desk. I have it against a wall so it looks like a regular sofa. It also lets you sit at the same height as other sofas which is unlike futons I've own in the past which sit lower. Not only is it is comfortable to sit on but very comfortable for me to take a nap on. I haven't had to lay it down and use as a bed but I'm sure any future guests that sleep on this will be pleasantly surprised. I had minor issues with a small mark that is on it but it definitely does not affect the quality of the product.A great buy!"
},
{
"reviewer_name": "Khanh",
"rating": 5,
"date": "2017-08-07",
"review_text": "Highly recommended! I would say this was the best purchase I've made. The price was right, shipping was super fast, took 4 business days to get here. Took my father and I about 45 minutes to put it together, the arms are zippered inside the bottom of the couch. Keep the sleeves that everything comes in! You never know when you'll move, they'll come in handy! It sits 4 adults comfortable ( height range between 5'4-5'10, and weight held 120-175 each adult). In my opinion, the sofa bed was quite comfortable, I myself have been sleeping on it for a week because my bed wasn't set up yet. Great quality and looks very nice!"
},
{
"reviewer_name": "Charlon",
"rating": 5,
"date": "2019-11-04",
"review_text": "I LOVE my new couch. It’s perfect!"
},
{
"reviewer_name": "Diana",
"rating": 5,
"date": "2018-01-06",
"review_text": "We love it. Its the perfect start to finishing our Brookstone Like Rustic Vintage Townhome living room!"
},
{
"reviewer_name": "Rashawna",
"rating": 5,
"date": "2017-10-07",
"review_text": "If you are reading this then you are making a excellent choice. This sofa fits me, husband and 2 boys,\nso technically three Adults can sit.The white is just beautiful. My husband and I love this futon. Delivery took a week and setting it up took about an hour.I also brought this really pretty rug from Wayfair as well. Very very HAPPY. You won't be disappointed."
},
{
"reviewer_name": "Marie",
"rating": 5,
"date": "2017-08-10",
"review_text": "I just received my Faux Leather Convertible Sofa yesterday and let me say it's beautiful! The box came in a little damaged so I was afraid the sofa would be as well. I'm happy to say it was not. It came in perfect condition with all the necessary tools and parts to assemble it. The assembly was a breeze! I've seen in recent reviews that many found it to be difficult but honestly I have no idea how. The directions were clear and precise and all laid out step-by-step. I'm the type of person who never likes to assemble things on my own because I always find a way to screw it up, but not with this. I was surprised with how simple it was. Once assembled I mean I honestly could not be happier. I will say this the back does have that Futon look where the sofa comes out a bit which I don't like. I plan of putting a sofa table behind it just to give it a better look. The sofa is definitely not a full I would it s it's a slightly larger twin. Also if someone does sleep on this I would put something under it so it will not tip over. As far as how comfortable the sofa is....for sitting I would say it's perfect. I myself like a firm sofa. Now for laying down or sleeping? Yeah that's a different story. I laid down scrolling through my phone and when I got up my back was killing me. With that said I do have some back problems but man! I believe with a thick blanket or comfy pillow it would be just fine. As far as for guests I will definitely invest on a good comfortable mattress topper. Overall I love the sofa so far, I'm just so pleased with how well it came and easy it was to assemble. This review might be a little premature seeing as I just received the sofa yesterday, but I take care of my products and don't think I will have any problems with it. I will post again in a few months to give a brief update. I hope this review comes in handy for anyone looking to buy this product!"
},
{
"reviewer_name": "Lourdes",
"rating": 5,
"date": "2017-08-07",
"review_text": "I absolutely love this couch. It looks beautiful and it came perfectly wrapped. Shipping was fast and it came the day expected. Easy to follow assembly instructions."
}
]
},
"remaining_credits": 585131
}
}
Request Cost
Each request to this endpoint costs 10 credits.
Supported Countries
Currently, our Wayfair Product Data API supports scraping product details from the U.S. website (Wayfair.com). We are working on expanding support to other countries in the near future.
Support
If you want to add a parameter to our response, or have any question or feedback, please write to us at support@unwrangle.com