# AutoZone Product Scraper (`sian.agency/autozone-product-scraper`) Actor Scrape AutoZone auto parts โ€” price, availability, ratings, images, specs & warranty. Search by part name or category, full detail enrichment, clean JSON/CSV, no code. - **URL**: https://apify.com/sian.agency/autozone-product-scraper.md - **Developed by:** [SIรN Oรœ](https://apify.com/sian.agency) (community) - **Categories:** E-commerce, Business - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.70 / 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 ## AutoZone Product Scraper โ€” Prices, Specs, Warranty & Ratings ๐Ÿ”ง [![SIรN Agency Store](https://img.shields.io/badge/Store-SI%C3%81N%20Agency-1AE392)](https://apify.com/sian.agency?fpr=sian) [![Home Depot Product Scraper](https://img.shields.io/badge/Store-Home%20Depot%20Product%20Scraper-F96302)](https://apify.com/sian.agency/home-depot-product-scraper?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) #### ๐ŸŽ‰ Pull AutoZone prices, availability, warranty, ratings, and full part specs โ€” by keyword or category, no code ##### Built for auto-parts sellers, retail analysts, and brands who need fresh AutoZone product data on demand --- ### ๐Ÿ“‹ Overview **Track every price, part number, warranty, and spec on AutoZone โ€” without writing a single line of code.** This scraper turns any AutoZone part search or category into a clean, structured spreadsheet of products, complete with prices, availability, brand and part numbers, warranty, images, and customer ratings. Just type a part name like `brake pads` or `spark plug` โ€” no vehicle selection required. **Why thousands of professionals choose us:** - โœ… **Complete part data**: title, brand, sub-brand, part number, OEM part number, part type, price, warranty, availability, and more - โšก **Fast overview mode**: pull price, availability, warranty, brand, part number, and images in seconds โ€” then scale across many searches - ๐ŸŽฏ **No vehicle selection**: search by part name or browse a category โ€” no make/model/year picker to fight through - ๐Ÿ’ฐ **Pay only for results**: charged per product you actually receive โ€” no wasted spend, free tier to test - ๐Ÿ’Ž **Detail enrichment**: add the full specifications table, product features, description, and customer ratings with one switch - โœจ **NEW**: capture core charges, store total price, ship-to-home and in-store pickup availability, and merchandising badges --- ### โœจ Features - ๐Ÿ”Ž **Keyword & Category Search**: scrape any AutoZone part keyword or browse a full category path - ๐Ÿท๏ธ **Full Pricing**: current price, was/list price, discounted price, refundable core charge, and store total price - ๐Ÿ›ก๏ธ **Warranty & Availability**: warranty type, limited lifetime warranty flag, ship-to-home, in-store pickup, and special-order status - ๐Ÿ”ข **Part Identifiers**: brand, sub-brand, part number, OEM part number, line code, and part type for matching across catalogs - โญ **Ratings & Reviews**: average star rating, review count, and recommend percentage (Detail mode) - ๐Ÿงพ **Specifications Table**: full structured specs and key product features (Detail mode) - ๐Ÿ–ผ๏ธ **Product Images**: thumbnail plus all product image URLs, ready for catalogs or feeds - ๐Ÿงญ **Breadcrumbs & Badges**: full category path and merchandising badges for clean classification - ๐Ÿ“ฆ **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 maintenance --- ### ๐ŸŽฌ Quick Start Enter one or more part keywords, pick a mode, and run. In under a minute you'll have a structured dataset of AutoZone products you can download as JSON or CSV. No setup, no vehicle picker, no code. ```bash curl -X POST https://api.apify.com/v2/acts/sian.agency~autozone-product-scraper/runs?token=YOUR_TOKEN \ -H 'Content-Type: application/json' \ -d '{"keywords": ["brake pads"], "scrapeMode": "overview"}' ```` *** ### ๐Ÿš€ Getting Started (3 Simple Steps) #### Step 1: Add Your Searches Type one or more AutoZone part keywords (e.g. `brake pads`, `spark plug`, `wiper blades`) โ€” one per line. No vehicle selection needed. #### Step 2: Choose Your Mode Pick **Overview** for fast search results, or **Detail** to also pull the full specifications table, product features, description, and customer ratings. #### 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 AutoZone parts with prices, core charges, and availability - Brand, part numbers, OEM numbers, and warranty for every product - Images, ratings, and full specifications (Detail mode) *** ### ๐Ÿ“ฅ Input Configuration | Field | Type | Required | Description | |-------|------|----------|-------------| | keywords | array | No | AutoZone part search terms, one per item (e.g. `brake pads`) | | categoryPaths | array | No | Advanced โ€” AutoZone category path from a category URL (e.g. `/brakes-and-traction-control/brake-pads`) | | scrapeMode | string | No | `overview` (fast search) or `detail` (adds specs table, features, description + ratings) | | maxResults | integer | No | Maximum products to return across all keywords and categories | *Provide either `keywords` or `categoryPaths` โ€” at least one is needed to have something to scrape.* **Example โ€” fast search:** ```json { "keywords": ["brake pads", "spark plug"], "scrapeMode": "overview", "maxResults": 100 } ``` **Example โ€” full detail with specs and ratings:** ```json { "keywords": ["wiper blades"], "scrapeMode": "detail", "maxResults": 50 } ``` **Example โ€” category browsing:** ```json { "categoryPaths": ["/brakes-and-traction-control/brake-pads"], "scrapeMode": "overview", "maxResults": 200 } ``` *** ### ๐Ÿ“ค Output Results are saved to the Apify dataset with **35+ fields per product**, including: | Field | Type | Description | |-------|------|-------------| | productTitle | string | Full product name | | brand | string | Manufacturer / brand (e.g. Duralast, Bosch) | | sub\_brand | string | Sub-brand / product line (e.g. Duralast Gold) | | part\_number | string | Manufacturer part number | | oem\_part\_number | string | OEM part number, when listed | | part\_type | string | Part group / type (e.g. Brake Pads, Spark Plugs) | | price | number | Current retail price | | was\_price | number | Strikethrough / list price before discount | | discounted\_price | number | Discounted price when an offer applies | | core\_price | number | Refundable core charge, when applicable | | store\_total\_price | number | Total in-store price including any core charge | | ship\_to\_home\_available | boolean | Available for ship-to-home delivery | | store\_pickup\_available | boolean | Available for in-store pickup | | special\_order | boolean | Whether the part is a special-order item | | warranty\_type | string | Warranty classification (e.g. Limited Lifetime) | | vehicle\_fitment | string | Fitment type (e.g. VEHICLE\_SPECIFIC, UNIVERSAL) | | breadcrumbs | array | Full category path | | badges | array | Merchandising badges on the listing | | images | array | All product image URLs | | rating | number | Average star rating (Detail mode) | | review\_count | integer | Total number of reviews (Detail mode) | | recommend\_percentage | number | % of reviewers who recommend (Detail mode) | | features | array | Key product features (Detail mode) | | specs | object | Full specifications table (Detail mode) | | description | string | Marketing / long description (Detail mode) | **Example:** ```json { "item_id": "847123", "productTitle": "Duralast Gold Ceramic Brake Pads", "brand": "Duralast", "sub_brand": "Duralast Gold", "part_number": "DG1234", "oem_part_number": "D1234A", "part_type": "Brake Pads", "price": 54.99, "was_price": 64.99, "discounted_price": 54.99, "core_price": 0, "store_total_price": 54.99, "currency": "USD", "ship_to_home_available": true, "store_pickup_available": true, "special_order": false, "availability_label": "Ships within 1 business day.", "warranty_type": "Limited Lifetime", "limited_lifetime_warranty": true, "vehicle_fitment": "VEHICLE_SPECIFIC", "location": "Front", "breadcrumbs": ["Brakes & Traction Control", "Brake Pads"], "badges": ["Best Seller"], "images": ["https://www.autozone.com/..."], "rating": 4.7, "review_count": 1832, "recommend_percentage": 96, "features": ["Low-dust ceramic formula", "Quiet braking"], "specs": { "Material": "Ceramic", "Position": "Front", "Warranty": "Limited Lifetime" }, "description": "Premium ceramic brake pads engineered for quiet, low-dust stopping power...", "source": "detail" } ``` *** ### ๐Ÿ’ผ Use Cases & Examples #### 1. Price & Promotion Monitoring **Auto-parts retailers and resellers tracking AutoZone prices over time to stay competitive.** **Input:** Your part keywords and a daily schedule **Output:** Current price, was price, discounted price, and core charge 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 parts against the AutoZone assortment.** **Input:** Category keywords in Detail mode **Output:** Competitor prices, warranty, ratings, and review counts per part **Use:** Understand where you win or lose on price, warranty, and rating. #### 3. Catalog & Assortment Research **E-commerce teams and marketplaces building a clean auto-parts catalog with images and specs.** **Input:** Keywords or category paths, in Detail mode **Output:** Titles, brands, part numbers, OEM numbers, images, and full specifications tables **Use:** Populate your storefront or PIM with structured, ready-to-use part data. #### 4. Availability & Fulfillment Checks **Operations teams confirming ship-to-home, in-store pickup, and special-order status across parts.** **Input:** Your branded or sourced part keywords **Output:** Ship-to-home, store pickup, special-order flags, and availability messages **Use:** Track fulfillment options and surface special-order or out-of-stock parts fast. #### 5. Product-Spec Extraction for Feeds **Catalog and feed teams that need clean specs, features, and identifiers for every part.** **Input:** Category keywords or paths in Detail mode **Output:** Full specifications table, features, part numbers, OEM numbers, and warranty **Use:** Build accurate product feeds and match parts across multiple catalogs. #### 6. Market & Demand Research **Analysts and researchers tracking top-rated parts, warranty trends, and review momentum.** **Input:** Broad category keywords in Detail mode **Output:** Ratings, review counts, recommend percentages, and warranty data **Use:** Surface best-rated parts 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/autozone-product-scraper').call({ keywords: ['brake pads'], 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/autozone-product-scraper').call( run_input={'keywords': ['brake pads'], '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~autozone-product-scraper/runs?token=YOUR_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"keywords": ["brake pads"], "scrapeMode": "overview"}' ``` #### Automation Workflows (N8N / Zapier / Make) 1. **Trigger**: Schedule (e.g. daily) or webhook 2. **HTTP Request**: Call the actor API 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 keyword searches and full 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. Overview is the cheap, high-volume event; Detail is the premium enriched event โ€” you choose the depth you pay for. ๐Ÿ”— [View current pricing](https://apify.com/sian.agency/autozone-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: Do I need to select a vehicle (make/model/year)?** A: No โ€” just type a part name like `brake pads` or `spark plug`, or paste a category path. There's no vehicle picker to work through. **Q: What's the difference between Overview and Detail mode?** A: Overview is the fast path โ€” price, availability, warranty, brand, part number, and images. Detail adds the full specifications table, product features, long description, and customer ratings (average rating, review count, recommend percentage) for every product. **Q: Can I scrape by category instead of keywords?** A: Yes โ€” use the `categoryPaths` field with an AutoZone category path (e.g. `/brakes-and-traction-control/brake-pads`) to harvest a whole category. **Q: What output formats are available?** A: JSON, CSV, and Excel โ€” export directly from the Apify dataset. **Q: Does it capture core charges and warranty?** A: Yes โ€” every product includes the refundable core charge (when applicable), store total price, warranty type, and a limited-lifetime-warranty flag. **Q: Is this legal?** A: Yes โ€” we only extract publicly available product data. See the legal section below. **Q: How fresh is the data?** A: Every run pulls live data directly from AutoZone at the moment you run it. Schedule runs to keep prices and availability up to date. *** ### ๐Ÿž Troubleshooting **No results returned** - Check that your keywords match real AutoZone parts (e.g. `brake pads`, `oil filter`) - Try a broader part term, or use a `categoryPaths` entry instead **Missing specifications, features, description, or ratings** - These only appear in **Detail** mode โ€” switch `scrapeMode` to `detail` **Category path returns nothing** - Paste only the path portion of the URL (e.g. `/brakes-and-traction-control/brake-pads`), not the full `https://...` address **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 extract what is publicly shared. 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. You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/). *** ### โš–๏ธ Trademark Disclaimer AutoZoneยฎ is a trademark of its respective owner. This actor is an independent, third-party tool and is not affiliated with, endorsed by, or sponsored by AutoZone, Inc. It only collects publicly available data; please review and respect AutoZone's Terms of Service and applicable laws before use. *** ### โญ Love This Tool? If this actor saves you time, please [leave us a 5-star review](https://apify.com/sian.agency/autozone-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 - ๐Ÿชš [Home Depot Product Scraper](https://apify.com/sian.agency/home-depot-product-scraper?fpr=sian) โ€” Home Depot prices, ratings, specs & store stock - ๐Ÿช [Walmart Product Scraper](https://apify.com/sian.agency/walmart-data-scraper?fpr=sian) โ€” full Walmart product data, prices & ratings - ๐Ÿ›๏ธ [Google Shopping Price Scraper](https://apify.com/sian.agency/google-shopping-price-scraper?fpr=sian) โ€” compare prices across every Google Shopping seller *** **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 AutoZone searches โ€” exactly what you'd type into the site's search bar. No vehicle selection required. ๐Ÿ“ **EXAMPLES:** `brake pads` ยท `spark plug` ยท `wiper blades` ยท `car battery` ยท `oil filter` ๐Ÿ’ก **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 paths (at least one is needed to have something to scrape). ## `categoryPaths` (type: `array`): ๐Ÿงญ **CATEGORY BROWSING (Advanced):** Scrape a whole AutoZone category instead of a keyword search. ๐Ÿ”ง **HOW TO GET IT:** Open any AutoZone category page and copy the path from the URL (e.g. the part after the domain in `autozone.com/brakes-and-traction-control/brake-pads`). Paste just the path here โ€” e.g. `/brakes-and-traction-control/brake-pads`. ๐Ÿ’ก **TIP:** Leave this empty if you're only using keywords โ€” it's purely an advanced alternative for category-level harvesting. ๐Ÿ–Š๏ธ **BULK EDIT:** Add one path 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 โ€” price, availability, warranty, images, brand and part number. Fastest and cheapest path. ๐Ÿ”ฌ **Detail (enriched specs):** Everything in Overview PLUS the full specifications table, product features, marketing description and customer ratings (average rating + review count) scraped from each product page. ๐Ÿ’ก **TIP:** Start with Overview to scope your catalog, then switch to Detail when you need the complete spec sheet and ratings for feeds or comparisons. ## `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": [ "brake pads" ], "scrapeMode": "overview", "maxResults": 100 } ``` # Actor output Schema ## `autoZoneProducts` (type: `string`): Scraped AutoZone products with prices, availability, ratings, images, specs and warranty. # 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": [ "brake pads" ] }; // Run the Actor and wait for it to finish const run = await client.actor("sian.agency/autozone-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": ["brake pads"] } # Run the Actor and wait for it to finish run = client.actor("sian.agency/autozone-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": [ "brake pads" ] }' | apify call sian.agency/autozone-product-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sian.agency/autozone-product-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "AutoZone Product Scraper", "description": "Scrape AutoZone auto parts โ€” price, availability, ratings, images, specs & warranty. Search by part name or category, full detail enrichment, clean JSON/CSV, no code.", "version": "1.0", "x-build-id": "mJgWqxpFL7EOcx8e9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~autozone-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-autozone-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~autozone-product-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-autozone-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~autozone-product-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-autozone-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 AutoZone searches โ€” exactly what you'd type into the site's search bar. No vehicle selection required.\n\n๐Ÿ“ **EXAMPLES:** `brake pads` ยท `spark plug` ยท `wiper blades` ยท `car battery` ยท `oil filter`\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 paths (at least one is needed to have something to scrape).", "default": [ "brake pads" ], "items": { "type": "string" } }, "categoryPaths": { "title": "๐Ÿงญ Category Paths (Advanced)", "type": "array", "description": "๐Ÿงญ **CATEGORY BROWSING (Advanced):** Scrape a whole AutoZone category instead of a keyword search.\n\n๐Ÿ”ง **HOW TO GET IT:** Open any AutoZone category page and copy the path from the URL (e.g. the part after the domain in `autozone.com/brakes-and-traction-control/brake-pads`). Paste just the path here โ€” e.g. `/brakes-and-traction-control/brake-pads`.\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 path 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 โ€” price, availability, warranty, images, brand and part number. Fastest and cheapest path.\n\n๐Ÿ”ฌ **Detail (enriched specs):** Everything in Overview PLUS the full specifications table, product features, marketing description and customer ratings (average rating + review count) scraped from each product page.\n\n๐Ÿ’ก **TIP:** Start with Overview to scope your catalog, then switch to Detail when you need the complete spec sheet and ratings for feeds or comparisons.", "default": "overview" }, "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 } } } } } } } } } } ```