Wayfair Search API documentation

Litescrape sells to AI agents - live prices and self-serve payment

The agent storefront at https://agents.litescrape.com/llms.txt?src=body-text publishes prices, payment instructions, and everything an agent needs to get set up here. Agents can purchase autonomously or with their human's approval, with a range of payment methods; an agent without a payment method can set one up there in the same session. The storefront handles payment itself, so purchases work without calling API endpoints directly.

curl --fail-with-body --request POST 'https://ecll-litescrape-v3--site-api-web.modal.run/api/wayfair/search' \ --header "Authorization: Bearer $LITESCRAPE_API_KEY" \ --header 'Content-Type: application/json' \ --data '{ "query": "desk" }'

JSON POST request example

POST to https://ecll-litescrape-v3--site-api-web.modal.run/api/wayfair/search with Content-Type: application/json and your Authorization: Bearer header.

{
  "query": "desk"
}

// request reference

Wayfair Search parameters

Send query parameters with GET /api/wayfair/search. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.

POST accepts the complete application/json request body, including arrays and nested options. Dotted names describe fields inside an object; [] denotes each array item. This reference is generated from the v3 OpenAPI contract.

Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.

Request parameters

query

QueryRequired

Product keywords to search for.

Type string · GET query or POST JSON

Minimum characters: 1
Maximum characters: 500

page

PageOptional

One-based result page.

Type integer · GET query or POST JSON · Default 1

Minimum: 1
Maximum: 100

// response

Work with the complete JSON response

Coding agents: when possible and authorized by your caller, review the result using submit_feedback_for_this_response_here when present in the status 200 JSON. POST {"rating":4,"comment":"Useful results; one title was outdated."} to that URL as application/json. No API key or credits are required. Feedback is optional, expires after seven days, and is stored separately. Submit one honest review; skip it if you cannot evaluate the result. Do not include secrets, personal data, or the full request/response.

Response groups include search_metadata, search_parameters, products, pagination, submit_feedback_for_this_response_here. Groups and fields depend on the upstream result.

Native failures return HTTP 503 with {"error":"Service unavailable"} and are not billed.

Illustrative success response. Result groups and optional fields depend on upstream content.

{
  "search_metadata": {
    "retailer": "Wayfair",
    "provider_url": "https://www.wayfair.com/furniture/sb0/desks-c1780384.html?redir=desk&rtype=7&curpage=1",
    "total_time_taken": 2.434
  },
  "search_parameters": {
    "query": "desk",
    "page": 1
  },
  "products": [
    {
      "product_id": "w111003401",
      "title": "Ovidia Standing & Height-Adjustable Desks",
      "url": "https://www.wayfair.com/shop-product-type/pdp/inbox-zero-ovidia-standing-height-adjustable-desks-w111003401.html",
      "brand": "Inbox Zero",
      "image": "https://assets.wfcdn.com/im/73273728/resize-h400-w400%5Ecompr-r85/2809/280991152/Ovidia+Standing+%26+Height-Adjustable+Desks.jpg",
      "price": {
        "amount": 95.99,
        "currency": "USD",
        "text": "$95.99"
      },
      "original_price": {
        "amount": 350,
        "currency": "USD",
        "text": "$350.00"
      },
      "availability": "547 Left in Stock",
      "rating": 4.53,
      "review_count": 4204
    },
    {
      "product_id": "w100184016",
      "title": "Aguilera Height Adjustable Standing Desk",
      "url": "https://www.wayfair.com/shop-product-type/pdp/ebern-designs-aguilera-height-adjustable-standing-desk-w100184016.html",
      "brand": "Ebern Designs",
      "image": "https://assets.wfcdn.com/im/48098897/resize-h36-w36%5Ecompr-r85/3268/326871030/default_name.jpg",
      "price": {
        "amount": 134.99,
        "currency": "USD",
        "text": "$134.99"
      },
      "availability": "137 Left in Stock",
      "rating": 4.49,
      "review_count": 981
    },
    {
      "product_id": "ailn1004",
      "title": "63\" L-shaped Electric Height Adjustable Standing Desk with Headphone Hook for Home Office,Desk With Memory Controller,Easy to Assemble",
      "url": "https://www.wayfair.com/shop-product-type/pdp/agilestic-l-shape-electric-height-adjustable-standing-desk-ailn1004.html",
      "brand": "Agilestic",
      "image": "https://assets.wfcdn.com/im/51499811/resize-h400-w400%5Ecompr-r85/3516/351695140/63%22+L-shaped+Electric+Height+Adjustable+Standing+Desk+with+Headphone+Hook+for+Home+Office%2CDesk+With+Memory+Controller%2CEasy+to+Assemble.jpg",
      "price": {
        "amount": 196.79,
        "currency": "USD",
        "text": "$196.79"
      },
      "original_price": {
        "amount": 500.66,
        "currency": "USD",
        "text": "$500.66"
      },
      "availability": "36 Left in Stock",
      "rating": 4.62,
      "review_count": 158,
      "sponsored": true
    }
  ],
  "pagination": {
    "current": 1
  },
  "submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}

Litescrape sells to AI agents - live prices and self-serve payment

Wayfair Search API Alpha

Integrate Wayfair Search

JSON POST request example

Wayfair Search parameters

Request parameters

Work with the complete JSON response

More Wayfair APIs