Home Depot Product 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.

Home Depot Product API Alpha

Retrieve a public product on Home Depot. Prices and availability are returned only when present in the retailer response and may depend on location. Requests may fail intermittently; retry later if product data is unavailable.

GET / POST https://ecll-litescrape-v3--site-api-web.modal.run/api/homedepot/product

curl --fail-with-body --request POST 'https://ecll-litescrape-v3--site-api-web.modal.run/api/homedepot/product' \ --header "Authorization: Bearer $LITESCRAPE_API_KEY" \ --header 'Content-Type: application/json' \ --data '{ "url": "https://www.homedepot.com/p/DEWALT-20V-MAX-Cordless-Drill-DCD771C2/204279858" }'

JSON POST request example

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

{
  "url": "https://www.homedepot.com/p/DEWALT-20V-MAX-Cordless-Drill-DCD771C2/204279858"
}

// request reference

Home Depot Product parameters

Send query parameters with GET /api/homedepot/product. 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

url

UrlRequired

Public HTTPS product URL on this retailer's site.

Type string · GET query or POST JSON

Minimum characters: 1
Maximum characters: 4096

// 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, product, 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": "Home Depot",
    "total_time_taken": 0.316
  },
  "search_parameters": {
    "url": "https://www.homedepot.com/p/DEWALT-20V-MAX-Cordless-Drill-DCD771C2/204279858"
  },
  "product": {
    "product_id": "204279858",
    "title": "20V MAX Cordless 1/2 in. Drill/Driver, (2) 20V 1.3Ah Batteries, Charger and Bag",
    "url": "https://www.homedepot.com/p/DEWALT-20V-MAX-Cordless-1-2-in-Drill-Driver-2-20V-1-3Ah-Batteries-Charger-and-Bag-DCD771C2/204279858",
    "brand": "DEWALT",
    "image": "https://images.thdstatic.com/productImages/d00a1384-69ea-4f77-a5c3-c0ac8fd531fa/svn/dewalt-power-drills-dcd771c2-64_1000.jpg",
    "images": [
      "https://images.thdstatic.com/productImages/d00a1384-69ea-4f77-a5c3-c0ac8fd531fa/svn/dewalt-power-drills-dcd771c2-64_1000.jpg",
      "https://images.thdstatic.com/productImages/26d5ac8e-18c5-4d42-bc9c-db5bc83a1c11/svn/dewalt-power-drills-dcd771c2-e1_1000.jpg",
      "https://images.thdstatic.com/productImages/108c9b6b-af1e-45c6-9170-093524d17186/svn/dewalt-power-drills-dcd771c2-40_1000.jpg",
      "https://images.thdstatic.com/productImages/fe0c9a1e-0d77-4422-a706-b5c0d5a12c8d/svn/dewalt-power-drills-dcd771c2-a0_1000.jpg",
      "https://images.thdstatic.com/productImages/8e0f0bbc-1508-4773-995c-8ea601f9aedc/svn/dewalt-power-drills-dcd771c2-1d_1000.jpg",
      "https://images.thdstatic.com/productImages/5322e717-5622-4723-880d-cf2c1d1034f1/svn/dewalt-power-drills-dcd771c2-66_1000.jpg",
      "https://images.thdstatic.com/productImages/824db38a-4f51-4099-b451-af803261a704/svn/dewalt-power-drills-dcd771c2-77_1000.jpg",
      "https://images.thdstatic.com/productImages/37d28877-824b-4b26-a025-26a45791f44a/svn/dewalt-power-drills-dcd771c2-c3_1000.jpg",
      "https://images.thdstatic.com/productImages/928ac8f6-9979-413c-b7ea-1ae0bdad5389/svn/dewalt-power-drills-dcd771c2-4f_1000.jpg",
      "https://images.thdstatic.com/productImages/b04df609-7219-4a46-9639-da2e6e0a97cc/svn/dewalt-power-drills-dcd771c2-44_1000.jpg",
      "https://images.thdstatic.com/productImages/975c92e5-5a69-41fe-9395-06c8a7e4c558/svn/dewalt-power-drills-dcd771c2-fa_1000.jpg",
      "https://images.thdstatic.com/productImages/68a07b09-8722-45ae-b586-e96a3ce1cc10/svn/dewalt-power-drills-dcd771c2-76_1000.jpg",
      "https://images.thdstatic.com/productImages/c751e460-58f0-405e-8eed-a2ed15997670/svn/dewalt-power-drills-dcd771c2-d4_1000.jpg"
    ],
    "price": {
      "amount": 119,
      "currency": "USD"
    }
  },
  "submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}