Wayfair Product Search API — Keyword Search With Prices & Ratings
Send a keyword and this source searches Wayfair and returns matching products as data: title, brand, price, list price, discount, rating, review count and images.
{
"session_id": "11111111-1111-1111-1111-111111111111",
"kind": "wayfair_products_search",
"keyword": "velvet accent chair",
"max_items": 2,
"start_page": 1,
"partial": false,
"human": "# Wayfair products search\n\n- **Keyword:** velvet accent chair\n- **Starting page:** 1\n- **Max items:** 2\n- **Records returned:** 2\n- **Proxy traffic:** 3.27 MB",
"machine": {
"total_items": 2,
"items": [
{
"@type": "WayfairSearchProduct",
"id": "ABEH1166",
"url": "https://www.wayfair.com/rugs/pdp/amber-lewis-x-loloi-honora-bark-dove-area-rug-abeh1166.html",
"title": "Amber Lewis x Loloi Honora Bark / Dove Area Rug",
"brand": null,
"price": 691.99,
"list_price": 2109,
"currency": "USD",
"discount": "67%",
"rating": 4.66,
"review_count": 99,
"image": "https://assets.wfcdn.com/im/19716844/resize-h400-w400%5Ecompr-r85/2766/276676018/Amber+Lewis+x+Loloi+Honora+Bark+%2F+Dove+Area+Rug.jpg",
"images": [
"https://assets.wfcdn.com/im/19716844/resize-h400-w400%5Ecompr-r85/2766/276676018/Amber+Lewis+x+Loloi+Honora+Bark+%2F+Dove+Area+Rug.jpg"
],
"sponsored": true,
"position": 1
},
{
"@type": "WayfairSearchProduct",
"id": "W004253071",
"url": "https://www.wayfair.com/rugs/pdp/world-menagerie-giacinto-oriental-area-rug-w004253071.html",
"title": "Giacinto Oriental Indoor Rug",
"brand": null,
"price": 39.99,
"list_price": 79,
"currency": "USD",
"discount": "49%",
"rating": 4.6,
"review_count": 5437,
"image": "https://assets.wfcdn.com/im/47113116/resize-h400-w400%5Ecompr-r85/6509/65099958/Giacinto+Oriental+Indoor+Rug.jpg",
"images": [
"https://assets.wfcdn.com/im/47113116/resize-h400-w400%5Ecompr-r85/6509/65099958/Giacinto+Oriental+Indoor+Rug.jpg"
],
"sponsored": true,
"position": 2
}
],
"response_bytes": 3427059
},
"total_points": 2
}- You send
- A search keyword, with optional max_items and start_page
- You get back
- Matching products with title, brand, price, discount, rating and images
- Coverage
- What Wayfair.com shows publicly for the request.
- Price
- 1 point per returned result, up to 300 per request — $1 per 1,000
- Billed per record actually returned, capped by max_items. A request that returns nothing costs nothing.
Ways to get this data
Three approaches teams use today, and where each one runs into trouble.
| Approach | What it takes | Cost | Trade-off |
|---|---|---|---|
| Browsing the site by hand | Type the keyword, scroll, copy | Free, and slow | Nobody keeps a comparison list current this way |
| Building a scraper | Write it, host it, and repair it when Wayfair changes the results page | Engineering time | A maintenance commitment for something that isn't your product |
| NeuralVerge | One request, the input and options as parameters | $1 per 1,000, misses not billed | A broad request returns a broad — and larger, more expensive — result set |
What you get back
Every field in the response shown above.
| Field | Type | Description |
|---|---|---|
total_items | number | How many products were returned in this batch (capped by max_items). |
@type | string | Record type label, WayfairSearchProduct. |
id | string | Wayfair SKU. |
url | string | Direct link to the product page. |
title | string | Listing title. |
brand | string | Brand as listed; null when the result does not show one. |
price | number | Current price. |
list_price | number | Pre-discount list price. |
currency | string | ISO currency code. |
discount | string | Discount shown on the listing, as a percentage string. |
rating | number | Average star rating. |
review_count | number | Number of reviews. |
image | string | Primary product image URL. |
images | array | Image URLs shown on the result. |
sponsored | boolean | Whether the result is a sponsored placement. |
position | number | Rank of the result in the search results. |
How to run it
The same lookup works from the app, the API, or as a tool an agent can call mid-task.
keyword is the only required field. max_items caps the result count (up to 300, defaults to 25) and sets what you are billed for; start_page continues from a later results page.
curl -X POST https://api.neuralverge.ai/functions/v1/run-wayfair-products-search \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "keyword": "velvet accent chair", "max_items": 25 }'What teams use it for
Where this field shows up in an actual workflow.
Pull listings for a product type and compare price, discount and rating.
Use position and sponsored to see where a brand appears for a search term.
Compare list_price with price to see how heavily a category is discounted.
Find SKUs to feed into Wayfair product for full detail.
Coverage, freshness and limits
What this source covers, how fresh it is, and where it stops.
What Wayfair.com shows publicly for the request.
Read at request time.
This source returns publicly visible product information, stamped with the input it was read from and a session id you can trace.
- —Sponsored placements are included and flagged, and they affect result order.
- —Brand can be null on some search results; Wayfair product returns it for the full listing.
- —Price and discounts reflect the moment of the search and can change right after.
Questions, answered
You only get and pay for up to max_items results, so set it deliberately rather than leaving it at the default.
Related sources
Try wayfair product search on your own data
One request format across every source in the catalog.