Home Depot Keyword Search
Give a Home Depot category ID, keyword, sort order, and expected count to get public search products with price, rating, category, and links.
Overview
Shoppers on Home Depot usually decide from search cards long before they open a product page: the title, the price on the card, the rating, the category path, and the product link. This app turns one category ID and keyword into a structured table of those public search listings so assortment, pricing, and category work can start from the same view a shopper would see.
Each row keeps the keyword, category, and original search item beside the product, so later comparisons stay attached to the query that produced them. It is a search-result workbook, not a substitute for a full product page.
Data notes
Each row is one product from a public Home Depot keyword search. Rows are returned in collection-time order from earliest to latest, and the same SKU ID is kept once in the returned set. Price, Rating, and Review count are the values shown on the search listing at collection time; Price is a number as returned and is not a normalized checkout total. Category name, Category path, and Category URL describe the listing's category snapshot, which can differ from other categories the same product appears in. Collected at and Source date are returned without a timezone. Keyword, Search item, Business ID, and Source item repeat the search context across rows from the same query.
The collection does not cover product-detail pages, variants, inventory history, orders, or seller-backend data, and it does not include listings that are not visible on the public search page. A No-data marker distinguishes a search item that produced no products from ordinary product rows.
What a result looks like
Each row is one Home Depot search-result product.
| Product title | SKU ID | Price | Rating | Review count | Product URL |
|---|---|---|---|---|---|
| SOLIX E10 Infinite Automatic Backup Kits 24kWh, 7,680-Watt Running Wattages, Air-Cooled WholeHouse Generator | 1015533081 | 15130.6 | 5.0 | 1 | https://www.homedepot.com/p/Anker-SOLIX-E10-Infinite-Automatic-Backup-Kits-24kWh-7-680-Watt-Running-Wattages-Air-Cooled-WholeHouse-Generator-AnkerSolix-E10-2-Auto-backup2/341855752 |
| SOLIX E10 Infinite Automatic Backup Kits, 12kWh/15.2kW Rated Output, 5X Backup Time, Air-Cooled WholeHouse Generator | 1015533079 | 11698.0 | 0.0 | 0 | https://www.homedepot.com/p/Anker-SOLIX-E10-Infinite-Automatic-Backup-Kits-12kWh-15-2kW-Rated-Output-5X-Backup-Time-Air-Cooled-WholeHouse-Generator-AnkerSolix-E10-2-Auto-backup1/341855718 |
Category name, Category path, Keyword, and Collected at are also available when the listing shows them.
Use cases
- For assortment checks, group rows by Keyword and Category name, then scan Product title and SKU ID to see which products occupy the first results for a query.
- For list-price comparison, rank Price against Rating and Review count to see which cards look like premium versus entry listings.
- For category mapping, read Category path with Category URL to see where Home Depot places the same keyword results.
- For link harvesting, copy Product URL with Canonical path to open or archive the same search cards.
Scope and boundaries
One category-and-keyword search per task with an expected result count from 1 to 1000; coverage is limited to public Home Depot search listings.
- Good for
- When you need public Home Depot search listings for one category ID and keyword.
- When you need to compare list-page prices, ratings, review counts, categories, and product links from search results.
- Do not use for
- When you need a full product page, variants, inventory history, or specifications beyond the search listing.
- When you need orders, seller-backend data, or non-public Home Depot business data.
Failure handling
Failure and retry behavior declared by the author. We recommend including it in your system prompt when integrating.
- 1If no products are returned, confirm the category ID and keyword combination is searchable on public Home Depot, then retry with a broader keyword.
- 2Keep completed records after a partial success; resubmit the same input after a failed or expired task.
- 3Retry later after rate limiting, temporary unavailability, or a timeout.
- 4If authentication fails, verify the API Key configured for the execution environment.
Input
Parameters required to call this App, generated from the input.schema in manifest.json.
| Field | Business name | Type | Required | Default | Enum / Constraints | Example | Description |
|---|---|---|---|---|---|---|---|
| item | Category ID and keyword | string | Yes | — | — | 5yc1vZmqo&&&&Anker | Enter one Home Depot search as category ID, four ampersands, then the keyword, such as 5yc1vZmqo&&&&Anker. Both parts are required and the whole value must be 512 characters or fewer. |
| crawl_count | Expected result count | string | Yes | — | — | 2 | Expected number of search-result products, from 1 to 1000. The actual count may be slightly lower. Larger values take longer and cost more. |
| order_type | Sort order | string(enum) | Yes | — | 21 (Top selling) / 51 (Price low to high) / 52 (Price high to low) / 6 (Featured products) / 13 (Most popular) | 51 | Choose how Home Depot search results are sorted for this task. |
Output
Field structure of a single record, generated from the output.schema in manifest.json.
| Field | Business name | Type | Example | Description |
|---|---|---|---|---|
| biz_id | Business ID | string | 5yc1vZmqo&&&&Anker | Search item key repeated on this product row. |
| canonical_url | Canonical path | string | /p/Anker-SOLIX-E10-Infinite-Automatic-Backup-Kits-24kWh-7-680-Watt-Running-Wattages-Air-Cooled-WholeHouse-Generator-AnkerSolix-E10-2-Auto-backup2/341855752 | Site-relative canonical path of the product page. |
| category_id | Category ID | string | 5yc1vZmqo | Home Depot category identifier shown for this listing. |
| category_level | Category level | integer | 4 | Depth of the listing category in the Home Depot category tree. |
| category_name | Category name | string | Home Standby Generators | Leaf category name shown for this search listing. |
| category_path | Category path | string | Outdoors:Outdoor Power Equipment:Generators:Home Standby Generators | Colon-separated category path from the search listing. |
| category_url | Category URL | string | https://www.homedepot.com/b/Anker/N-5yc1vZmqo | Public Home Depot URL for the listing category. |
| crawl_time | Collected at | string | 2026-09-11T14:48:15 | Collection timestamp of this listing as returned, without a timezone. |
| item | Search item | string | 5yc1vZmqo&&&&Anker | Category ID and keyword pair that produced this product row. |
| keyword | Keyword | string | Anker | Keyword used in the Home Depot search. |
| price | Price | number | 15130.6 | Search-listing display price as a number at collection time, not a checkout total. |
| product_title | Product title | string | SOLIX E10 Infinite Automatic Backup Kits 24kWh, 7,680-Watt Running Wattages, Air-Cooled WholeHouse Generator | Product title shown on the search listing. |
| product_url | Product URL | string | https://www.homedepot.com/p/Anker-SOLIX-E10-Infinite-Automatic-Backup-Kits-24kWh-7-680-Watt-Running-Wattages-Air-Cooled-WholeHouse-Generator-AnkerSolix-E10-2-Auto-backup2/341855752 | Public Home Depot product page URL for this listing. |
| rating_score | Rating | number | 5 | Average rating shown on the search listing at collection time. |
| review_count | Review count | integer | 1 | Number of reviews shown on the search listing at collection time. |
| sku_id | SKU ID | string | 1015533081 | SKU identifier for this search-result product. |
| source_create_time_ms | Source time | integer | 1789109295968 | Source create time in milliseconds as returned. |
| source_date | Source date | string | 2026-09-11 | Source date of this listing as returned. |
| spu_id | Product ID | string | 341855752 | Home Depot product identifier for this listing. |
| task_item | Source item | string | 5yc1vZmqo&&&&Anker | Task search item associated with this row. |
| no_data | No-data marker | boolean | false | Whether this search item produced no products. |
Record schema
Output is returned record by record. detail.output.idFieldHint
{
"type": "object",
"properties": {
"biz_id": {
"type": "string",
"title": "Business ID",
"description": "Search item key repeated on this product row.",
"prefill": "5yc1vZmqo&&&&Anker"
},
"canonical_url": {
"type": "string",
"title": "Canonical path",
"description": "Site-relative canonical path of the product page.",
"prefill": "/p/Anker-SOLIX-E10-Infinite-Automatic-Backup-Kits-24kWh-7-680-Watt-Running-Wattages-Air-Cooled-WholeHouse-Generator-AnkerSolix-E10-2-Auto-backup2/341855752"
},
"category_id": {
"type": "string",
"title": "Category ID",
"description": "Home Depot category identifier shown for this listing.",
"prefill": "5yc1vZmqo"
},
"category_level": {
"type": "integer",
"title": "Category level",
"description": "Depth of the listing category in the Home Depot category tree.",
"prefill": 4
},
"category_name": {
"type": "string",
"title": "Category name",
"description": "Leaf category name shown for this search listing.",
"prefill": "Home Standby Generators"
},
"category_path": {
"type": "string",
"title": "Category path",
"description": "Colon-separated category path from the search listing.",
"prefill": "Outdoors:Outdoor Power Equipment:Generators:Home Standby Generators"
},
"category_url": {
"type": "string",
"title": "Category URL",
"description": "Public Home Depot URL for the listing category.",
"prefill": "https://www.homedepot.com/b/Anker/N-5yc1vZmqo"
},
"crawl_time": {
"type": "string",
"title": "Collected at",
"description": "Collection timestamp of this listing as returned, without a timezone.",
"prefill": "2026-09-11T14:48:15"
},
"item": {
"type": "string",
"title": "Search item",
"description": "Category ID and keyword pair that produced this product row.",
"prefill": "5yc1vZmqo&&&&Anker"
},
"keyword": {
"type": "string",
"title": "Keyword",
"description": "Keyword used in the Home Depot search.",
"prefill": "Anker"
},
"price": {
"type": "number",
"title": "Price",
"description": "Search-listing display price as a number at collection time, not a checkout total.",
"prefill": 15130.6
},
"product_title": {
"type": "string",
"title": "Product title",
"description": "Product title shown on the search listing.",
"prefill": "SOLIX E10 Infinite Automatic Backup Kits 24kWh, 7,680-Watt Running Wattages, Air-Cooled WholeHouse Generator"
},
"product_url": {
"type": "string",
"title": "Product URL",
"description": "Public Home Depot product page URL for this listing.",
"prefill": "https://www.homedepot.com/p/Anker-SOLIX-E10-Infinite-Automatic-Backup-Kits-24kWh-7-680-Watt-Running-Wattages-Air-Cooled-WholeHouse-Generator-AnkerSolix-E10-2-Auto-backup2/341855752"
},
"rating_score": {
"type": "number",
"title": "Rating",
"description": "Average rating shown on the search listing at collection time.",
"prefill": 5
},
"review_count": {
"type": "integer",
"title": "Review count",
"description": "Number of reviews shown on the search listing at collection time.",
"prefill": 1
},
"sku_id": {
"type": "string",
"title": "SKU ID",
"description": "SKU identifier for this search-result product.",
"prefill": "1015533081"
},
"source_create_time_ms": {
"type": "integer",
"title": "Source time",
"description": "Source create time in milliseconds as returned.",
"prefill": 1789109295968
},
"source_date": {
"type": "string",
"title": "Source date",
"description": "Source date of this listing as returned.",
"prefill": "2026-09-11"
},
"spu_id": {
"type": "string",
"title": "Product ID",
"description": "Home Depot product identifier for this listing.",
"prefill": "341855752"
},
"task_item": {
"type": "string",
"title": "Source item",
"description": "Task search item associated with this row.",
"prefill": "5yc1vZmqo&&&&Anker"
},
"no_data": {
"type": "boolean",
"title": "No-data marker",
"description": "Whether this search item produced no products.",
"prefill": false
}
},
"required": [],
"additionalProperties": false
}Integration
This App can be integrated via MCP, API, SDK, or file export. All channels share the same capabilities and pricing. Every request authenticates with the Authorization: Bearer header using an API key (long-lived, created in the Data Hub Console); MCP clients can also sign in with OAuth, no key required. More options such as CLI and Skill are on the way.
With the MCP (Model Context Protocol), you can call this App directly from AI clients like Claude and Cursor. Pick your client and auth mode, then copy the config below.
Client config
Replace the value after Bearer with your long-lived API key. Works in any client, CI, or headless environment.
{
"mcpServers": {
"hello_moto__homedepot-keyword-search": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=hello_moto/homedepot-keyword-search",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}Let AI set it up for you
Don't want to edit configs by hand? Copy the install prompt and paste it into any AI client. It will complete the setup its own way. (The prompt asks the AI to request your API key from you, so credentials never end up in chat history or shared configs.)
detail.access.mcp.composeHint
Pricing
Charged once per submitted run, regardless of how many records are returned.
Charged by the number of records successfully returned. Failed runs are not charged. Billed in units of 24 record; any partial unit is rounded up to 24 record.
Multiple billing events accumulate independently. See each item for details. Failed runs are not charged.
View creditsTry it now
Fill in the parameters and run. Results come from a real call.