FR

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.

Source · en-USRevenir à la traduction

Développeur
Tarifs
À partir de 0,005 $US / 24 enregistrements
Dernière mise à jour
2026-09-18

Aperçu

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.

Périmètre et limites

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.

  • Adapté pour
  • 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.
  • À ne pas utiliser pour
  • 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.

Gestion des échecs

Comportement en cas d'échec et de nouvelle tentative déclaré par le développeur. Nous vous recommandons de l'inclure dans votre prompt système lors de l'intégration.

  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.

Entrée

Paramètres requis pour appeler cette App, générés à partir de l'input.schema du manifest.json.

  • Category ID and keyworditemRequisstring
    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.
    Exemple5yc1vZmqo&&&&Anker
  • Expected result countcrawl_countRequisstring
    Expected number of search-result products, from 1 to 1000. The actual count may be slightly lower. Larger values take longer and cost more.
    Exemple2
  • Sort orderorder_typeRequisstring(enum)
    Choose how Home Depot search results are sorted for this task.
    Valeurs possiblesTop selling21Price low to high51Price high to low52Featured products6Most popular13Exemple51

Sortie

Structure des champs d'un enregistrement, générée à partir de l'output.schema du manifest.json.

  • Business IDbiz_idstring
    Search item key repeated on this product row.
    Exemple5yc1vZmqo&&&&Anker
  • Canonical pathcanonical_urlstring
    Site-relative canonical path of the product page.
    Exemple/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 IDcategory_idstring
    Home Depot category identifier shown for this listing.
    Exemple5yc1vZmqo
  • Category levelcategory_levelinteger
    Depth of the listing category in the Home Depot category tree.
    Exemple4

Exemple de données

Généré à partir d'output.schema. Les champs sans valeur d'exemple utilisent des espaces réservés structurels.

output.example
{
  "biz_id": "5yc1vZmqo&&&&Anker",
  "canonical_url": "/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": "5yc1vZmqo",
  "category_level": 4,
  "category_name": "Home Standby Generators",
  "category_path": "Outdoors:Outdoor Power Equipment:Generators:Home Standby Generators",
  "category_url": "https://www.homedepot.com/b/Anker/N-5yc1vZmqo",
  "crawl_time": "2026-09-11T14:48:15",
  "item": "5yc1vZmqo&&&&Anker",
  "keyword": "Anker",
  "price": 15130.6,
  "product_title": "SOLIX E10 Infinite Automatic Backup Kits 24kWh, 7,680-Watt Running Wattages, Air-Cooled WholeHouse Generator",
  "product_url": "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": 5,
  "review_count": 1,
  "sku_id": "1015533081",
  "source_create_time_ms": 1789109295968,
  "source_date": "2026-09-11",
  "spu_id": "341855752",
  "task_item": "5yc1vZmqo&&&&Anker",
  "no_data": false
}

Intégration

Cette App peut être intégrée via MCP, API, SDK ou export de fichiers — tous les canaux partagent les mêmes capacités et la même tarification. Chaque requête s'authentifie avec l'en-tête Authorization: Bearer à l'aide d'une API Key (longue durée, créée dans la console Data Hub) ; les clients MCP peuvent aussi se connecter via OAuth, sans clé. D'autres options comme la CLI et Skill arrivent bientôt. Cette App s'exécute de manière asynchrone et peut être annulée en cours de route : Après l'annulation, l'exécution s'arrête. Les enregistrements déjà livrés sont conservés et facturés.

Avec MCP (Model Context Protocol), vous pouvez appeler cette App directement depuis des clients IA comme Claude et Cursor. Choisissez votre client et votre mode d'authentification, puis copiez la config ci-dessous.

Config du client

Remplacez la valeur après Bearer par votre API Key longue durée. Fonctionne dans n'importe quel client, en CI ou en environnement sans navigateur.

mcpServers config
{
  "mcpServers": {
    "octoparse_datahub": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=hello_moto/homedepot-keyword-search",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

Laissez l'IA tout configurer pour vous

Vous ne voulez pas modifier les configs à la main ? Copiez le prompt d'installation et collez-le dans n'importe quel client IA — il effectuera la configuration à sa manière. (Par défaut, il vous guide pour vous connecter et ne vous demande jamais d'envoyer votre API Key dans la conversation.)

detail.access.mcp.composeHint

Tarifs

per task start

Facturé une fois par exécution soumise, quel que soit le nombre d'enregistrements renvoyés.

0,0001 $US/ exécution
per product record

Facturé selon le nombre d'enregistrements renvoyés avec succès. Les exécutions échouées ne sont pas facturées. Facturé par unités de 24 enregistrements ; toute unité incomplète est arrondie à 24 enregistrements.

0,005 $US/ 24 enregistrements

Plusieurs événements de facturation se cumulent indépendamment. Voir chaque élément pour les détails. Les exécutions échouées ne sont pas facturées.

Voir les crédits

Essayer maintenant

Renseignez les paramètres et lancez l'exécution — les résultats proviennent d'un appel réel.

Exemple
Les paramètres sont validés par rapport à l'input.schema avant la soumission
À partir de 0,005 $US / 24 enregistrements