logo
languageENdown
menu

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 titleSKU IDPriceRatingReview countProduct URL
SOLIX E10 Infinite Automatic Backup Kits 24kWh, 7,680-Watt Running Wattages, Air-Cooled WholeHouse Generator101553308115130.65.01https://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 Generator101553307911698.00.00https://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.

  1. 1If no products are returned, confirm the category ID and keyword combination is searchable on public Home Depot, then retry with a broader keyword.
  2. 2Keep completed records after a partial success; resubmit the same input after a failed or expired task.
  3. 3Retry later after rate limiting, temporary unavailability, or a timeout.
  4. 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.

FieldBusiness nameTypeRequiredDefaultEnum / ConstraintsExampleDescription
itemCategory ID and keywordstringYes——5yc1vZmqo&&&&AnkerEnter 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_countExpected result countstringYes——2Expected number of search-result products, from 1 to 1000. The actual count may be slightly lower. Larger values take longer and cost more.
order_typeSort orderstring(enum)Yes—21 (Top selling) / 51 (Price low to high) / 52 (Price high to low) / 6 (Featured products) / 13 (Most popular)51Choose 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.

FieldBusiness nameTypeExampleDescription
biz_idBusiness IDstring5yc1vZmqo&&&&AnkerSearch item key repeated on this product row.
canonical_urlCanonical pathstring/p/Anker-SOLIX-E10-Infinite-Automatic-Backup-Kits-24kWh-7-680-Watt-Running-Wattages-Air-Cooled-WholeHouse-Generator-AnkerSolix-E10-2-Auto-backup2/341855752Site-relative canonical path of the product page.
category_idCategory IDstring5yc1vZmqoHome Depot category identifier shown for this listing.
category_levelCategory levelinteger4Depth of the listing category in the Home Depot category tree.
category_nameCategory namestringHome Standby GeneratorsLeaf category name shown for this search listing.
category_pathCategory pathstringOutdoors:Outdoor Power Equipment:Generators:Home Standby GeneratorsColon-separated category path from the search listing.
category_urlCategory URLstringhttps://www.homedepot.com/b/Anker/N-5yc1vZmqoPublic Home Depot URL for the listing category.
crawl_timeCollected atstring2026-09-11T14:48:15Collection timestamp of this listing as returned, without a timezone.
itemSearch itemstring5yc1vZmqo&&&&AnkerCategory ID and keyword pair that produced this product row.
keywordKeywordstringAnkerKeyword used in the Home Depot search.
pricePricenumber15130.6Search-listing display price as a number at collection time, not a checkout total.
product_titleProduct titlestringSOLIX E10 Infinite Automatic Backup Kits 24kWh, 7,680-Watt Running Wattages, Air-Cooled WholeHouse GeneratorProduct title shown on the search listing.
product_urlProduct URLstringhttps://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/341855752Public Home Depot product page URL for this listing.
rating_scoreRatingnumber5Average rating shown on the search listing at collection time.
review_countReview countinteger1Number of reviews shown on the search listing at collection time.
sku_idSKU IDstring1015533081SKU identifier for this search-result product.
source_create_time_msSource timeinteger1789109295968Source create time in milliseconds as returned.
source_dateSource datestring2026-09-11Source date of this listing as returned.
spu_idProduct IDstring341855752Home Depot product identifier for this listing.
task_itemSource itemstring5yc1vZmqo&&&&AnkerTask search item associated with this row.
no_dataNo-data markerbooleanfalseWhether this search item produced no products.

Record schema

Output is returned record by record. detail.output.idFieldHint

output.schema
{
  "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 config
{
  "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

per task start

Charged once per submitted run, regardless of how many records are returned.

$0.0001/ run
per product record

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.

$0.005/ 24 record

Multiple billing events accumulate independently. See each item for details. Failed runs are not charged.

View credits

Try it now

Fill in the parameters and run. Results come from a real call.

Example
Parameters are validated against input.schema before submission
Please fill in the required parameters first
From $0.005 / 24 record