家得宝产品查询 API

一个用于特定邮政编码和产品ID的小型家得宝产品查询爬虫
通过 MCP 从您的 AI 代理使用此 API
支持 OpenClaw、Claude Code/Desktop、Cursor、Windsurf、Cline 以及任何兼容 MCP 的 AI 客户端。
文档和设置
通过封装此 MCP 创建技能: https://mcp.zylalabs.com/mcp?apikey=YOUR_ZYLA_API_KEY

概述
Home Depot 产品查询 API 允许您通过提供产品 ID 和邮政编码来实时获取任何 HD 产品的价格和可用性。此 API 帮助用户检查库存水平并比较附近 HD 门店的价格,非常适合需要最新库存信息的购物者、承包商和企业。

主要特点
  • 实时数据:获取 HD 产品的最新价格和可用性。
  • 基于位置的结果:输入邮政编码以查看附近商店的库存水平。
  • 高效购物:比较多个地点的价格,以找到最优惠的交易。
  • 易于集成:简单的 API 请求格式,便于在应用、工具或网站中快速实施。

无论您是计划进行 DIY 项目,管理企业物资,还是只是想在当地 Home Depot 找到最好的价格,这个 API 可以让您在几秒钟内轻松找到所需信息。
 

输入架构
参数 类型 必需 描述
zip 字符串 产品位置的邮政编码。
productId 字符串 产品的唯一标识符。
noWait 布尔值 如果设置,将立即返回 asyncId 以便稍后查询。
callback 字符串 如果设置,将立即返回 asyncId,结果将通过回调提供。

 

> 如果查询快速完成,将直接返回产品详细信息。



异步查询
参数 类型 必需 描述
asyncId 字符串 在超时发生时从先前的查询请求中获得的 ID。一旦可用,使用此 ID 检索产品结果。

 

> 如果初始查询耗时过长,响应将返回 asyncId 而不是产品数据。使用此 asyncId 后续请求结果。
 

API 文档

端点


获取特定邮政编码的单一产品


                                                                            
POST https://www.zylalabs.com/api/11655/%e5%ae%b6%e5%be%97%e5%ae%9d%e4%ba%a7%e5%93%81%e6%9f%a5%e8%af%a2+api/22008/%e9%80%9a%e8%bf%87%e9%82%ae%e6%94%bf%e7%bc%96%e7%a0%81%e6%9f%a5%e6%89%be%e4%ba%a7%e5%93%81
                                                                            
                                                                        

通过邮政编码查找产品 - 端点功能

对象 描述
请求体 [必需] Json
测试端点

API 示例响应

       
                                                                                                        
                                                                                                                                                                                                                                                                                                                                        {"asyncId":"homedepot:84e55fd8f9582f248996285ff507ff01960bd3344101b05f15f22ef9b49c8437","stores":{"4187":{"id":"4187","name":"Willow Grove","address":"2250 Easton Road","city":"Willow Grove","state":"PA","zip":"19090","phone":"(215)657-2897","distance":1.0067916513917736,"hours":{"mon":{"open":"6:00","close":"21:00"},"tue":{"open":"6:00","close":"21:00"},"wed":{"open":"6:00","close":"21:00"},"thu":{"open":"6:00","close":"21:00"},"fri":{"open":"6:00","close":"21:00"},"sat":{"open":"6:00","close":"21:00"},"sun":{"open":"7:00","close":"20:00"}},"products":{"302040042":{"name":"Double 4 in. x 150 in. Autumn Tan Lap Vinyl Siding","description":"No Paint. No Stain. No hassles. That is the beauty and value of Transformations vinyl siding from Ply Gem Performance Collection. Transformations is an excellent choice for a virtually carefree, amazing home exterior. Transformations comes in 13 beautiful colors, and featured profiles of Double 4 in., Double 5 in. and Double 4 1/2 in. Dutch Lap.","url":"/p/Double-4-in-x-150-in-Autumn-Tan-Lap-Vinyl-Siding-PC40M6HP/302040042","imageUrl":"https://images.thdstatic.com/productImages/f3b94555-5a11-4ada-b2ed-51c826d7f484/svn/autumn-vinyl-siding-pc40m6hp-64_1000.jpg","quantityAvailable":0,"priceCentsPerUnit":869,"salePriceCentsPerUnit":null,"bulkPriceCentsPerUnit":null}}}}}
                                                                                                                                                                                                                    
                                                                                                    

通过邮政编码查找产品 - 代码片段


curl --location --request POST 'https://zylalabs.com/api/11655/%e5%ae%b6%e5%be%97%e5%ae%9d%e4%ba%a7%e5%93%81%e6%9f%a5%e8%af%a2+api/22008/%e9%80%9a%e8%bf%87%e9%82%ae%e6%94%bf%e7%bc%96%e7%a0%81%e6%9f%a5%e6%89%be%e4%ba%a7%e5%93%81' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
    "zip": "19090",
    "productId": "302040042"
}'

    

获取特定邮政编码在之前运行中的单个产品结果



                                                                            
POST https://www.zylalabs.com/api/11655/%e5%ae%b6%e5%be%97%e5%ae%9d%e4%ba%a7%e5%93%81%e6%9f%a5%e8%af%a2+api/22009/%e9%80%9a%e8%bf%87%e9%82%ae%e6%94%bf%e7%bc%96%e7%a0%81%e6%9f%a5%e8%af%a2%e4%ba%a7%e5%93%81%e7%9a%84%e7%bb%93%e6%9e%9c
                                                                            
                                                                        

通过邮政编码查询产品的结果 - 端点功能

对象 描述
请求体 [必需] Json
测试端点

API 示例响应

       
                                                                                                        
                                                                                                                                                                                                                                                                                                                                        {"asyncId":"homedepot:84e55fd8f9582f248996285ff507ff01960bd3344101b05f15f22ef9b49c8437","stores":{"4187":{"id":"4187","name":"Willow Grove","address":"2250 Easton Road","city":"Willow Grove","state":"PA","zip":"19090","phone":"(215)657-2897","distance":1.0067916513917736,"hours":{"mon":{"open":"6:00","close":"21:00"},"tue":{"open":"6:00","close":"21:00"},"wed":{"open":"6:00","close":"21:00"},"thu":{"open":"6:00","close":"21:00"},"fri":{"open":"6:00","close":"21:00"},"sat":{"open":"6:00","close":"21:00"},"sun":{"open":"7:00","close":"20:00"}},"products":{"302040042":{"name":"Double 4 in. x 150 in. Autumn Tan Lap Vinyl Siding","description":"No Paint. No Stain. No hassles. That is the beauty and value of Transformations vinyl siding from Ply Gem Performance Collection. Transformations is an excellent choice for a virtually carefree, amazing home exterior. Transformations comes in 13 beautiful colors, and featured profiles of Double 4 in., Double 5 in. and Double 4 1/2 in. Dutch Lap.","url":"/p/Double-4-in-x-150-in-Autumn-Tan-Lap-Vinyl-Siding-PC40M6HP/302040042","imageUrl":"https://images.thdstatic.com/productImages/f3b94555-5a11-4ada-b2ed-51c826d7f484/svn/autumn-vinyl-siding-pc40m6hp-64_1000.jpg","quantityAvailable":0,"priceCentsPerUnit":869,"salePriceCentsPerUnit":null,"bulkPriceCentsPerUnit":null}}}}}
                                                                                                                                                                                                                    
                                                                                                    

通过邮政编码查询产品的结果 - 代码片段


curl --location --request POST 'https://zylalabs.com/api/11655/%e5%ae%b6%e5%be%97%e5%ae%9d%e4%ba%a7%e5%93%81%e6%9f%a5%e8%af%a2+api/22009/%e9%80%9a%e8%bf%87%e9%82%ae%e6%94%bf%e7%bc%96%e7%a0%81%e6%9f%a5%e8%af%a2%e4%ba%a7%e5%93%81%e7%9a%84%e7%bb%93%e6%9e%9c' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
    "asyncId": "homedepot:84e55fd8f9582f248996285ff507ff01960bd3344101b05f15f22ef9b49c8437"
}'

    

获取特定邮政编码的单个产品并通过回调获取结果


                                                                            
POST https://www.zylalabs.com/api/11655/%e5%ae%b6%e5%be%97%e5%ae%9d%e4%ba%a7%e5%93%81%e6%9f%a5%e8%af%a2+api/22010/%e6%8c%89%e9%82%ae%e6%94%bf%e7%bc%96%e7%a0%81%e6%9f%a5%e6%89%be%e4%ba%a7%e5%93%81%e5%b9%b6%e5%9b%9e%e8%b0%83
                                                                            
                                                                        

按邮政编码查找产品并回调 - 端点功能

对象 描述
请求体 [必需] Json
测试端点

API 示例响应

       
                                                                                                        
                                                                                                                                                                                                                                                                                                                                        {"asyncId":"homedepot:84e55fd8f9582f248996285ff507ff01960bd3344101b05f15f22ef9b49c8437"}
                                                                                                                                                                                                                    
                                                                                                    

按邮政编码查找产品并回调 - 代码片段


curl --location --request POST 'https://zylalabs.com/api/11655/%e5%ae%b6%e5%be%97%e5%ae%9d%e4%ba%a7%e5%93%81%e6%9f%a5%e8%af%a2+api/22010/%e6%8c%89%e9%82%ae%e6%94%bf%e7%bc%96%e7%a0%81%e6%9f%a5%e6%89%be%e4%ba%a7%e5%93%81%e5%b9%b6%e5%9b%9e%e8%b0%83' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
    "zip": "19090",
    "productId": "302040042",
    "callback": "https://maplerope.com"
}'

    

API 访问密钥和身份验证

注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 家得宝产品查询 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
标头
标头 描述
授权 [必需] 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。

简单透明的定价

无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。

🚀 企业版

起价
$ 10,000/年


  • 自定义数量
  • 自定义速率限制
  • 专业客户支持
  • 实时 API 监控

客户喜爱的功能

  • ✔︎ 仅支付成功请求
  • ✔︎ 7 天免费试用
  • ✔︎ 多语言支持
  • ✔︎ 一个 API 密钥,所有 API。
  • ✔︎ 直观的仪表板
  • ✔︎ 全面的错误处理
  • ✔︎ 开发者友好的文档
  • ✔︎ Postman 集成
  • ✔︎ 安全的 HTTPS 连接
  • ✔︎ 可靠的正常运行时间

家得宝产品查询 API FAQs

美国家得宝产品查找API是一个工具,允许用户通过提供产品ID和邮政编码来获取家得宝产品的实时定价和可用性

API直接从Home Depot的库存中检索最新的价格和可用性信息,确保用户可以访问到最新的数据

该API需要两个必填输入:邮政编码,用于指示产品的位置,以及产品ID,用于唯一标识该产品

是的,该API允许用户根据提供的邮政编码检查库存水平并比较附近Home Depot地点的价格

'noWait'参数设置为true时,允许API立即返回asyncId以便后续轮询,而不是等待查找完成

API如果查找快速完成则直接返回产品详细信息,否则提供一个asyncId以便后续获取结果

企业可以使用 API 通过检查实时库存水平和价格来有效管理供应,帮助他们做出明智的采购决策

是的 DIY爱好者可以使用API在当地的家得宝商店找到他们项目所需产品的最佳价格和库存情况

邮政编码输入非常重要,因为它决定了附近的家得宝位置以检查产品的可用性和定价

是的,该API旨在便于集成,使开发者能够快速将其实现到应用程序、工具或网站中

关键特性包括实时数据检索 基于位置的结果 通过价格比较实现高效购物 以及简单的集成

通过提供最新的库存信息和定价,API提升了购物体验,帮助用户快速找到最优惠的交易和可用性

每个端点返回详细的产品信息,包括特定商店的库存情况 产品描述和商店联系方式 例如 响应包括商店名称 地址和营业时间 以及产品名称和描述

响应数据中的关键字段包括 `asyncId`、`stores`(包含商店详情)和 `products`(包含如 `name`、`description` 和 `id` 的产品详情)这些字段帮助用户识别产品的可用性和商店位置

响应数据以JSON格式结构化,包含嵌套的`stores`和`products`对象。每个商店条目包含其ID、名称、地址和营业时间,而每个产品条目包括其唯一ID、名称和描述

每个端点提供有关产品可用性、商店位置和营业时间的信息 `POST按邮政编码查找产品`端点获取即时产品详细信息,而`POST按邮政编码查找产品结果`端点从之前的请求中获取结果

用户可以通过指定`zip`代码和`productId`来自定义请求,以针对特定位置和产品 可选的`noWait`和`callback`参数允许异步处理,提高请求的灵活性

在响应中 `asyncId` 表示请求异步结果,而 `stores` 包含每个商店的ID、名称、地址和营业时间的信息 `products` 字段提供有关产品的详细信息,包括其名称和描述

典型的用例包括检查家居装修项目的产品可用性 比较多个家得宝店铺的价格 以及管理依赖特定产品的企业的库存

通过直接从家得宝的库存系统获取实时信息来保持数据的准确性 定期的更新和检查确保提供的信息反映当前的库存水平和产品细节

通过邮政编码查询产品的接口提供有关特定商店产品可用性的详细信息,包括商店名称 地址 电话号码 和营业时间 它还返回产品的详细信息,例如名称 描述 和唯一产品ID

用户可以通过提取商店和产品信息来利用返回的数据,从而做出明智的购买决策。例如,他们可以识别出最近的商店及其所需产品的可用性,帮助简化购物体验

该端点接受参数,例如 `zip`(必需),`productId`(必需),`noWait`(可选)和 `callback`(可选)这些参数允许用户指定位置和产品,以及控制异步处理的响应格式

在响应中 `asyncId` 表示异步请求结果 `stores` 包含每个商店的 ID 名称 地址和营业时间的信息 `products` 字段提供产品的详细信息 包括其名称和描述 对于识别可用性至关重要

数据的准确性是通过直接从家得宝的库存系统获取实时信息来确保的 定期进行更新和检查以维护数据的完整性 确保用户接收到最新的库存水平和产品细节

如果API返回部分或空结果,用户应该验证输入参数的准确性,例如邮政编码和产品ID。此外,他们可以检查附近的商店或替代产品,以确保找到所需的信息

该API涵盖指定邮政编码内的所有Home Depot地点,提供对这些商店提供的广泛产品类别的访问。这使得用户可以在各种家居改善和建筑类别中找到产品

一般常见问题

Zyla API Hub 就像一个大型 API 商店,您可以在一个地方找到数千个 API。我们还为所有 API 提供专门支持和实时监控。注册后,您可以选择要使用的 API。请记住,每个 API 都需要自己的订阅。但如果您订阅多个 API,您将为所有这些 API 使用相同的密钥,使事情变得更简单。

价格以 USD(美元)、EUR(欧元)、CAD(加元)、AUD(澳元)和 GBP(英镑)列出。我们接受所有主要的借记卡和信用卡。我们的支付系统使用最新的安全技术,由 Stripe 提供支持,Stripe 是世界上最可靠的支付公司之一。如果您在使用卡片付款时遇到任何问题,请通过 [email protected]


此外,如果您已经以这些货币中的任何一种(USD、EUR、CAD、AUD、GBP)拥有有效订阅,该货币将保留用于后续订阅。只要您没有任何有效订阅,您可以随时更改货币。

定价页面上显示的本地货币基于您 IP 地址的国家/地区,仅供参考。实际价格以 USD(美元)为单位。当您付款时,即使您在我们的网站上看到以本地货币显示的等值金额,您的卡片对账单上也会以美元显示费用。这意味着您不能直接使用本地货币付款。

有时,银行可能会因其欺诈保护设置而拒绝收费。我们建议您首先联系您的银行,检查他们是否阻止了我们的收费。此外,您可以访问账单门户并更改关联的卡片以进行付款。如果这些方法不起作用并且您需要进一步帮助,请通过 [email protected]

价格由月度或年度订阅决定,具体取决于所选计划。

API 调用根据成功请求从您的计划中扣除。每个计划都包含您每月可以进行的特定数量的调用。只有成功的调用(由状态 200 响应指示)才会计入您的总数。这确保失败或不完整的请求不会影响您的月度配额。

Zyla API Hub 采用月度订阅系统。您的计费周期将从您购买付费计划的那一天开始,并在下个月的同一日期续订。因此,如果您想避免未来的费用,请提前取消订阅。

要升级您当前的订阅计划,只需转到 API 的定价页面并选择您要升级到的计划。升级将立即生效,让您立即享受新计划的功能。请注意,您之前计划中的任何剩余调用都不会转移到新计划,因此在升级时请注意这一点。您将被收取新计划的全部金额。

要检查您本月剩余多少 API 调用,请参考响应标头中的 "X-Zyla-API-Calls-Monthly-Remaining" 字段。例如,如果您的计划允许每月 1,000 个请求,而您已使用 100 个,则响应标头中的此字段将显示 900 个剩余调用。

要查看您的计划允许的最大 API 请求数,请检查 "X-Zyla-RateLimit-Limit" 响应标头。例如,如果您的计划包括每月 1,000 个请求,此标头将显示 1,000。

"X-Zyla-RateLimit-Reset" 标头显示您的速率限制重置之前的秒数。这告诉您何时您的请求计数将重新开始。例如,如果它显示 3,600,则意味着还有 3,600 秒直到限制重置。

是的,您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意,升级、降级和取消会立即生效。此外,取消后,您将不再有权访问该服务,即使您的配额中还有剩余调用。

您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线,时间为上午 8 点至下午 5 点(EST)。如果您在该时间之后联系我们,我们将尽快回复您。此外,您可以通过 [email protected]

为了让您有机会在没有任何承诺的情况下体验我们的 API,我们提供 7 天免费试用,允许您免费进行最多 50 次 API 调用。此试用只能使用一次,因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用,但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束,以先发生者为准。如果您在试用期间达到 50 次请求限制,您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者,如果您在第 7 天之前不取消订阅,您的免费试用将结束,您的计划将自动计费,授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。

7 天后,您将被收取试用期间订阅的计划的全额费用。因此,在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。

当您订阅 API 免费试用时,您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用,API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。

付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求,您的付款将在此时间范围内处理。


相关 API