# Lowe's Product Scraper (`sian.agency/lowes-product-scraper`) Actor Scrape Lowe's products โ€” price, ratings, reviews, images, specs & store availability. Keyword or category search, full detail enrichment, clean JSON/CSV, no code. - **URL**: https://apify.com/sian.agency/lowes-product-scraper.md - **Developed by:** [SIรN Oรœ](https://apify.com/sian.agency) (community) - **Categories:** E-commerce, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.75 / 1,000 overview products This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Lowe's Product Scraper โ€” Prices, Specs & Store Stock ๐Ÿ› ๏ธ [![SIรN Agency Store](https://img.shields.io/badge/Store-SI%C3%81N%20Agency-1AE392)](https://apify.com/sian.agency?fpr=sian) [![Walmart Product Scraper](https://img.shields.io/badge/Store-Walmart%20Product%20Scraper-0071CE)](https://apify.com/sian.agency/walmart-data-scraper?fpr=sian) [![Google Shopping Price Scraper](https://img.shields.io/badge/Store-Google%20Shopping%20Price%20Scraper-4285F4)](https://apify.com/sian.agency/google-shopping-price-scraper?fpr=sian) [![Amazon Influencer & Deals Scraper](https://img.shields.io/badge/Store-Amazon%20Deals%20Scraper-FF9900)](https://apify.com/sian.agency/amazon-influencer-deals-scraper?fpr=sian) #### ๐ŸŽ‰ Pull Lowe's prices, promotions, ratings, and live in-store stock โ€” by keyword or category, no code ##### Built for retail analysts, e-commerce sellers, and brands who need fresh Lowe's product data on demand --- ### ๐Ÿ“‹ Overview **Track every price, promotion, and product spec on Lowe's โ€” without writing a single line of code.** This Lowe's scraper turns any Lowe's search or category into a clean, structured spreadsheet of products, complete with prices, ratings, images, and real-time store inventory. **Why thousands of professionals choose us:** - โœ… **Complete product data**: 30+ fields per product โ€” price, list price, promotions, rating, review count, brand, model, UPC, and more - โšก **Fast search-first mode**: pull a full page of products in seconds; scale to thousands across multiple searches - ๐ŸŽฏ **Per-store inventory**: see live in-store stock and localized pricing for any Lowe's store you choose - ๐Ÿ’ฐ **Pay only for results**: charged per product you actually receive โ€” no wasted spend, free tier to test - ๐Ÿ’Ž **Detail enrichment**: add the current price, full specifications table, and long product description with one switch - โœจ **NEW**: search by keyword *or* category, sort by best-sellers, price, rating, or newest โ€” just like the Lowe's site --- ### โœจ Features - ๐Ÿ”Ž **Keyword & Category Search**: scrape any Lowe's search term or browse a whole category - ๐Ÿท๏ธ **Full Pricing**: current price, original/list price, price-per-unit, and promotion badges - โญ **Ratings & Reviews**: star rating and total review count for every product - ๐Ÿฌ **Per-Store Inventory**: live in-store stock quantity, pickup, and availability for your chosen store - ๐Ÿ–ผ๏ธ **Product Images**: all product image URLs, ready for catalogs or feeds - ๐Ÿงพ **Specifications Table**: full structured specs (Detail mode) โ€” dimensions, materials, warranty, and more - ๐Ÿงญ **Breadcrumbs & Categories**: the product's full category path for clean classification - ๐Ÿ”ข **Identifiers**: brand, model number, item number, UPC, and product type for matching across catalogs - ๐Ÿ“ฆ **Clean Export**: results delivered as structured JSON or CSV, ready for Excel or your database - ๐Ÿš€ **No-Code Setup**: configure searches in a simple form โ€” no scripts, no account, no maintenance --- ### ๐ŸŽฌ Quick Start Enter one or more search keywords, pick a mode, and run. In under a minute you'll have a structured dataset of Lowe's products you can download as JSON or CSV. No setup, no account, no code. ```bash curl -X POST https://api.apify.com/v2/acts/sian.agency~lowes-product-scraper/runs?token=YOUR_TOKEN \ -H 'Content-Type: application/json' \ -d '{"keywords": ["cordless drill"], "scrapeMode": "overview"}' ```` *** ### ๐Ÿš€ Getting Started (3 Simple Steps) #### Step 1: Add Your Searches Type one or more Lowe's search keywords (e.g. `cordless drill`, `kitchen faucet`) โ€” one per line. #### Step 2: Choose Your Mode Pick **Overview** for fast search results, or **Detail** to also pull the current price, the full specifications table, and the long description. #### Step 3: Run & Download Click **Start**, then export your results as JSON, CSV, or Excel from the Apify dataset. **That's it! In just a few minutes, you'll have:** - A clean table of Lowe's products with prices and promotions - Ratings, review counts, and product images - Live in-store inventory for your chosen store *** ### ๐Ÿ“ฅ Input Configuration | Field | Type | Required | Description | |-------|------|----------|-------------| | keywords | array | No | Lowe's search terms, one per item (e.g. `cordless drill`) | | navIds | array | No | Advanced โ€” Lowe's category nav ids for whole-category browsing (see below) | | scrapeMode | string | No | `overview` (fast search) or `detail` (adds current price + specs table + long description) | | sort | string | No | `featured`, `best_sellers`, `price_low`, `price_high`, `top_rated`, `newest`, or `brand` | | storeId | string | No | Lowe's store number for localized price + live in-store stock | | maxResults | integer | No | Maximum products to return across all searches (FREE: up to 25/run, PAID: unlimited) | **How to get a category nav id:** open any Lowe's category page and copy the path + trailing id from the URL after `/pl/`. For `lowes.com/pl/Drills-Power-tools-Tools/4294608342`, the nav id is `Drills-Power-tools-Tools/4294608342`. **Example โ€” fast search:** ```json { "keywords": ["cordless drill", "impact driver"], "scrapeMode": "overview", "sort": "best_sellers", "maxResults": 100 } ``` **Example โ€” full detail with specs:** ```json { "keywords": ["kitchen faucet"], "scrapeMode": "detail", "storeId": "1955", "sort": "top_rated", "maxResults": 50 } ``` *** ### ๐Ÿ“ค Output Results are saved to the Apify dataset with **30+ fields per product**, including: | Field | Type | Description | |-------|------|-------------| | item\_id | string | Lowe's product identifier | | title | string | Product name | | brand | string | Product brand (e.g. `DEWALT`, `CRAFTSMAN`) | | model\_number | string | Manufacturer model number | | item\_number | string | Lowe's item number | | upc | string | Universal Product Code | | product\_type | string | Product type / category tag | | price | number | Current price (guaranteed in Detail mode) | | original\_price | number | List/was price when on promotion | | price\_per\_unit | string | Unit price where shown | | rating | number | Average star rating | | review\_count | number | Total number of reviews | | in\_stock | boolean | Whether the product is in stock at your store | | store\_quantity | number | Live in-store stock quantity | | store\_number | string | The store the price and stock are localized to | | pickup\_eligible | boolean | Whether in-store pickup is available | | free\_shipping | boolean | Whether the product ships free | | images | array | All product image URLs | | breadcrumbs | array | Full category path | | badges | array | Promotion / merchandising badges | | lowes\_exclusive | boolean | Whether the product is a Lowe's exclusive | | specs | object | Full specifications table (Detail mode) | | description | string | Long product description (Detail mode) | | highlights | array | Key feature bullets | **Example:** ```json { "item_id": "5013439809", "title": "20V MAX Cordless Brushless Drill/Driver Kit", "brand": "DEWALT", "model_number": "DCD800D1", "item_number": "5013439809", "upc": "885911767705", "product_type": "Drill/Driver", "price": 159.0, "original_price": 199.0, "currency": "USD", "price_per_unit": null, "rating": 4.8, "review_count": 3421, "in_stock": true, "store_quantity": 22, "store_number": "1955", "pickup_eligible": true, "free_shipping": true, "images": ["https://mobileimages.lowes.com/productimages/..."], "breadcrumbs": ["Tools", "Power Tools", "Drills"], "badges": ["Top Rated"], "lowes_exclusive": false, "specs": { "Voltage": "20 V", "Chuck Size": "1/2 in", "Battery Platform": "20V MAX" }, "highlights": ["Brushless motor for longer runtime", "2-speed transmission"], "description": "Compact, lightweight brushless drill/driver kit..." } ``` *** ### ๐Ÿ’ผ Use Cases & Examples #### 1. Price & Promo Monitoring **Retailers and resellers tracking Lowe's prices and promotions over time to stay competitive.** **Input:** Your product keywords and a daily schedule **Output:** Current price, list price, and promotion badges for every match **Use:** Spot price drops, react to promotions, and keep your own pricing sharp. #### 2. Competitor Pricing Intelligence **Brands and category managers benchmarking their products against the Lowe's assortment.** **Input:** Category keywords and a target store **Output:** Competitor prices, ratings, review counts, and promotion activity **Use:** Understand where you win or lose on price, rating, and availability. #### 3. Catalog & Assortment Research **E-commerce teams and marketplaces building a clean product catalog with images and specs.** **Input:** Keywords or category nav ids, in Detail mode **Output:** Titles, brands, models, UPCs, images, and full specifications tables **Use:** Populate your storefront or PIM with structured, ready-to-use Lowe's product data. #### 4. In-Stock & Store-Availability Checks **Merchandisers and ops teams verifying which products are in stock at specific stores.** **Input:** Your product keywords and one or more store IDs **Output:** Per-store inventory quantities, pickup eligibility, and availability flags **Use:** Plan assortment, identify stockouts, and confirm local availability before you act. #### 5. Product-Spec Extraction for Feeds **Feed managers and content teams enriching product feeds with structured specifications.** **Input:** Branded product keywords, in Detail mode **Output:** Full specs tables, model numbers, UPCs, descriptions, and images **Use:** Build complete, accurate product feeds and comparison pages at scale. #### 6. Market & Demand Research **Analysts and researchers tracking new products, best-sellers, and review momentum.** **Input:** Broad category keywords, sorted by newest or top-rated **Output:** Product launches, rating trends, and review-count growth **Use:** Surface emerging products and category trends before competitors do. *** ### ๐Ÿ”— Integration Examples #### JavaScript/Node.js ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_TOKEN' }); const run = await client.actor('sian.agency/lowes-product-scraper').call({ keywords: ['cordless drill'], scrapeMode: 'overview' }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items[0]); ``` #### Python ```python from apify_client import ApifyClient client = ApifyClient('YOUR_TOKEN') run = client.actor('sian.agency/lowes-product-scraper').call( run_input={'keywords': ['cordless drill'], 'scrapeMode': 'overview'} ) for item in client.dataset(run['defaultDatasetId']).iterate_items(): print(item) ``` #### cURL ```bash curl -X POST 'https://api.apify.com/v2/acts/sian.agency~lowes-product-scraper/runs?token=YOUR_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"keywords": ["cordless drill"], "scrapeMode": "overview"}' ``` #### Automation Workflows (N8N / Zapier / Make) 1. **Trigger**: Schedule (e.g. daily) or webhook 2. **HTTP Request**: Call the actor with your keywords 3. **Process**: Handle the JSON results 4. **Action**: Save to a sheet, sync to a database, or send a price-drop alert *** ### ๐Ÿ“Š Performance & Pricing #### FREE Tier (Try It Now) - **25 products** per run โ€” full feature access, same data quality - No credit card required - Perfect for testing and small projects #### PAID Tier (Production Ready) - **Unlimited** products per run - Run multiple searches and large categories in one go - Pay-per-result: you're only charged for the products you actually receive ๐Ÿ’ฐ **Best value on the market** โ€” transparent pay-per-result pricing with no hidden subscription fees. You pay only for the products you receive. ๐Ÿ”— [View current pricing](https://apify.com/sian.agency/lowes-product-scraper?fpr=sian) *** ### โ“ Frequently Asked Questions **Q: How many products can I scrape?** A: FREE tier: 25 products per run. PAID tier: unlimited products across as many searches as you like. **Q: Is it legal to collect this data?** A: Yes โ€” the actor only collects publicly available product data that anyone can see on the site. It does not collect private or personal user data. See the legal section below. **Q: Why is the price sometimes blank in Overview mode?** A: Lowe's loads some list prices dynamically, so a few items can show a blank price in the fast Overview path. Switch `scrapeMode` to `detail` to guarantee the current price for every product. **Q: What's the difference between Overview and Detail mode?** A: Overview is the fast path โ€” search results with brand, model, ratings, images, key specs, and live store availability. Detail adds the current price, the full specifications table, and the long product description for every product. **Q: How do I get a category nav id?** A: Open any Lowe's category page and copy the path + trailing id from the URL after `/pl/`. For `lowes.com/pl/Drills-Power-tools-Tools/4294608342`, the nav id is `Drills-Power-tools-Tools/4294608342`. Paste it into the `navIds` field. **Q: Can I get prices and stock for a specific store?** A: Yes โ€” set the `storeId` to any Lowe's store number to get localized pricing and live in-store inventory. **Q: What output formats are available?** A: JSON, CSV, and Excel โ€” export directly from the Apify dataset. **Q: How fresh is the data?** A: Every run pulls live data at the moment you run it. Schedule runs to keep prices and stock up to date. *** ### ๐Ÿž Troubleshooting **No results returned** - Check that your keywords match real Lowe's products - Try a broader search term or a different sort order **Missing price in Overview mode** - Some list prices load dynamically โ€” switch `scrapeMode` to `detail` to guarantee the current price **Missing specifications or description** - Specs and long descriptions only appear in **Detail** mode โ€” switch `scrapeMode` to `detail` **Wrong prices or stock** - Prices and inventory are store-specific โ€” set the correct `storeId` for your target store **Fewer results than expected on the free tier** - The FREE tier is capped at 25 products per run โ€” upgrade to PAID for unlimited results *** ### โš–๏ธ Is it legal to scrape data? Our actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only collect publicly available product information that anyone can see. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data. Personal data is protected by the **GDPR** in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. Please also respect the target site's terms of use. You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/). *** ### โš–๏ธ Trademark Disclaimer "Lowe's" and related marks are trademarks of Lowe's Companies, Inc. This actor is an independent tool and is **not affiliated with, endorsed by, or sponsored by Lowe's Companies, Inc.** It only collects publicly available data, and you should use it in line with Lowe's terms of use and all applicable laws. *** ### โญ Love This Tool? If this actor saves you time, please [leave us a 5-star review](https://apify.com/sian.agency/lowes-product-scraper/reviews) โ€” it helps other professionals discover it and helps us keep improving. *** ### ๐Ÿค Support [![Telegram Support](https://img.shields.io/badge/Telegram-Support%20Group-0088cc?logo=telegram)](https://t.me/+vyh1sRE08sAxMGRi) **Join our active support community** - For issues or questions, open an issue in the actor's repository - Check the [SIรN Agency Store](https://apify.com/sian.agency?fpr=sian) for more automation tools - ๐Ÿ“ง #### More from SIรN Agency - ๐Ÿช [Walmart Product Scraper](https://apify.com/sian.agency/walmart-data-scraper?fpr=sian) โ€” full Walmart product and review data - ๐Ÿ›๏ธ [Google Shopping Price Scraper](https://apify.com/sian.agency/google-shopping-price-scraper?fpr=sian) โ€” compare prices across every Google Shopping seller - ๐Ÿ“ฆ [Amazon Influencer & Deals Scraper](https://apify.com/sian.agency/amazon-influencer-deals-scraper?fpr=sian) โ€” surface live Amazon influencer storefront deals - ๐Ÿ”Ž [Browse all SIรN actors โ†’](https://apify.com/sian.agency?fpr=sian) *** **Built by [SIรN Agency](https://www.sian-agency.online)** | **[More Tools](https://apify.com/sian.agency?fpr=sian)** # Actor input Schema ## `keywords` (type: `array`): ๐Ÿ” **KEYWORD SEARCH:** Free-text Lowe's searches โ€” exactly what you'd type into the site's search bar. ๐Ÿ“ **EXAMPLES:** `cordless drill` ยท `dewalt impact driver` ยท `kitchen faucet` ยท `5 gallon bucket` ๐Ÿ’ก **TIP:** Add one keyword per line โ€” each runs as its own search and all results land in the same dataset. ๐Ÿ–Š๏ธ **BULK EDIT:** Click "Bulk edit" to paste many keywords at once (one per line). โœ… **IMPORTANT:** Provide either keywords OR category nav ids (at least one is needed to have something to scrape). ## `navIds` (type: `array`): ๐Ÿงญ **CATEGORY BROWSING (Advanced):** Scrape a whole Lowe's category instead of a keyword search. ๐Ÿ”ง **HOW TO GET IT:** Open any Lowe's category page and copy the path + trailing nav id from the URL after `/pl/` (e.g. for `lowes.com/pl/Drills-Power-tools-Tools/4294608342` paste `Drills-Power-tools-Tools/4294608342`). ๐Ÿ’ก **TIP:** Leave this empty if you're only using keywords โ€” it's purely an advanced alternative for category-level harvesting. ๐Ÿ–Š๏ธ **BULK EDIT:** Add one nav id per line to sweep multiple categories in a single run. ## `scrapeMode` (type: `string`): โš™๏ธ **SCRAPE DEPTH:** Choose how much data to pull per product. โšก **Overview (fast):** Search results only โ€” brand, model, ratings, images, key specs and live store availability. Fastest and cheapest path. ๐Ÿ”ฌ **Detail (enriched specs + price):** Everything in Overview PLUS the current price, the full specifications table and the long product description scraped from each product page. โš ๏ธ **NOTE:** In Overview mode the price may be blank for some items โ€” Lowe's loads list prices dynamically. Choose Detail mode to guarantee the price. ๐Ÿ’ก **TIP:** Start with Overview to scope your catalog, then switch to Detail when you need price + the complete spec sheet for feeds or comparisons. ## `sort` (type: `string`): ๐Ÿ”ƒ **RESULT ORDERING:** Order search results using Lowe's own native sort options โ€” so you get the same ranking real shoppers see. ๐Ÿ† **Best sellers** surfaces the most popular products first ยท ๐Ÿ’ฒ **Price** sorts ascending or descending ยท โญ **Top rated** leads with the highest-reviewed items ยท ๐Ÿ†• **Newest** prioritizes the latest arrivals ยท ๐Ÿ”ค **Brand** groups results alphabetically by brand. ## `storeId` (type: `string`): ๐Ÿฌ **LOCALIZED PRICING & STOCK:** The Lowe's store number used to localize prices and report live in-store availability (quantity on hand at that specific store). ๐Ÿ”ง **HOW TO FIND IT:** It's the numeric store number in a Lowe's store URL. ๐Ÿ’ก **TIP:** Leave this blank for national pricing, or set your local store to mirror exactly what a nearby shopper sees on price and availability. ## `maxResults` (type: `integer`): ๐Ÿ”ข **RESULT CAP:** Maximum number of products to return across all keywords and categories combined. ๐ŸŽ **TIER-BASED LIMITS:** - **FREE users:** Up to 25 products per run - **PAID users:** Unlimited โ€” scrape entire catalogs in a single run ๐Ÿ’ก **TIP:** Keep this low while you dial in your keywords, then raise it once the output looks right. ## Actor input object example ```json { "keywords": [ "cordless drill" ], "scrapeMode": "overview", "sort": "featured", "maxResults": 100 } ``` # Actor output Schema ## `lowesProducts` (type: `string`): Scraped Lowe's products with prices, promotions, ratings, images, specs and store stock. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "keywords": [ "cordless drill" ] }; // Run the Actor and wait for it to finish const run = await client.actor("sian.agency/lowes-product-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "keywords": ["cordless drill"] } # Run the Actor and wait for it to finish run = client.actor("sian.agency/lowes-product-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "keywords": [ "cordless drill" ] }' | apify call sian.agency/lowes-product-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sian.agency/lowes-product-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Lowe's Product Scraper", "description": "Scrape Lowe's products โ€” price, ratings, reviews, images, specs & store availability. Keyword or category search, full detail enrichment, clean JSON/CSV, no code.", "version": "1.0", "x-build-id": "0HeTlEI5oWUAR1zd6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~lowes-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-lowes-product-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/sian.agency~lowes-product-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-lowes-product-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/sian.agency~lowes-product-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-lowes-product-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "keywords": { "title": "๐Ÿ” Search Keywords", "type": "array", "description": "๐Ÿ” **KEYWORD SEARCH:** Free-text Lowe's searches โ€” exactly what you'd type into the site's search bar.\n\n๐Ÿ“ **EXAMPLES:** `cordless drill` ยท `dewalt impact driver` ยท `kitchen faucet` ยท `5 gallon bucket`\n\n๐Ÿ’ก **TIP:** Add one keyword per line โ€” each runs as its own search and all results land in the same dataset.\n\n๐Ÿ–Š๏ธ **BULK EDIT:** Click \"Bulk edit\" to paste many keywords at once (one per line).\n\nโœ… **IMPORTANT:** Provide either keywords OR category nav ids (at least one is needed to have something to scrape).", "default": [ "cordless drill" ], "items": { "type": "string" } }, "navIds": { "title": "๐Ÿงญ Category Nav IDs (Advanced)", "type": "array", "description": "๐Ÿงญ **CATEGORY BROWSING (Advanced):** Scrape a whole Lowe's category instead of a keyword search.\n\n๐Ÿ”ง **HOW TO GET IT:** Open any Lowe's category page and copy the path + trailing nav id from the URL after `/pl/` (e.g. for `lowes.com/pl/Drills-Power-tools-Tools/4294608342` paste `Drills-Power-tools-Tools/4294608342`).\n\n๐Ÿ’ก **TIP:** Leave this empty if you're only using keywords โ€” it's purely an advanced alternative for category-level harvesting.\n\n๐Ÿ–Š๏ธ **BULK EDIT:** Add one nav id per line to sweep multiple categories in a single run.", "items": { "type": "string" } }, "scrapeMode": { "title": "โš™๏ธ Scrape Mode", "enum": [ "overview", "detail" ], "type": "string", "description": "โš™๏ธ **SCRAPE DEPTH:** Choose how much data to pull per product.\n\nโšก **Overview (fast):** Search results only โ€” brand, model, ratings, images, key specs and live store availability. Fastest and cheapest path.\n\n๐Ÿ”ฌ **Detail (enriched specs + price):** Everything in Overview PLUS the current price, the full specifications table and the long product description scraped from each product page.\n\nโš ๏ธ **NOTE:** In Overview mode the price may be blank for some items โ€” Lowe's loads list prices dynamically. Choose Detail mode to guarantee the price.\n\n๐Ÿ’ก **TIP:** Start with Overview to scope your catalog, then switch to Detail when you need price + the complete spec sheet for feeds or comparisons.", "default": "overview" }, "sort": { "title": "๐Ÿ”ƒ Sort Order", "enum": [ "featured", "best_sellers", "price_low", "price_high", "top_rated", "newest", "brand" ], "type": "string", "description": "๐Ÿ”ƒ **RESULT ORDERING:** Order search results using Lowe's own native sort options โ€” so you get the same ranking real shoppers see.\n\n๐Ÿ† **Best sellers** surfaces the most popular products first ยท ๐Ÿ’ฒ **Price** sorts ascending or descending ยท โญ **Top rated** leads with the highest-reviewed items ยท ๐Ÿ†• **Newest** prioritizes the latest arrivals ยท ๐Ÿ”ค **Brand** groups results alphabetically by brand.", "default": "featured" }, "storeId": { "title": "๐Ÿฌ Store ID", "type": "string", "description": "๐Ÿฌ **LOCALIZED PRICING & STOCK:** The Lowe's store number used to localize prices and report live in-store availability (quantity on hand at that specific store).\n\n๐Ÿ”ง **HOW TO FIND IT:** It's the numeric store number in a Lowe's store URL.\n\n๐Ÿ’ก **TIP:** Leave this blank for national pricing, or set your local store to mirror exactly what a nearby shopper sees on price and availability." }, "maxResults": { "title": "๐Ÿ”ข Max Results", "minimum": 1, "type": "integer", "description": "๐Ÿ”ข **RESULT CAP:** Maximum number of products to return across all keywords and categories combined.\n\n๐ŸŽ **TIER-BASED LIMITS:**\n- **FREE users:** Up to 25 products per run\n- **PAID users:** Unlimited โ€” scrape entire catalogs in a single run\n\n๐Ÿ’ก **TIP:** Keep this low while you dial in your keywords, then raise it once the output looks right.", "default": 100 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```