# Pets at Home Product Scraper (`sian.agency/pets-at-home-product-scraper`) Actor Scrape Pets at Home products โ€” GBP price, ratings, images, specs, composition & stock. Keyword search, full detail enrichment, clean JSON/CSV, no code. - **URL**: https://apify.com/sian.agency/pets-at-home-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 ## Pets at Home Product Scraper โ€” Prices, Specs & Stock ๐Ÿพ [![SIรN Agency Store](https://img.shields.io/badge/Store-SI%C3%81N%20Agency-1AE392)](https://apify.com/sian.agency?fpr=sian) [![Google Shopping Price Scraper](https://img.shields.io/badge/Store-Google%20Shopping%20Price%20Scraper-4285F4)](https://apify.com/sian.agency/google-shopping-price-scraper?fpr=sian) [![Amazon Influencer & Deals Scraper](https://img.shields.io/badge/Store-Amazon%20Deals%20Scraper-FF9900)](https://apify.com/sian.agency/amazon-influencer-deals-scraper?fpr=sian) #### ๐ŸŽ‰ Pull Pets at Home prices, offers, ratings, and stock โ€” by keyword across the full UK catalogue, no code ##### Built for retail analysts, e-commerce sellers, and pet brands who need fresh Pets at Home product data on demand --- ### ๐Ÿ“‹ Overview **Track every price, offer, and product spec on Pets at Home โ€” without writing a single line of code.** This scraper turns any Pets at Home search into a clean, structured spreadsheet of products, complete with GBP prices, ratings, images, composition and stock. **Why professionals choose us:** - โœ… **Complete product data**: 40+ fields per product โ€” price (ยฃ), price-per-unit, offers, rating, review count, brand, flavour, variants, and more - โšก **Fast search-first mode**: pull 40 products per page in seconds; scale to thousands across multiple searches - ๐Ÿพ **Pet-specific detail**: full ingredient composition, nutritional additives, calorie content, feeding guide and the attribute table โ€” the data generic scrapers miss - ๐Ÿ’ฐ **Pay only for results**: charged per product you actually receive โ€” no wasted spend, free tier to test - ๐Ÿ’Ž **Detail enrichment**: add composition, attributes, dimensions and category breadcrumbs with one switch - โœจ **Native sorting**: best match, price low/high, new in, or biggest discount โ€” just like the Pets at Home site --- ### โœจ Features - ๐Ÿ”Ž **Keyword Search**: scrape any Pets at Home search term across the whole UK catalogue - ๐Ÿท๏ธ **Full Pricing (GBP)**: current price, regular/was price, promotion price, discount value, and offer flags - ๐Ÿ“ **Price Per Unit**: ยฃ per kg / per litre for clean like-for-like comparison - โญ **Ratings & Reviews**: star rating and total review count for every product - ๐Ÿ–ผ๏ธ **Product Images**: all product image URLs, ready for catalogues or feeds - ๐Ÿงช **Composition & Nutrition**: full ingredient composition, additives, calorie content and feeding guide (Detail mode) - ๐Ÿ“‹ **Attribute Table**: structured attributes โ€” food format, packaging type, pet/dog size, life stage, and more - ๐Ÿงญ **Breadcrumbs & Categories**: the product's full category path for clean classification - ๐Ÿ“ฆ **Variants & Sizes**: variant count and size/pack descriptors for every product - ๐Ÿš€ **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 Pets at Home products you can download as JSON or CSV. No setup, no code. ```bash curl -X POST https://api.apify.com/v2/acts/sian.agency~pets-at-home-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 Pets at Home search keywords (e.g. `dog food`, `cat litter`, `flea treatment`) โ€” one per line. #### Step 2: Choose Your Mode Pick **Overview** for fast search results, or **Detail** to also pull the full composition, additives, feeding guide and attribute table. #### 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 Pets at Home products with GBP prices and offers - Ratings, review counts, and product images - Variants, sizes and price-per-unit for every product *** ### ๐Ÿ“ฅ Input Configuration | Field | Type | Required | Description | |-------|------|----------|-------------| | keywords | array | No | Pets at Home search terms, one per item (e.g. `dog food`) | | scrapeMode | string | No | `overview` (fast search) or `detail` (adds composition + attributes + feeding guide) | | sort | string | No | `best_match`, `price_low`, `price_high`, `newest`, or `biggest_discount` | | maxResults | integer | No | Maximum products to return across all searches | **Example โ€” fast search:** ```json { "keywords": ["dog food", "cat litter"], "scrapeMode": "overview", "sort": "best_match", "maxResults": 100 } ``` **Example โ€” full detail with composition:** ```json { "keywords": ["wet dog food"], "scrapeMode": "detail", "sort": "biggest_discount", "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 | | price | number | Current price (GBP) | | price\_per\_unit | number | Price per unit (e.g. ยฃ/kg) | | regular\_price | number | Pre-discount price when on offer | | on\_offer | boolean | Whether the product is currently on a promotion | | rating | number | Average star rating | | review\_count | number | Total number of reviews | | is\_in\_stock | boolean | Whether the product is in stock | | variant\_count | number | Number of size/variant options | | net\_values | array | Size / pack descriptors | | pet\_category | string | Pet the product is for (Dog, Cat, โ€ฆ) | | images | array | All product image URLs | | breadcrumbs | array | Full category path (Detail mode) | | composition | string | Ingredient composition (Detail mode) | | calorie\_content | string | Calorie content text (Detail mode) | | attributes | object | Structured attribute table (Detail mode) | **Example:** ```json { "item_id": "7157748P", "productTitle": "Pets at Home Complete Nutrition Meaty Selection in Jelly Wet Dog Food", "brand": "Pets At Home", "price": 13.16, "currency": "GBP", "price_per_unit": 1.37, "price_per_unit_uom": "kg", "on_offer": false, "rating": null, "review_count": null, "is_in_stock": true, "variant_count": 1, "net_values": ["24 x 400g"], "pet_category": "Dog", "images": ["https://cdn.petsathome.com/public/images/products/900_7157748P.jpg"], "breadcrumbs": ["Wet Dog Food", "Dog Food", "Dog"], "composition": "Meat and Animal Derivatives (32%, including 4% Chicken), Cereals, Minerals...", "calorie_content": "Calculated Calorie Content: This food contains 75 kcal/100g ME.", "attributes": { "foodFormat": "Wet", "foodTexture": "In Jelly", "packagingType": "Tin" } } ``` *** ### ๐Ÿ’ผ Use Cases & Examples #### 1. Price Monitoring **Retailers and resellers tracking Pets at Home prices over time to stay competitive.** **Input:** Your product keywords and a daily schedule **Output:** Current price, regular price, and offer 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 Pets at Home assortment.** **Input:** Category keywords **Output:** Competitor prices, price-per-unit, ratings, review counts, and offer activity **Use:** Understand where you win or lose on price, rating, and availability. #### 3. Catalogue Building **E-commerce teams building a clean pet-product catalogue with images and composition.** **Input:** Keywords, in Detail mode **Output:** Titles, brands, images, composition, additives, and full attribute tables **Use:** Populate your storefront or PIM with structured, ready-to-use product data. #### 4. Nutrition & Ingredient Research **Vets, nutritionists and pet-food brands comparing composition and calorie content.** **Input:** Food-category keywords in Detail mode **Output:** Ingredient composition, nutritional additives, calorie content and feeding guides **Use:** Compare recipes and nutritional profiles across the catalogue. #### 5. Assortment & Availability Research **Merchandisers studying which products carry the best ratings and live stock.** **Input:** Category keywords **Output:** Stock flags, variant counts, ratings and offer data **Use:** Plan assortment, identify stockouts, 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 biggest discount **Output:** Product launches, offer 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/pets-at-home-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/pets-at-home-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~pets-at-home-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/pets-at-home-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 currency are the prices in?** A: Pets at Home is a UK retailer, so all prices are in **GBP (ยฃ)**. **Q: What's the difference between Overview and Detail mode?** A: Overview is the fast path โ€” search results with price, ratings, images, variants and stock. Detail adds the full ingredient composition, nutritional additives, calorie content, feeding guide and attribute table for every product. **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 Pets at Home 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 Pets at Home products - Try a broader search term or a different sort order **Missing composition or attributes** - Composition, additives and attribute tables 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 Pets at Homeยฎ is a trademark of Pets at Home Group Plc. This actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Pets at Home Group Plc. *** ### โญ Love This Tool? If this actor saves you time, please [leave us a 5-star review](https://apify.com/sian.agency/pets-at-home-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 - ๐Ÿ›๏ธ [Google Shopping Price Scraper](https://apify.com/sian.agency/google-shopping-price-scraper?fpr=sian) โ€” track offers and price history across the web - ๐Ÿ“ฆ [Amazon Influencer & Deals Scraper](https://apify.com/sian.agency/amazon-influencer-deals-scraper?fpr=sian) โ€” Amazon deals and influencer storefront data *** **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 Pets at Home searches โ€” exactly what you'd type into the site's search bar. ๐Ÿ“ **EXAMPLES:** `dog food` ยท `cat litter` ยท `flea treatment` ยท `aquarium filter` ยท `dog bed` ๐Ÿ’ก **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 at least one keyword โ€” it's needed to have something to scrape. ## `scrapeMode` (type: `string`): โš™๏ธ **SCRAPE DEPTH:** Choose how much data to pull per product. โšก **Overview (fast):** Search results only โ€” GBP price, ratings, images, brand, flavour, price-per-unit and stock. Fastest and cheapest path. ๐Ÿ”ฌ **Detail (enriched specs):** Everything in Overview PLUS the full composition, additives, calorie content, feeding guide, attribute table, dimensions and category breadcrumbs scraped from each product page. ๐Ÿ’ก **TIP:** Start with Overview to scope the catalogue, then switch to Detail when you need the complete spec sheet for feeds or comparisons. ## `sort` (type: `string`): ๐Ÿ”ƒ **RESULT ORDERING:** Order search results using Pets at Home's own native sort options โ€” so you get the same ranking real shoppers see. ๐Ÿ† **Best match** is the default relevance order ยท ๐Ÿ’ฒ **Price** sorts ascending or descending ยท ๐Ÿ†• **New in** prioritises the latest arrivals ยท ๐Ÿท๏ธ **Biggest discount** leads with the largest offers. ## `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 catalogues 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": "best_match", "maxResults": 100 } ``` # Actor output Schema ## `petsAtHomeProducts` (type: `string`): Scraped Pets at Home products with GBP prices, promotions, ratings, images, specs and 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/pets-at-home-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/pets-at-home-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/pets-at-home-product-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sian.agency/pets-at-home-product-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Pets at Home Product Scraper", "description": "Scrape Pets at Home products โ€” GBP price, ratings, images, specs, composition & stock. Keyword search, full detail enrichment, clean JSON/CSV, no code.", "version": "1.0", "x-build-id": "M0iwA8nfFJhcijcbV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~pets-at-home-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-pets-at-home-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~pets-at-home-product-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-pets-at-home-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~pets-at-home-product-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-pets-at-home-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 Pets at Home searches โ€” exactly what you'd type into the site's search bar.\n\n๐Ÿ“ **EXAMPLES:** `dog food` ยท `cat litter` ยท `flea treatment` ยท `aquarium filter` ยท `dog bed`\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 at least one keyword โ€” it's needed 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 only โ€” GBP price, ratings, images, brand, flavour, price-per-unit and stock. Fastest and cheapest path.\n\n๐Ÿ”ฌ **Detail (enriched specs):** Everything in Overview PLUS the full composition, additives, calorie content, feeding guide, attribute table, dimensions and category breadcrumbs scraped from each product page.\n\n๐Ÿ’ก **TIP:** Start with Overview to scope the catalogue, then switch to Detail when you need the complete spec sheet for feeds or comparisons.", "default": "overview" }, "sort": { "title": "๐Ÿ”ƒ Sort Order", "enum": [ "best_match", "price_low", "price_high", "newest", "biggest_discount" ], "type": "string", "description": "๐Ÿ”ƒ **RESULT ORDERING:** Order search results using Pets at Home's own native sort options โ€” so you get the same ranking real shoppers see.\n\n๐Ÿ† **Best match** is the default relevance order ยท ๐Ÿ’ฒ **Price** sorts ascending or descending ยท ๐Ÿ†• **New in** prioritises the latest arrivals ยท ๐Ÿท๏ธ **Biggest discount** leads with the largest offers.", "default": "best_match" }, "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 catalogues 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 } } } } } } } } } } ```