# Petco Product Scraper (`sian.agency/petco-product-scraper`) Actor Scrape Petco products โ€” price, customer ratings, images, ingredients, guaranteed analysis & full specs. Keyword or category search, full detail enrichment, clean JSON/CSV, no code. - **URL**: https://apify.com/sian.agency/petco-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 ## Petco Product Scraper โ€” Prices, Ratings, Ingredients & Specs ๐Ÿพ [![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 Petco prices, customer ratings, ingredients, and full specs โ€” by keyword or category, no code ##### Built for retail analysts, e-commerce sellers, and pet brands who need fresh Petco product data on demand --- ### ๐Ÿ“‹ Overview **Track every price, rating, ingredient list, and product spec on Petco โ€” without writing a single line of code.** This scraper turns any Petco search or category into a clean, structured spreadsheet of products, complete with prices, customer ratings, images, ingredients, and full specifications. **Why professionals choose us:** - โœ… **Complete product data**: 30+ fields per product โ€” price, list price, sale flag, rating, review count, brand, SKU, UPC, and more - โšก **Fast search-first mode**: pull 24 products per page in seconds; scale to thousands across multiple searches - ๐Ÿงช **Ingredients & nutrition**: full ingredients list and guaranteed analysis for pet food and treats (Detail mode) - ๐Ÿ’ฐ **Pay only for results**: charged per product you actually receive โ€” no wasted spend, free tier to test - ๐Ÿ’Ž **Detail enrichment**: add the full specifications table, feeding directions, dimensions, and long description with one switch - โœจ **Native search & sort**: search by keyword *or* category, sort by relevance, price, rating, best-selling, or newest โ€” just like the Petco site --- ### โœจ Features - ๐Ÿ”Ž **Keyword & Category Search**: scrape any Petco search term or category section - ๐Ÿท๏ธ **Full Pricing**: current price, list price, Repeat Delivery price, and on-sale flag - โญ **Ratings & Reviews**: star rating and total review count for every product - ๐Ÿงช **Ingredients & Guaranteed Analysis**: complete ingredient lists and nutritional breakdowns (Detail mode) - ๐Ÿ–ผ๏ธ **Product Images**: all product image URLs, ready for catalogs or feeds - ๐Ÿงพ **Specifications Table**: full structured specs (Detail mode) โ€” dimensions, lifestage, flavor, and more - ๐Ÿพ **Pet Type & Dietary Attributes**: pet type plus Grain-Free / Organic / Holistic and other dietary flags - ๐Ÿงญ **Category Path**: each product's full category breadcrumb for clean classification - ๐Ÿ”ข **Identifiers**: brand, SKU, UPC, and variation id for matching across catalogs - ๐Ÿ“ฆ **Availability Flags**: in-stock, pickup-in-store, same-day delivery, and Repeat Delivery eligibility - ๐Ÿ“ฆ **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 Petco products you can download as JSON or CSV. No setup, no code. ```bash curl -X POST https://api.apify.com/v2/acts/sian.agency~petco-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 Petco 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 ingredients, guaranteed analysis, 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 Petco products with prices and sale flags - Ratings, review counts, and product images - Ingredients, nutrition, and full specs (in Detail mode) *** ### ๐Ÿ“ฅ Input Configuration | Field | Type | Required | Description | |-------|------|----------|-------------| | keywords | array | No | Petco search terms, one per item (e.g. `dog food`) | | browseGroups | array | No | Advanced โ€” Petco category groups (e.g. `dog`, `cat`, `fish`) | | scrapeMode | string | No | `overview` (fast search) or `detail` (adds ingredients, specs table + long description) | | sort | string | No | `relevance`, `price_low`, `price_high`, `top_rated`, `top_sold`, `newest`, `name_az`, or `name_za` | | filters | object | No | Advanced โ€” facet filters (e.g. `{"Primary Brand": "Purina Pro Plan", "Lifestage": "Adult"}`) | | maxResults | integer | No | Maximum products to return across all searches | **Example โ€” fast search:** ```json { "keywords": ["dog food", "cat litter"], "scrapeMode": "overview", "sort": "top_rated", "maxResults": 100 } ``` **Example โ€” full detail with ingredients & specs:** ```json { "keywords": ["grain free dog food"], "scrapeMode": "detail", "sort": "top_sold", "maxResults": 50 } ``` *** ### ๐Ÿ“ค Output Results are saved to the Apify dataset with **30+ fields per product**, including: | Field | Type | Description | |-------|------|-------------| | productTitle | string | Product name | | brand | string | Product brand | | sku | string | Buyable item SKU | | upc | string | Universal Product Code (Detail mode) | | price | number | Current selling price | | list\_price | number | List/was price | | repeat\_delivery\_price | number | Repeat Delivery subscription price | | on\_sale | boolean | Whether the current price is below list | | rating | number | Average star rating | | review\_count | number | Total number of reviews | | in\_stock | boolean | Whether the product is available | | pet\_type | string | Primary pet the product is for | | taxonomy | array | Full category path | | diet\_flags | array | Dietary attributes (Grain Free, Organic, โ€ฆ) | | images | array | All product image URLs | | ingredients | string | Full ingredients list (Detail mode) | | guaranteed\_analysis | string | Nutritional breakdown (Detail mode) | | directions | string | Feeding / usage directions (Detail mode) | | dimensions | string | Item dimensions (Detail mode) | | specs | object | Full specifications table (Detail mode) | | description | string | Long product description (Detail mode) | **Example:** ```json { "product_id": "5043283", "productTitle": "Purina Pro Plan Sensitive Skin and Stomach Salmon and Rice Formula Dog Food, 40 lbs.", "brand": "Purina Pro Plan", "sku": "3748364", "price": 94.98, "list_price": 97.99, "on_sale": true, "rating": 4.52, "review_count": 6325, "in_stock": true, "pet_type": "Dog", "taxonomy": ["Consumables", "Food", "Household Pet"], "diet_flags": ["Sensitive Stomach", "With Grain"], "images": ["https://assets.petco.com/petco/image/upload/..."], "ingredients": "Salmon, Rice, Barley, Canola Meal, Oat Meal, Fish Meal...", "guaranteed_analysis": "Crude Protein (Min) 26.0%, Crude Fat (Min) 16.0%...", "specs": { "Lifestage": "Adult", "Primary Flavor": "Fish", "Weight": "30.4 LBS" }, "description": "High protein dry dog food formula, with real salmon as the first ingredient..." } ``` *** ### ๐Ÿ’ผ Use Cases & Examples #### 1. Price Monitoring **Retailers and resellers tracking Petco prices over time to stay competitive.** **Input:** Your product keywords and a daily schedule **Output:** Current price, list price, and sale flags for every match **Use:** Spot price drops, react to sales, and keep your own pricing sharp. #### 2. Competitive Analysis **Pet brands and category managers benchmarking their products against the Petco assortment.** **Input:** Category keywords or a category group **Output:** Competitor prices, ratings, review counts, and sale activity **Use:** Understand where you win or lose on price, rating, and availability. #### 3. Catalog Building **E-commerce teams and marketplaces building a clean product catalog with images and specs.** **Input:** Keywords or category groups, in Detail mode **Output:** Titles, brands, SKUs, UPCs, images, ingredients, and full specifications **Use:** Populate your storefront or PIM with structured, ready-to-use product data. #### 4. Ingredient & Nutrition Research **Vets, nutrition analysts, and pet-food brands studying formulations across the market.** **Input:** Food keywords in Detail mode **Output:** Full ingredient lists and guaranteed analysis per product **Use:** Compare formulas, track ingredient trends, and benchmark nutrition claims. #### 5. Assortment & Availability Research **Merchandisers studying which products carry the best ratings and availability.** **Input:** Category keywords or groups **Output:** Availability flags, pickup/same-day eligibility, and rating data **Use:** Plan assortment, identify gaps, and find top-rated products in a category. #### 6. Market Research & Trend Spotting **Analysts tracking new products, best-sellers, and review momentum.** **Input:** Broad category keywords, sorted by newest or best-selling **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/petco-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/petco-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~petco-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/petco-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, image, and availability. Detail adds the full ingredients list, guaranteed analysis, feeding directions, specifications table, dimensions, all images, and the long description for every product. **Q: Can I get ingredients and nutrition data?** A: Yes โ€” switch `scrapeMode` to `detail` to pull the full ingredients list and guaranteed analysis for pet food and treats. **Q: What output formats are available?** A: JSON, CSV, and Excel โ€” export directly from the Apify dataset. **Q: Can I scrape by category instead of keywords?** A: Yes โ€” use the `browseGroups` field with a Petco category group such as `dog`, `cat`, or `fish`. **Q: Can I filter results?** A: Yes โ€” use the `filters` field to narrow by Petco's own facets (brand, lifestage, flavor, and more). Each run prints the available facets for your search in the log. **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 Petco 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 Petco products - Try a broader search term or a different sort order **Missing ingredients, specs, or description** - Ingredients, guaranteed analysis, and specs only appear in **Detail** mode โ€” switch `scrapeMode` to `detail` **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 Petcoยฎ is a trademark of Petco Animal Supplies, Inc. This actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Petco Animal Supplies, Inc. *** ### โญ Love This Tool? If this actor saves you time, please [leave us a 5-star review](https://apify.com/sian.agency/petco-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, specs & store stock - ๐Ÿช [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 Petco searches โ€” exactly what you'd type into the site's search bar. ๐Ÿ“ **EXAMPLES:** `dog food` ยท `cat litter` ยท `flea treatment` ยท `aquarium filter` ยท `dog crate` ๐Ÿ’ก **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 groups (at least one is needed to have something to scrape). ## `browseGroups` (type: `array`): ๐Ÿงญ **CATEGORY BROWSING (Advanced):** Scrape a whole Petco category instead of a keyword search. ๐Ÿ”ง **HOW TO USE:** Enter a category group such as `dog`, `cat`, `fish`, `bird`, `reptile`, or `small-pet` to sweep that section of the catalog. ๐Ÿ’ก **TIP:** Leave this empty if you're only using keywords โ€” it's purely an advanced alternative for category-level harvesting. ๐Ÿ–Š๏ธ **BULK EDIT:** Add one category group per line to sweep multiple sections in a single run. ## `scrapeMode` (type: `string`): โš™๏ธ **SCRAPE DEPTH:** Choose how much data to pull per product. โšก **Overview (fast):** Search results only โ€” price, customer ratings, image, brand and availability flags. Fastest and cheapest path. ๐Ÿ”ฌ **Detail (enriched):** Everything in Overview PLUS the full specifications table, ingredients, guaranteed analysis, feeding directions, item dimensions, all product images and the long description scraped from each product page. ๐Ÿ’ก **TIP:** Start with Overview to scope your catalog, then switch to Detail when you need complete nutrition and spec data for feeds or comparisons. ## `sort` (type: `string`): ๐Ÿ”ƒ **RESULT ORDERING:** Order search results using Petco's own native sort options โ€” so you get the same ranking real shoppers see. ๐ŸŽฏ **Relevance** is the default ranking ยท ๐Ÿ’ฒ **Price** sorts ascending or descending ยท โญ **Top rated** leads with the highest-reviewed items ยท ๐Ÿ”ฅ **Best selling** surfaces the most popular products ยท ๐Ÿ†• **Newest** prioritizes the latest arrivals ยท ๐Ÿ”ค **Name** sorts Aโ†’Z or Zโ†’A. ## `filters` (type: `object`): ๐Ÿงฐ **FACETED FILTERING (Advanced):** Narrow results by Petco's own filter facets โ€” exactly the filters shown in the left sidebar on the site. ๐Ÿ“ **FORMAT:** A JSON object of facet name โ†’ value, e.g. `{ "Primary Brand": "Purina Pro Plan", "Lifestage": "Adult" }`. ๐Ÿ’ก **TIP:** Each run prints the available facet names and values for your search in the log โ€” copy the ones you want here. Leave empty for no filtering. ## `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": [ "dog food" ], "scrapeMode": "overview", "sort": "relevance", "maxResults": 100 } ``` # Actor output Schema ## `petcoProducts` (type: `string`): Scraped Petco products with prices, ratings, images, ingredients, specs and availability. # 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/petco-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/petco-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/petco-product-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sian.agency/petco-product-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Petco Product Scraper", "description": "Scrape Petco products โ€” price, customer ratings, images, ingredients, guaranteed analysis & full specs. Keyword or category search, full detail enrichment, clean JSON/CSV, no code.", "version": "1.0", "x-build-id": "nLA5bV8RdC0VfCLJG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~petco-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-petco-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~petco-product-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-petco-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~petco-product-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-petco-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 Petco searches โ€” exactly what you'd type into the site's search bar.\n\n๐Ÿ“ **EXAMPLES:** `dog food` ยท `cat litter` ยท `flea treatment` ยท `aquarium filter` ยท `dog crate`\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 groups (at least one is needed to have something to scrape).", "default": [ "dog food" ], "items": { "type": "string" } }, "browseGroups": { "title": "๐Ÿงญ Category Groups (Advanced)", "type": "array", "description": "๐Ÿงญ **CATEGORY BROWSING (Advanced):** Scrape a whole Petco category instead of a keyword search.\n\n๐Ÿ”ง **HOW TO USE:** Enter a category group such as `dog`, `cat`, `fish`, `bird`, `reptile`, or `small-pet` to sweep that section of the catalog.\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 category group per line to sweep multiple sections 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, customer ratings, image, brand and availability flags. Fastest and cheapest path.\n\n๐Ÿ”ฌ **Detail (enriched):** Everything in Overview PLUS the full specifications table, ingredients, guaranteed analysis, feeding directions, item dimensions, all product images and the long description scraped from each product page.\n\n๐Ÿ’ก **TIP:** Start with Overview to scope your catalog, then switch to Detail when you need complete nutrition and spec data for feeds or comparisons.", "default": "overview" }, "sort": { "title": "๐Ÿ”ƒ Sort Order", "enum": [ "relevance", "price_low", "price_high", "top_rated", "top_sold", "newest", "name_az", "name_za" ], "type": "string", "description": "๐Ÿ”ƒ **RESULT ORDERING:** Order search results using Petco's own native sort options โ€” so you get the same ranking real shoppers see.\n\n๐ŸŽฏ **Relevance** is the default ranking ยท ๐Ÿ’ฒ **Price** sorts ascending or descending ยท โญ **Top rated** leads with the highest-reviewed items ยท ๐Ÿ”ฅ **Best selling** surfaces the most popular products ยท ๐Ÿ†• **Newest** prioritizes the latest arrivals ยท ๐Ÿ”ค **Name** sorts Aโ†’Z or Zโ†’A.", "default": "relevance" }, "filters": { "title": "๐Ÿงฐ Facet Filters (Advanced)", "type": "object", "description": "๐Ÿงฐ **FACETED FILTERING (Advanced):** Narrow results by Petco's own filter facets โ€” exactly the filters shown in the left sidebar on the site.\n\n๐Ÿ“ **FORMAT:** A JSON object of facet name โ†’ value, e.g. `{ \"Primary Brand\": \"Purina Pro Plan\", \"Lifestage\": \"Adult\" }`.\n\n๐Ÿ’ก **TIP:** Each run prints the available facet names and values for your search in the log โ€” copy the ones you want here. Leave empty for no filtering." }, "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 } } } } } } } } } } ```