{"uid":"cap_cyQCE0nCKh-HzzLZUI5af","slug":"agents-openwebninja-com-wayfair-product-search-064f34c4","name":"Wayfair Product Search","description":"Search for Wayfair products by keyword or browse by brand/manufacturer. Supports pagination, sorting, and filters.","url":"https://agents.openwebninja.com/real-time-wayfair-data/search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["query"],"properties":{"page":{"type":"integer","default":1,"description":"Page number for pagination.\n\n**Allowed values:** `1` and above."},"color":{"type":"string","description":"Filter products by color.\n\n**Examples:** `Black`, `White`, `Blue`, `Gray`, `Brown`, `Red`, `Green`, `Beige`, `Gold`, `Silver`, `Multi Colored`"},"query":{"type":"string","description":"Search query (keyword search). Either `query` or `manufacturer_id` is required.\n\n**Examples:**\n`sofa`\n`standing desk`\n`outdoor patio furniture`"},"domain":{"type":"string","default":"com","description":"Wayfair domain/country for the search.\n\n**Default:** `com`\n\n**Allowed values:** `com, ca, co.uk, ie`\n\n`de` is no longer supported: Wayfair has closed wayfair.de."},"sort_by":{"enum":["recommended","customer_rating","price_low_to_high","price_high_to_low"],"type":"string","default":"recommended","description":"Sort order for the results."},"in_stock":{"type":"boolean","default":false,"description":"Only return products that are currently in stock."},"max_price":{"type":"number","description":"Only return products with a price less than or equal to this value (in USD)."},"min_price":{"type":"number","description":"Only return products with a price greater than or equal to this value (in USD)."},"category_id":{"type":"string","description":"Wayfair category ID to filter results within a specific category. Used with `manufacturer_id` to browse brand products in a category."},"items_per_page":{"enum":["24","48","96"],"type":"string","default":"48","description":"Number of products to return per page.\n\n**Allowed values:** `24`, `48`, `96`"},"manufacturer_id":{"type":"string","description":"Wayfair manufacturer/brand ID for browsing all products by a specific brand. Either `query` or `manufacturer_id` is required.\n\nYou can find manufacturer IDs in the product URLs on Wayfair (e.g., wayfair.com/brand/bnd/ninja-b**21377**.html)."}}},"responseSchema":{"type":"object","required":["status","request_id","parameters","data"],"properties":{"data":{"type":"object","required":["products"],"properties":{"keyword":{"type":"string","nullable":true,"description":"Echo of the search keyword."},"products":{"type":"array","items":{"type":"object","required":["sku","name","url"],"properties":{"sku":{"type":"string","description":"Wayfair product SKU."},"url":{"type":"string","description":"Canonical URL of the product on Wayfair."},"flag":{"type":"string","nullable":true,"description":"Special flag set on the product (e.g. sale, new)."},"name":{"type":"string","description":"Product name."},"brand":{"type":"string","nullable":true,"description":"Brand / manufacturer name."},"rating":{"type":"number","nullable":true,"description":"Average customer rating (0-5)."},"pricing":{"type":"object","nullable":true,"required":["current_price","currency"],"properties":{"currency":{"type":"string","description":"ISO 4217 currency code."},"current_price":{"type":"number","description":"Current sale price."},"original_price":{"type":"number","nullable":true,"description":"Original (pre-discount) price, when on sale."},"discount_amount":{"type":"number","nullable":true,"description":"Discount amount in the listing currency, when on sale."},"discount_percentage":{"type":"number","nullable":true,"description":"Discount as a percentage, when on sale."}},"description":"Current pricing for the product."},"in_stock":{"type":"boolean","nullable":true,"description":"Whether the product is currently in stock."},"image_url":{"type":"string","nullable":true,"description":"URL of the product's primary image."},"promo_text":{"type":"string","nullable":true,"description":"Promotional label displayed on the product card."},"review_count":{"type":"integer","nullable":true,"description":"Total number of customer reviews."},"free_shipping":{"type":"boolean","nullable":true,"description":"Whether the product ships free."},"shipping_text":{"type":"string","nullable":true,"description":"Free-form shipping label as displayed on Wayfair."},"option_summary":{"type":"string","nullable":true,"description":"Short summary of the variant option type (e.g. Fabric)."},"delivery_estimate":{"type":"string","nullable":true,"description":"Estimated delivery date label."},"color_option_count":{"type":"integer","nullable":true,"description":"Number of color variants available."}}},"description":"Wayfair products matching the search."},"total_pages":{"type":"integer","nullable":true,"description":"Total number of pages available for this search."},"current_page":{"type":"integer","nullable":true,"description":"Current page number returned."},"sort_options":{"type":"array","items":{"type":"object","required":["value","name"],"properties":{"name":{"type":"string","description":"Display name of the sort option."},"value":{"type":"integer","description":"Wayfair internal sort option value."}}},"nullable":true,"description":"Available sort options for this search, as Wayfair reports them."},"total_results":{"type":"integer","nullable":true,"description":"Approximate total number of products matching the search."},"items_per_page":{"type":"integer","nullable":true,"description":"Number of products returned per page."}}},"status":{"type":"string","description":"The status of the API response."},"parameters":{"type":"object","properties":{"page":{"type":"integer","description":"Page number for pagination as received."},"query":{"type":"string","nullable":true,"description":"The search query as received."},"sort_by":{"type":"string","description":"Sort order as received. Values: recommended, customer_rating, price_low_to_high, price_high_to_low."},"items_per_page":{"type":"integer","description":"Number of products requested per page. Values: 24, 48, 96."}},"description":"The parameters the API received and used for this request, echoed back."},"request_id":{"type":"string","description":"A unique ID to trace the API request."}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unknown_unparsed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_C2LfvuyZlVxwHm5qJZ0kk","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"Search Wayfair's product catalog by keyword or browse by brand/manufacturer with filtering, sorting, and pagination support.","exampleAgentPrompt":"Search Wayfair for gray sectional sofas under $1,200 that are currently in stock, sorted by customer rating — show me the top 24 results.","exampleUseCases":[{"title":"Budget furniture shopping assistant","prompt":"Search Wayfair for standing desks between $200 and $600, in stock only, sorted by price low to high — give me the first 24 results."},{"title":"Brand catalog browsing","prompt":"I want to browse all products from the Wayfair brand with manufacturer ID 21377 — show me their full catalog sorted by customer rating, 48 items per page."},{"title":"Color-specific home decor search","prompt":"Find me white outdoor patio furniture on Wayfair, sorted by customer rating, and only show items that are currently in stock."}],"resultDescription":"Returns a paginated list of Wayfair products matching the search criteria, each including SKU, name, canonical URL, brand, current and original pricing (with discount details), customer rating, review count, stock status, free shipping flag, image URL, and any promotional labels.","failureModes":["Missing both query and manufacturer_id returns a validation error","Invalid manufacturer_id returns empty product list","Unsupported domain (e.g. 'de') returns an error since Wayfair.de is closed","Out-of-range page number returns empty results","Invalid color filter value returns no products","Network or upstream Wayfair service outage causes 5xx errors"],"whenToPreferThis":"Use this endpoint when you need real-time Wayfair product listings with live pricing, stock status, and ratings. Prefer this over generic web scraping when you need structured product data including SKUs, discount details, and review counts specifically from Wayfair. Choose this over Amazon or Walmart search endpoints when the user specifically wants Wayfair's home goods and furniture catalog.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:37:04.321Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-wayfair-product-search-064f34c4"}