# PetSmart Product Scraper (`sian.agency/petsmart-product-scraper`) Actor Scrape PetSmart products โ€” price, ratings, images, fulfillment & live store stock. Keyword search across every pet category, full detail enrichment, clean JSON/CSV, no code. - **URL**: https://apify.com/sian.agency/petsmart-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 ## PetSmart Product Scraper โ€” Prices, Ratings & Live Stock ๐Ÿพ [![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 PetSmart prices, promotions, ratings, and live store stock โ€” by keyword, no code ##### Built for retail analysts, pet brands, and e-commerce sellers who need fresh PetSmart product data on demand --- ### ๐Ÿ“‹ Overview **Track every price, promotion, and rating on PetSmart โ€” without writing a single line of code.** This scraper turns any PetSmart search into a clean, structured spreadsheet of products across dog, cat, fish, bird, reptile and small-pet supplies โ€” complete with prices, ratings, images, fulfillment options, and real-time stock. **Why professionals choose us:** - โœ… **Complete product data**: 40+ fields per product โ€” price, list/sale price, on-sale flag, rating, review count, brand, UPC, pet type, category, and more - โšก **Fast search-first mode**: pull 24 products per page in seconds; scale to thousands across multiple searches - ๐ŸŽฏ **Live fulfillment**: see ship-to-home quantity and nearest-store pickup stock for each product - ๐Ÿ’ฐ **Pay only for results**: charged per product you actually receive โ€” no wasted spend, free tier to test - ๐Ÿ’Ž **Detail enrichment**: add live ship-to-home and in-store pickup stock with one switch - โœจ **Powerful filters**: narrow by brand, pet type, category, food form, and price range โ€” just like the PetSmart site --- ### โœจ Features - ๐Ÿ”Ž **Keyword Search**: scrape any PetSmart search term across every pet category - ๐Ÿท๏ธ **Full Pricing**: current price, list price, sale price, on-sale flag, and multi-variant price ranges - โญ **Ratings & Reviews**: star rating and total review count for every product - ๐Ÿ“ฆ **Live Stock (Detail mode)**: real-time ship-to-home quantity and nearest-store pickup stock - ๐Ÿ›๏ธ **Fulfillment Flags**: store pickup, autoship, same-day delivery, online-only and store-only indicators - ๐Ÿ–ผ๏ธ **Product Images**: all product image URLs, ready for catalogs or feeds - ๐Ÿพ **Pet & Category Tags**: pet type, primary category, and full breadcrumb path for clean classification - ๐Ÿฉบ **Pet-Specific Attributes**: flavor, size, food form, life stage, and health considerations - ๐Ÿ”ข **Identifiers**: brand, manufacturer, manufacturer SKU, and UPC 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 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 PetSmart products you can download as JSON or CSV. No setup, no code. ```bash curl -X POST https://api.apify.com/v2/acts/sian.agency~petsmart-product-scraper/runs?token=YOUR_TOKEN \ -H 'Content-Type: application/json' \ -d '{"keywords": ["dog food"], "scrapeMode": "overview"}' ```` *** ### ๐Ÿš€ Getting Started (3 Simple Steps) #### Step 1: Add Your Searches Type one or more PetSmart search keywords (e.g. `dog food`, `cat litter`) โ€” one per line. #### Step 2: Choose Your Mode Pick **Overview** for fast search results, or **Detail** to also pull live ship-to-home and in-store pickup stock. #### 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 PetSmart products with prices and promotions - Ratings, review counts, and product images - Live fulfillment options and (in Detail mode) real-time stock *** ### ๐Ÿ“ฅ Input Configuration | Field | Type | Required | Description | |-------|------|----------|-------------| | keywords | array | No | PetSmart search terms, one per item (e.g. `dog food`) | | scrapeMode | string | No | `overview` (fast search) or `detail` (adds live ship + store-pickup stock) | | brand | string | No | Filter to a single brand (e.g. `Purina Pro Plan`) | | pet | string | No | Filter to a pet type (`Dog`, `Cat`, `Fish`, `Bird`, `Reptile`, `Small Pet`) | | category | string | No | Filter to a category (e.g. `Dry Food`, `Litter`, `Toys`) | | foodForm | string | No | Filter food to a form (e.g. `Bags`, `Cans`, `Pouches`) | | priceMin | integer | No | Only return products at or above this price (USD) | | priceMax | integer | No | Only return products at or below this price (USD) | | maxResults | integer | No | Maximum products to return across all searches | **Example โ€” fast search:** ```json { "keywords": ["dog food", "cat litter"], "scrapeMode": "overview", "maxResults": 100 } ``` **Example โ€” filtered detail with live stock:** ```json { "keywords": ["dog food"], "scrapeMode": "detail", "brand": "Purina Pro Plan", "pet": "Dog", "priceMax": 80, "maxResults": 50 } ``` *** ### ๐Ÿ“ค Output Results are saved to the Apify dataset with **40+ fields per product**, including: | Field | Type | Description | |-------|------|-------------| | productTitle | string | Product name | | brand | string | Product brand | | manufacturer | string | Manufacturer name | | upc | string | Universal Product Code | | price | number | Current price | | list\_price | number | List/was price | | sale\_price | number | Sale price when on promotion | | price\_display | string | Formatted price, including ranges for multi-variant products | | on\_sale | boolean | Whether the product is currently discounted | | rating | number | Average star rating | | review\_count | number | Total number of reviews | | pet\_type | array | Pet types the product is for | | category | string | Primary product category | | breadcrumbs | array | Full category path | | flavor | string | Product flavor (food/treats) | | size | string | Product size | | life\_stage | array | Target life stage(s) | | health\_considerations | array | Health benefits / considerations | | in\_stock\_online | boolean | Whether the product is available online | | bopis\_eligible | boolean | Whether store pickup is available | | autoship\_eligible | boolean | Whether Autoship subscription is available | | ship\_to\_home\_stock | number | Live ship-to-home quantity (Detail mode) | | store\_pickup\_stock | number | Live nearest-store pickup quantity (Detail mode) | | pickup\_store\_name | string | Name of the nearest store (Detail mode) | | images | array | All product image URLs | | description | string | Full product description and details | **Example:** ```json { "item_id": "5252900", "productTitle": "Purinaยฎ Pro Plan Sensitive Skin & Stomach Adult Dry Dog Food - Salmon & Rice", "brand": "Purina Pro Plan", "upc": "038100175526", "price": 77.49, "list_price": 77.99, "on_sale": true, "price_display": "$20.68-$94.99", "rating": 4.5, "review_count": 8544, "pet_type": ["Dog"], "category": "Dry Food", "breadcrumbs": ["Dog", "Food", "Dry Food"], "flavor": "Salmon & Rice", "size": "30 Lb", "life_stage": ["Adult"], "health_considerations": ["Sensitive Skin", "Sensitive Stomach"], "in_stock_online": true, "bopis_eligible": true, "autoship_eligible": true, "ship_to_home_stock": 8807, "store_pickup_stock": 7, "pickup_store_name": "Sterling", "images": ["https://s7d2.scene7.com/is/image/PetSmart/5252900?$sclp-prd-main_large$"] } ``` *** ### ๐Ÿ’ผ Use Cases & Examples #### 1. Price Monitoring **Retailers and resellers tracking PetSmart prices over time to stay competitive.** **Input:** Your product keywords and a daily schedule **Output:** Current price, list price, and on-sale flags for every match **Use:** Spot price drops, react to promotions, and keep your own pricing sharp. #### 2. Competitive Analysis **Pet brands and category managers benchmarking products against the PetSmart assortment.** **Input:** Category keywords and an optional brand filter **Output:** Competitor prices, ratings, review counts, and promotion activity **Use:** Understand where you win or lose on price, rating, and availability. #### 3. Catalog Building **E-commerce teams building a clean pet-product catalog with images and attributes.** **Input:** Keywords with brand or category filters **Output:** Titles, brands, UPCs, images, flavors, sizes, and descriptions **Use:** Populate your storefront or product database with structured, ready-to-use data. #### 4. MAP Compliance Monitoring **Manufacturers enforcing Minimum Advertised Price policies across PetSmart listings.** **Input:** Your branded product keywords **Output:** Live listed prices and promotional discounts per product **Use:** Detect MAP violations quickly and protect your brand pricing. #### 5. Availability & Stock Research **Merchandisers studying live ship-to-home and in-store stock for key products.** **Input:** Product keywords in Detail mode **Output:** Ship-to-home and nearest-store pickup quantities **Use:** Plan assortment, identify stockouts, and track availability trends. #### 6. Market Research & Trend Spotting **Analysts tracking best-sellers, top-rated products, and review momentum.** **Input:** Broad category keywords **Output:** Rating trends, review-count growth, and on-sale activity **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/petsmart-product-scraper').call({ keywords: ['dog food'], 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/petsmart-product-scraper').call( run_input={'keywords': ['dog food'], '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~petsmart-product-scraper/runs?token=YOUR_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"keywords": ["dog food"], "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 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. ๐Ÿ”— [View current pricing](https://apify.com/sian.agency/petsmart-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: What's the difference between Overview and Detail mode?** A: Overview is the fast path โ€” search results with price, ratings, images, attributes, and fulfillment flags. Detail adds live ship-to-home and nearest-store pickup stock for every product. **Q: Can I filter by brand or pet type?** A: Yes โ€” use the `brand`, `pet`, `category`, `foodForm`, and price-range filters to narrow exactly what you want. **Q: What output formats are available?** A: JSON, CSV, and Excel โ€” export directly from the Apify dataset. **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 PetSmart 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 PetSmart products - Try a broader search term, or remove a filter that may be too narrow **Missing live stock numbers** - Ship-to-home and store-pickup stock only appear in **Detail** mode โ€” switch `scrapeMode` to `detail` **A filter returns nothing** - Brand / category / food-form values must match PetSmart's exact spelling โ€” run an Overview search first; the log lists the available facet values for your keyword **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 PetSmartยฎ is a registered trademark of PetSmart LLC. This actor is an independent tool and is not affiliated with, endorsed by, or sponsored by PetSmart LLC. *** ### โญ Love This Tool? If this actor saves you time, please [leave us a 5-star review](https://apify.com/sian.agency/petsmart-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 product data, prices & specs - ๐Ÿช [Walmart Product Scraper](https://apify.com/sian.agency/walmart-data-scraper?fpr=sian) โ€” Walmart product and review data - ๐Ÿ›๏ธ [Google Shopping Price Scraper](https://apify.com/sian.agency/google-shopping-price-scraper?fpr=sian) โ€” track offers and price history across the web *** **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 PetSmart searches โ€” exactly what you'd type into the site's search bar. ๐Ÿ“ **EXAMPLES:** `dog food` ยท `cat litter` ยท `aquarium filter` ยท `flea treatment` ยท `dog toy` ๐Ÿ’ก **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:** At least one keyword is required to have something to scrape. ## `scrapeMode` (type: `string`): โš™๏ธ **SCRAPE DEPTH:** Choose how much data to pull per product. โšก **Overview (fast):** Search results โ€” price, list/sale price, ratings, images, brand, pet type, category, variation options and fulfillment flags. Fastest and cheapest path. ๐Ÿ”ฌ **Detail (live stock):** Everything in Overview PLUS live fulfillment โ€” ship-to-home quantity and the nearest store's in-store pickup quantity and store name. ๐Ÿ’ก **TIP:** Start with Overview to scope your catalog, then switch to Detail when you need real-time availability. ## `brand` (type: `string`): โ„ข๏ธ **FILTER BY BRAND:** Limit results to a single brand (e.g. `Purina Pro Plan`, `Hill's Science Diet`, `KONG`, `Tidy Cats`). ๐Ÿ’ก **TIP:** Leave empty to include every brand. Brand names must match PetSmart's exact spelling โ€” run an Overview search first to see the available brands. ## `pet` (type: `string`): ๐Ÿพ **FILTER BY PET:** Limit results to one pet type (e.g. `Dog`, `Cat`, `Fish`, `Bird`, `Reptile`, `Small Pet`). ๐Ÿ’ก **TIP:** Useful for a generic keyword like `food` to keep only dog or only cat products. ## `category` (type: `string`): ๐Ÿ—‚๏ธ **FILTER BY CATEGORY:** Limit results to a PetSmart category (e.g. `Dry Food`, `Canned Food`, `Litter`, `Toys`). ๐Ÿ’ก **TIP:** Run an Overview search first โ€” the log prints the available category facet values for your keyword. ## `foodForm` (type: `string`): ๐Ÿฅซ **FILTER BY FOOD FORM:** Limit food results to a form (e.g. `Bags`, `Cans`, `Pouches`, `Trays`). ๐Ÿ’ก **TIP:** Only relevant for food keywords; leave empty otherwise. ## `priceMin` (type: `integer`): ๐Ÿ’ต **MINIMUM PRICE:** Only return products at or above this price (USD). ๐Ÿ’ก **TIP:** Combine with Max Price to target a price band. ## `priceMax` (type: `integer`): ๐Ÿ’ฐ **MAXIMUM PRICE:** Only return products at or below this price (USD). ๐Ÿ’ก **TIP:** Great for finding budget options or excluding bulk/premium SKUs. ## `maxResults` (type: `integer`): ๐Ÿ”ข **RESULT CAP:** Maximum number of products to return across all keywords 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": [ "dog food" ], "scrapeMode": "overview", "maxResults": 100 } ``` # Actor output Schema ## `petSmartProducts` (type: `string`): Scraped PetSmart products with prices, promotions, ratings, images, fulfillment flags and live 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": [ "dog food" ] }; // Run the Actor and wait for it to finish const run = await client.actor("sian.agency/petsmart-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": ["dog food"] } # Run the Actor and wait for it to finish run = client.actor("sian.agency/petsmart-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": [ "dog food" ] }' | apify call sian.agency/petsmart-product-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sian.agency/petsmart-product-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "PetSmart Product Scraper", "description": "Scrape PetSmart products โ€” price, ratings, images, fulfillment & live store stock. Keyword search across every pet category, full detail enrichment, clean JSON/CSV, no code.", "version": "1.0", "x-build-id": "TzFyJTeMQqrdERY2d" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~petsmart-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-petsmart-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~petsmart-product-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-petsmart-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~petsmart-product-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-petsmart-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 PetSmart searches โ€” exactly what you'd type into the site's search bar.\n\n๐Ÿ“ **EXAMPLES:** `dog food` ยท `cat litter` ยท `aquarium filter` ยท `flea treatment` ยท `dog toy`\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:** At least one keyword is required to have something to scrape.", "default": [ "dog food" ], "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 โ€” price, list/sale price, ratings, images, brand, pet type, category, variation options and fulfillment flags. Fastest and cheapest path.\n\n๐Ÿ”ฌ **Detail (live stock):** Everything in Overview PLUS live fulfillment โ€” ship-to-home quantity and the nearest store's in-store pickup quantity and store name.\n\n๐Ÿ’ก **TIP:** Start with Overview to scope your catalog, then switch to Detail when you need real-time availability.", "default": "overview" }, "brand": { "title": "โ„ข๏ธ Brand Filter", "type": "string", "description": "โ„ข๏ธ **FILTER BY BRAND:** Limit results to a single brand (e.g. `Purina Pro Plan`, `Hill's Science Diet`, `KONG`, `Tidy Cats`).\n\n๐Ÿ’ก **TIP:** Leave empty to include every brand. Brand names must match PetSmart's exact spelling โ€” run an Overview search first to see the available brands." }, "pet": { "title": "๐Ÿพ Pet Type Filter", "type": "string", "description": "๐Ÿพ **FILTER BY PET:** Limit results to one pet type (e.g. `Dog`, `Cat`, `Fish`, `Bird`, `Reptile`, `Small Pet`).\n\n๐Ÿ’ก **TIP:** Useful for a generic keyword like `food` to keep only dog or only cat products." }, "category": { "title": "๐Ÿ—‚๏ธ Category Filter", "type": "string", "description": "๐Ÿ—‚๏ธ **FILTER BY CATEGORY:** Limit results to a PetSmart category (e.g. `Dry Food`, `Canned Food`, `Litter`, `Toys`).\n\n๐Ÿ’ก **TIP:** Run an Overview search first โ€” the log prints the available category facet values for your keyword." }, "foodForm": { "title": "๐Ÿฅซ Food Form Filter", "type": "string", "description": "๐Ÿฅซ **FILTER BY FOOD FORM:** Limit food results to a form (e.g. `Bags`, `Cans`, `Pouches`, `Trays`).\n\n๐Ÿ’ก **TIP:** Only relevant for food keywords; leave empty otherwise." }, "priceMin": { "title": "๐Ÿ’ต Min Price", "minimum": 0, "type": "integer", "description": "๐Ÿ’ต **MINIMUM PRICE:** Only return products at or above this price (USD).\n\n๐Ÿ’ก **TIP:** Combine with Max Price to target a price band." }, "priceMax": { "title": "๐Ÿ’ฐ Max Price", "minimum": 0, "type": "integer", "description": "๐Ÿ’ฐ **MAXIMUM PRICE:** Only return products at or below this price (USD).\n\n๐Ÿ’ก **TIP:** Great for finding budget options or excluding bulk/premium SKUs." }, "maxResults": { "title": "๐Ÿ”ข Max Results", "minimum": 1, "type": "integer", "description": "๐Ÿ”ข **RESULT CAP:** Maximum number of products to return across all keywords 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 } } } } } } } } } } ```