# Home Depot Scraper - Products, Prices, Store Stock & Reviews (`topapi/home-depot-scraper`) Actor

Scrape homedepot.com products from any search, category, product link or item id: price, was price, Special Buy and clearance, model, store SKU, rating, shelf stock and aisle/bay at your store. Add details (UPC, specs), stock at nearby stores, reviews and Q\&A. $0.40 per 1,000 products.

- **URL**: https://apify.com/topapi/home-depot-scraper.md
- **Developed by:** [Top Api](https://apify.com/topapi) (community)
- **Categories:** E-commerce, Business, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.40 / 1,000 products

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Home Depot Scraper - Products, Prices, Store Stock & Reviews

Scrape **homedepot.com** products from any search, category link, product link or item id. Every product row carries
the price at the store you choose, the was price and savings, Special Buy and clearance flags, unit and bulk prices,
rating and ratings count, model number, store SKU, badges, category path, key features, images, and the store's own
**shelf quantity, aisle and bay**, plus pickup, ship-to-store and delivery options for your ZIP code. Turn on the add-ons
for **product details** (description, bullets, specifications, UPC / GTIN-13, every image, videos, manuals), **stock at
nearby stores** (price, quantity, aisle and bay at each), **customer reviews** and **questions & answers**. Run it on a
schedule with **monitor mode** to get only new products, price changes and stock changes.

### What you can do with it

- Track Home Depot prices, Special Buys and clearance for any keyword or category, at any store.
- Read up to 744 products per search in each sort order; ask for more and the run reads the same search again in price
  order (low to high, high to low, top rated, newest), without repeats - a test run read 2,832 distinct
  products from one `ceiling fans` search.
- Look up products by item id or product link, 24 at a time, with the price and shelf stock at a chosen store.
- Find the aisle and bay of a product in a store, and which stores near a ZIP code have it on the shelf.
- Get UPCs, model numbers, specifications and manuals of a product list for catalog matching.
- Collect reviews (with photos and brand replies) and customer questions with their answers.
- Watch a search, a category or a product list for new products, price changes and stock changes.

### Input

| Field | What it does |
|---|---|
| `searchQueries` | Words to search on Home Depot, one per line (`cordless drill`, `ceiling fan`). A model number or a 9-digit item id works too. Keywords Home Depot sends to a category page (like `cordless drill`) read that category. |
| `startUrls` | homedepot.com links: categories (`/b/Tools-Power-Tools-Drills/N-5yc1vZc27f`), searches (`/s/hammer`) and products (`/p/.../313483106`). |
| `productIds` | Item ids (the 9-digit number at the end of a product link; also called Internet # or OMSID). |
| `navParams` | Category codes, the `N-...` part of a category link (advanced; same as pasting the link). |
| `maxResultsPerQuery` | Products per search or category (default 100, up to 3,000; past 744 the other sort orders are read, see above). |
| `maxItems` | Products for the whole run (empty = no run-wide cap). |
| `sortBy` | `best_match`, `top_sellers`, `price_low_to_high`, `price_high_to_low`, `top_rated`, `newest`, `most_popular`, `brand` (Home Depot's own sort). Default: Best Match for keywords, Top Sellers for categories. |
| `zipCode` | US ZIP code: prices, stock and aisle/bay come from the nearest store (unless `storeId` is set), delivery dates are for this ZIP. Default 30339 (Atlanta). |
| `storeId` | A Home Depot store number (default 121, Cumberland, Atlanta GA). |
| `storeFilter` | `all`, `in_store` (sold at the store) or `online` - Home Depot's own filter. |
| `minPrice`, `maxPrice` | Price range in dollars. |
| `brand` | Only these brands, comma-separated (`DEWALT, Milwaukee`). On a category, the brands go into Home Depot's own Brand filter. |
| `minRating` | Only products rated at least this many stars. |
| `onlyOnSale`, `minDiscountPercent`, `onlyClearance`, `onlySpecialBuy` | Deal filters. |
| `onlyInStock` | Only products on the chosen store's shelf now. |
| `includeDetails` | Add details to each product (charged per product with details). |
| `includeStoreAvailability`, `maxStores`, `radiusMiles`, `storeIds`, `inStockStoresOnly` | Add stock at nearby stores (charged per store listed; default the 5 stores nearest the ZIP within 25 miles, or the store numbers you list). |
| `includeReviews`, `maxReviewsPerProduct`, `reviewsSort`, `reviewsVerifiedOnly`, `reviewStars`, `reviewsNewerThan`, `reviewsSearchTerm`, `reviewsWithPhotosOnly`, `minHelpfulVotes` | Add review rows (charged per review; default 20 per product, newest first). |
| `includeQuestions`, `maxQuestionsPerProduct` | Add question rows with their answers (charged per question; default 10 per product). |
| `includeFacets` | Add one free row per search with Home Depot's filter groups (brands, price ranges, ratings, features) and their product counts, and the related searches Home Depot shows for a category. |
| `monitorMode`, `monitorName`, `minQuantityChange`, `resetMonitor` | Monitor mode (below). |
| `webhookUrl` | Optional: a POST with a summary of the delivered products when the run ends. |
| `proxyConfiguration` | Optional. The run reads Home Depot directly and moves to Apify proxies by itself when it is refused. |

Input names used by other Home Depot scrapers are accepted too (`keywords`, `searchTerms`, `categoryUrls`,
`productUrls`, `itemIds`, `maxResults`, `maxProductsPerSearch`, `sort`, `zip`, `includeProductDetails`,
`includeStoreInventory`, `onlyChanges`, `trackChanges`, ...).

#### Example inputs

A keyword, 200 products, cheapest first, at the store nearest a ZIP code:

```json
{ "searchQueries": ["ceiling fan"], "maxResultsPerQuery": 200, "sortBy": "price_low_to_high", "zipCode": "10001" }
```

A category, DEWALT and Milwaukee only, in stock at store 6140 (Midtown Manhattan):

```json
{
  "startUrls": ["https://www.homedepot.com/b/Tools-Power-Tools-Drills/N-5yc1vZc27f"],
  "brand": "DEWALT, Milwaukee", "onlyInStock": true, "storeId": "6140"
}
```

Products by item id with details and stock at 5 stores near Manhattan:

```json
{ "productIds": ["313483106", "308067489"], "includeDetails": true, "includeStoreAvailability": true, "zipCode": "10001", "maxStores": 5 }
```

Reviews of the top 10 drills, 50 each, verified purchases only:

```json
{ "searchQueries": ["cordless drill"], "maxResultsPerQuery": 10, "includeReviews": true, "maxReviewsPerProduct": 50, "reviewsVerifiedOnly": true }
```

A daily price and stock monitor of a category:

```json
{ "startUrls": ["https://www.homedepot.com/b/Tools-Power-Tools-Drills/N-5yc1vZc27f"], "maxResultsPerQuery": 300, "monitorMode": true, "minQuantityChange": 5 }
```

### Output

One row per product (`recordType: "product"`), and with the add-ons one row per review (`"review"`) and per question
(`"question"`); `includeFacets` adds one free `"facets"` row per search. The dataset has views for products, details,
nearby store stock, reviews, questions and monitor changes.

#### A product row (real, from a test run on 2026-11-15 with every add-on on; long lists shortened)

```json
{
  "recordType": "product",
  "itemId": "313483106",
  "title": "M18 FUEL GEN-3 18V Lithium-Ion Brushless Cordless 3/8 in. Compact Impact Wrench with Friction Ring (Tool-Only)",
  "brand": "Milwaukee",
  "modelNumber": "2854-20",
  "storeSku": "1005652783",
  "url": "https://www.homedepot.com/p/Milwaukee-M18-FUEL-GEN-3-18V-Lithium-Ion-Brushless-Cordless-3-8-in-Compact-Impact-Wrench-with-Friction-Ring-Tool-Only-2854-20/313483106",
  "thumbnail": "https://images.thdstatic.com/productImages/ee479785-ef07-412c-883e-b557a758c4b5/svn/milwaukee-impact-wrenches-2854-20-64_400.jpg",
  "price": 249,
  "originalPrice": 249,
  "currency": "USD",
  "onSale": false,
  "discountPercent": 0,
  "isSpecialBuy": false,
  "isClearance": false,
  "rating": 4.75,
  "reviewsCount": 1596,
  "availabilityType": "Shared",
  "badges": ["Best Seller", "Exclusive"],
  "returnPolicy": "90-Day",
  "quantityLimit": 3,
  "variantCount": 14,
  "collectionName": "Milwaukee Impact Wrenches",
  "keyFeatures": [{ "name": "Torque (ft-lbs)", "value": "250" }, { "name": "Battery Voltage (V)", "value": "18V" }],
  "storeId": "6175",
  "storeName": "Manhattan West 23rd St",
  "storeAddress": "40 West 23rd Street",
  "storeCity": "New York",
  "storeState": "NY",
  "storeZip": "10010",
  "storePhone": "(212)929-9571",
  "storeHours": { "monday": "7:00-21:00", "sunday": "8:00-20:00" },
  "inStock": true,
  "storeQuantity": 29,
  "aisle": "41",
  "bay": "007",
  "pickupAvailable": true,
  "deliveryAvailable": true,
  "onlineQuantity": 3912,
  "freeShipping": true,
  "expressDeliveryAvailable": true,
  "zipCode": "10001",
  "sourceType": "item",
  "sourceValue": "313483106",
  "storeAvailability": [
    { "storeId": "6175", "storeName": "Manhattan West 23rd St", "street": "40 West 23rd Street", "city": "New York", "state": "NY", "zip": "10010", "phone": "(212)929-9571", "distanceMiles": 0.5, "price": 249, "inStock": true, "quantity": 29, "pickupAvailable": true, "aisle": "41", "bay": "007" },
    { "storeId": "6140", "storeName": "Midtown Manhattan (Relo 6177)", "distanceMiles": 1.9, "price": 249, "inStock": true, "quantity": 11, "aisle": "36", "bay": "005" }
  ],
  "storesInStock": 3,
  "totalStoreQuantity": 53,
  "detailsScraped": true,
  "description": "The Milwaukee M18 FUEL 3/8 in. Compact Impact Wrench with Friction Ring is the most compact in its class, delivering users the most access in tight spaces, up to 250 ft./lbs. of nut-busting torque, an...",
  "highlights": ["Compact cordless impact wrench offers most access in tight spaces", "18V impact wrench delivers up to 250 ft-lbs of nut-busting torque"],
  "bullets": ["Most access in tight spaces", "Up to 250 ft. lbs. nut-busting torque", "Maximum workspace visibility"],
  "specifications": [{ "group": "Details", "name": "Battery Power Type", "value": "Lithium Ion" }],
  "upc": "045242568819",
  "gtin13": "0045242568819",
  "videos": [{ "title": "M18 Battery Compatibility", "videoId": "6253956842001" }],
  "manualsAndGuides": [{ "name": "Product Brochure", "url": "https://images.thdstatic.com/catalog/pdfImages/f8/f8a6901b-c62e-40ff-aa4d-ba97b91b70b3.pdf" }],
  "breadcrumbs": [{ "label": "Tools", "url": "https://www.homedepot.com/b/Tools/N-5yc1vZc1xy" }],
  "favoriteCount": 33,
  "scrapedAt": "2026-11-15T20:54:00.643Z"
}
```

#### A review row

```json
{
  "recordType": "review",
  "reviewId": "308467992",
  "itemId": "313483106",
  "reviewedItemId": "314484062",
  "reviewedProductName": "M18 FUEL GEN-3 18V Lithium-Ion Brushless Cordless 1/2 in. Compact Impact Wrench with Friction Ring (Tool-Only)",
  "rating": 5,
  "text": "love how its so light and powerfull at the same time, would buy it again in a heartbeat.",
  "submittedAt": "2026-11-13T20:55:22.000+00:00",
  "author": "HomeDepotCustomer",
  "verifiedPurchase": false,
  "helpfulVotes": 0,
  "photos": [],
  "responses": [],
  "totalReviews": 1598
}
```

Home Depot shows the reviews of a product's whole family (sizes and versions) on each product page; `reviewedItemId`
says which item a review was written on.

#### A question row

```json
{
  "recordType": "question",
  "questionId": "11611159",
  "itemId": "313483106",
  "question": "What case holds this product?",
  "askedAt": "2026-11-15T02:00:46.000+00:00",
  "author": "Santa",
  "answerCount": 0,
  "answers": [],
  "totalQuestions": 63
}
```

#### Field fill (measured)

On 1,500 ceiling fans (store 121): itemId, title, url, images, price data, rating, category path, store name and
address, in-stock flag, delivery options 96-100%; brand 95%; ratings count 76%; badges 26%; Special Buy savings 34%;
shelf quantity, aisle and bay 2% (most fans are sold online and shipped, not shelved in the store). On 360 rows of
flooring, lumber, screws, paint and tools: shelf quantity 66%, aisle and bay 52%, unit price 33% (flooring), bulk price
8% (lumber). Configurable bundles (`productType: CONFIGURABLE_BUNDLE`) carry no brand or model number. Details rows:
description, bullets, specifications, UPC and images on every product that has them; sale dates on products with a
dated promotion.

### Monitor mode

With `monitorMode` on, the run remembers what this input returned last time (per `monitorName`) and delivers only
products that are new, or whose price, regular price or in-stock state changed. With `minQuantityChange` set, a shelf
quantity move of at least that many units counts too. Each delivered row says `changeType` (`new`, `changed`, or
`details` when an add-on it lacked is added now), `changedFields` and `previousValues`. Unchanged products are not
delivered or charged; a poll that finds nothing writes nothing and costs about $0.0001. Reviews in a monitor run are
the ones posted since the last poll.

### Pricing

Pay per result, no start fee:

| Event | Price |
|---|---|
| Product row | $0.0004 ($0.40 per 1,000) |
| Product details (add-on, per product) | $0.0018 |
| Nearby store stock (add-on, per store listed) | $0.0009 |
| Review | $0.0009 |
| Question (with its answers) | $0.045 |

Facets rows are free. A product not found, a refused request and an unchanged monitor row are never charged. The run
stops at your spending limit and charges only the rows it delivered.

### Limits

- Home Depot serves 24 products a page and 744 per search in one sort order; past that the run uses the other sort
  orders, so the last few hundred products of a very large category can be missing.
- Prices, stock and aisle/bay are per store; online-only products have no shelf stock or aisle.
- Price, rating, discount, stock and deal filters are checked on every product read; a filter that keeps few products
  reads more pages, and reading stops after about 15 products read per product kept.
- Review pages are 10 reviews; the question list is the one Home Depot shows.
- Store hours are filled for stores found by ZIP code; stores given by number (`storeIds`) have no hours.

# Actor input Schema

## `searchQueries` (type: `array`):

Words you would type into homedepot.com's search box, one per line (for example: cordless drill, ceiling fan, kitchen faucet). A model number or a 9-digit item id works too.

## `startUrls` (type: `array`):

homedepot.com links: category pages (/b/...N-...), search pages (/s/...) and product pages (/p/.../123456789). Paste them as they appear in your browser.

## `productIds` (type: `array`):

Home Depot item ids (the 9-digit number at the end of a product link, also called Internet # or OMSID).

## `navParams` (type: `array`):

Home Depot category codes: the N-... part of a category link (for example N-5yc1vZc27f or 5yc1vZc27f). Same as pasting the category link.

## `maxResultsPerQuery` (type: `integer`):

How many products to read for each keyword or category link. Home Depot shows 744 products per sort order; ask for more and the run reads the same search again in other orders (price low to high, high to low, top rated, newest), without repeats (2,832 distinct products from one 'ceiling fans' search in a test run).

## `maxItems` (type: `integer`):

Stops the whole run after this many product rows (all searches, links and item ids together). Empty = no run-wide cap.

## `sortBy` (type: `string`):

Home Depot's own sort, applied in its query. Default: Best Match for keywords, Top Sellers for categories.

## `zipCode` (type: `string`):

A US ZIP code. Prices, stock and aisle/bay come from the Home Depot store nearest to it (unless you set a store number), and delivery dates for it. Default: 30339 (Atlanta, GA).

## `storeId` (type: `string`):

A Home Depot store number (for example 121 or 6140), shown on the store's page. Prices, shelf stock and aisle/bay are read for this store. Default: 121 (Cumberland, Atlanta GA), or the store nearest your ZIP code.

## `storeFilter` (type: `string`):

Home Depot's own availability filter, applied in its query.

## `minPrice` (type: `number`):

Keep products at or above this price.

## `maxPrice` (type: `number`):

Keep products at or below this price.

## `brand` (type: `string`):

Keep only these brands (comma-separated, for example: DEWALT, Milwaukee, RYOBI).

## `minRating` (type: `number`):

Keep products rated at least this many stars (1-5).

## `onlyOnSale` (type: `boolean`):

Keep products with a lower price, a promotion, clearance or a Special Buy.

## `minDiscountPercent` (type: `integer`):

Keep products at least this many percent off (regular or clearance price).

## `onlyInStock` (type: `boolean`):

Keep products the chosen store has on its shelf now.

## `onlyClearance` (type: `boolean`):

Keep products with a clearance price at the chosen store.

## `onlySpecialBuy` (type: `boolean`):

Keep Home Depot Special Buy deals.

## `includeDetails` (type: `boolean`):

Adds the description, highlights, bullet points, full specifications, UPC / GTIN-13, every image, videos, manuals and guides, breadcrumb links and Subscribe & Save terms to each product row. Charged per product row that gets details.

## `includeStoreAvailability` (type: `boolean`):

Adds a storeAvailability list to each product: the nearest Home Depot stores to your ZIP code, each with its price, shelf quantity, in-stock flag and aisle/bay. Charged per store entry.

## `maxStores` (type: `integer`):

How many nearby stores to check for each product (with Add stock at nearby stores).

## `radiusMiles` (type: `integer`):

How far from your ZIP code to look for stores.

## `inStockStoresOnly` (type: `boolean`):

List only the nearby stores with the product in stock (stores without it are not charged).

## `storeIds` (type: `array`):

With Add stock at nearby stores: check these Home Depot store numbers instead of the stores nearest the ZIP code (up to 25).

## `includeReviews` (type: `boolean`):

Adds review rows for each product (rating, title, text, date, author, verified purchase, helpful votes, photos, Home Depot's or the brand's reply). Charged per review row.

## `maxReviewsPerProduct` (type: `integer`):

Review rows per product.

## `reviewsSort` (type: `string`):

Home Depot's own review order.

## `reviewsVerifiedOnly` (type: `boolean`):

Reviews from verified purchasers only (Home Depot's own filter).

## `reviewStars` (type: `array`):

Reviews with these star ratings only, for example 1 and 2 (Home Depot's own filter).

## `reviewsNewerThan` (type: `string`):

Only reviews posted after this date (YYYY-MM-DD).

## `reviewsSearchTerm` (type: `string`):

Only reviews that mention this word (Home Depot's own review search).

## `reviewsWithPhotosOnly` (type: `boolean`):

Keep reviews that carry customer photos.

## `minHelpfulVotes` (type: `integer`):

Keep reviews with at least this many helpful votes.

## `includeQuestions` (type: `boolean`):

Adds question rows for each product, each with its answers (text, author, brand answer flag, helpful votes). Charged per question row.

## `maxQuestionsPerProduct` (type: `integer`):

Question rows per product.

## `includeFacets` (type: `boolean`):

Adds one row per search or category (recordType facets, not charged) with Home Depot's own filter groups (brands, price ranges, ratings, features), each value with its product count and link, and the related searches Home Depot shows for a category.

## `monitorMode` (type: `boolean`):

Remembers what this input returned last time and delivers only products that are new or whose price, regular price or in-stock state changed (and, with a minimum stock change set, shelf quantity). Unchanged products are not delivered or charged. Each row carries changeType, changedFields and previousValues.

## `monitorName` (type: `string`):

Keeps separate memories for separate monitors of the same input.

## `minQuantityChange` (type: `integer`):

Monitor only: also report a product when the store's shelf quantity moved by at least this many units. 0 = quantity changes alone are not reported.

## `resetMonitor` (type: `boolean`):

Forget what earlier runs of this monitor saw (the next run delivers everything once).

## `webhookUrl` (type: `string`):

Optional: a URL that receives a JSON POST with the delivered products (up to 200) when the run ends.

## `proxyConfiguration` (type: `object`):

Optional. The run reads Home Depot directly and moves to Apify datacenter, then US residential proxies, by itself when it is refused. Set your own proxy here to use it first.

## Actor input object example

```json
{
  "searchQueries": [
    "cordless drill"
  ],
  "maxResultsPerQuery": 20,
  "sortBy": "default",
  "storeFilter": "all",
  "onlyOnSale": false,
  "onlyInStock": false,
  "onlyClearance": false,
  "onlySpecialBuy": false,
  "includeDetails": false,
  "includeStoreAvailability": false,
  "maxStores": 5,
  "radiusMiles": 25,
  "inStockStoresOnly": false,
  "includeReviews": false,
  "maxReviewsPerProduct": 20,
  "reviewsSort": "newest",
  "reviewsVerifiedOnly": false,
  "reviewsWithPhotosOnly": false,
  "minHelpfulVotes": 0,
  "includeQuestions": false,
  "maxQuestionsPerProduct": 10,
  "includeFacets": false,
  "monitorMode": false,
  "monitorName": "home-depot",
  "minQuantityChange": 0,
  "resetMonitor": false
}
```

# Actor output Schema

## `products` (type: `string`):

Product rows (price, stock, aisle/bay; details and nearby-store stock when asked).

## `reviews` (type: `string`):

No description

## `questions` (type: `string`):

No description

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQueries": [
        "cordless drill"
    ],
    "maxResultsPerQuery": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("topapi/home-depot-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQueries": ["cordless drill"],
    "maxResultsPerQuery": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("topapi/home-depot-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQueries": [
    "cordless drill"
  ],
  "maxResultsPerQuery": 20
}' |
apify call topapi/home-depot-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,topapi/home-depot-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/KlfAhwLZonweiHm3i/builds/pqQYOozuFtSMObaoG/openapi.json
