# REI Product Scraper (`sian.agency/rei-product-scraper`) Actor Scrape REI products โ€” price, ratings, images, colors, specs & features. Keyword or category search, full detail enrichment, clean JSON/CSV, no code. - **URL**: https://apify.com/sian.agency/rei-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 ## REI Product Scraper โ€” Prices, Ratings, Specs & Images ๐Ÿ”๏ธ [![SIรN Agency Store](https://img.shields.io/badge/Store-SI%C3%81N%20Agency-1AE392)](https://apify.com/sian.agency?fpr=sian) [![Walmart Data Scraper](https://img.shields.io/badge/Store-Walmart%20Data%20Scraper-0071CE)](https://apify.com/sian.agency/walmart-data-scraper?fpr=sian) [![Costco Data Scraper](https://img.shields.io/badge/Store-Costco%20Data%20Scraper-E32400)](https://apify.com/sian.agency/costco-data-scraper?fpr=sian) [![Amazon ASIN Lookup](https://img.shields.io/badge/Store-Amazon%20ASIN%20Lookup-FF9900)](https://apify.com/sian.agency/amazon-asin-lookup?fpr=sian) #### ๐ŸŽ‰ Turn any REI search or category into a clean product dataset โ€” 30+ fields per item, prices, ratings, colors & full specs ##### Built for ecommerce analysts, outdoor-gear retailers, price-trackers and market researchers who need REI product data without copy-pasting --- ### ๐Ÿ“‹ Overview **Pull structured product data from REI in minutes** โ€” type a keyword (or point it at a category), and get back a clean, ready-to-use dataset of outdoor gear, apparel and sporting goods, complete with prices, sale/clearance flags, ratings, images, available colors and full specifications. **Why thousands of professionals choose us:** - โœ… **30+ fields per product**: title, brand, price, compare-at price, % off, ratings, review counts, colors, images, specs & more - โšก **Two depths, your call**: fast Overview for catalog sweeps, or Detail for the full spec table, feature list & description - ๐ŸŽฏ **Native search & sorting**: keyword search or category browse, ordered exactly like real REI shoppers see it - ๐Ÿ’ฐ **Pay only for what you get**: transparent pay-per-result pricing โ€” never pay for a product you didn't receive - ๐Ÿ’Ž **Sale & clearance intelligence**: see on-sale, clearance and outlet flags plus the discount percentage at a glance - โœจ **No code, no account, no setup**: paste a keyword, hit run, export to JSON/CSV/Excel --- ### โœจ Features - ๐Ÿ” **Keyword Search**: scrape exactly what you'd type into REI's search bar โ€” `hiking boots`, `backpacking tent`, `down jacket` - ๐Ÿงญ **Category Browsing**: harvest a whole category by its path (e.g. `/c/tents`) โ€” great for full-assortment research - ๐Ÿ’ฒ **Complete Pricing**: current price, compare-at/regular price, sale & outlet prices, and the discount percentage - โญ **Ratings & Reviews**: average star rating, review counts, and (in Detail mode) the full star-by-star histogram - ๐ŸŽจ **Colors & Images**: every available colorway plus all product image URLs (hero image first) - ๐Ÿ“‹ **Full Specifications**: the complete technical spec table, feature bullets and long description in Detail mode - ๐Ÿ”ƒ **Native Sorting**: best match, top rated, price lowโ†’high / highโ†’low, newest, or Aโ€“Z - ๐Ÿ“ฆ **Bulk Friendly**: queue many keywords or categories in one run โ€” all results land in a single dataset - ๐Ÿ“ค **Clean Exports**: JSON, CSV and Excel straight from the Apify dataset --- ### ๐ŸŽฌ Quick Start Add one or more search keywords, pick a scrape mode, and run. In under a minute you'll have a structured dataset you can export or pipe into your tools. ```bash curl -X POST "https://api.apify.com/v2/acts/sian.agency~rei-product-scraper/runs?token=YOUR_TOKEN" \ -H 'Content-Type: application/json' \ -d '{"keywords": ["hiking boots"], "scrapeMode": "overview", "maxResults": 50}' ```` *** ### ๐Ÿš€ Getting Started (3 Simple Steps) #### Step 1: Enter your searches Add one or more keywords (e.g. `backpacking tent`), or paste a category path for whole-category browsing. #### Step 2: Choose your depth Pick **Overview** for a fast catalog sweep, or **Detail** for the full spec table, features and description. #### Step 3: Run & export Hit **Start**, watch the products roll in, and export to JSON, CSV or Excel. **That's it! In about a minute, you'll have:** - A clean dataset of REI products with prices and ratings - Images and available colors for each item - Full specifications and features (in Detail mode) *** ### ๐Ÿ“ฅ Input Configuration | Field | Type | Required | Description | |-------|------|----------|-------------| | keywords | array | No | Free-text REI searches (one per line) | | categories | array | No | REI category paths for browsing (e.g. `/c/tents`) | | scrapeMode | string | No | `overview` (fast) or `detail` (full specs) | | sort | string | No | `best_match`, `top_rated`, `price_low`, `price_high`, `newest`, `name` | | maxResults | integer | No | Max products across all searches (FREE: 25, PAID: unlimited) | > Provide at least one keyword **or** one category. **Example โ€” keyword search:** ```json { "keywords": ["hiking boots", "trail running shoes"], "scrapeMode": "overview", "sort": "top_rated", "maxResults": 100 } ``` **Example โ€” category browse, full detail:** ```json { "categories": ["/c/tents"], "scrapeMode": "detail", "maxResults": 50 } ``` *** ### ๐Ÿ“ค Output Results are saved to the Apify dataset with **30+ fields** including: | Field | Type | Description | |-------|------|-------------| | productTitle | string | Product title / name | | brand | string | Product brand (e.g. REI Co-op, Merrell) | | price | number | Current selling price | | compare\_at\_price | number | Strikethrough / regular price | | percentage\_off | number | Discount percentage off regular | | on\_sale / clearance / outlet | boolean | Promotion flags | | rating | number | Average customer rating (0โ€“5) | | review\_count | integer | Number of customer reviews | | available\_colors | array | Available colorways | | images | array | All product image URLs (hero first) | | category | string | Primary product category | | description | string | Product description / benefit copy | | features | array | Feature bullet list (Detail mode) | | tech\_specs | object | Full technical spec table (Detail mode) | | url | string | Canonical product page URL | **Example:** ```json { "item_id": "237596", "productTitle": "Moab 3 Mid Waterproof Hiking Boots - Men's", "brand": "Merrell", "price": 170.00, "compare_at_price": 170.00, "on_sale": null, "rating": 4.5, "review_count": 312, "available_colors": ["BELUGA", "EARTH", "OLIVE/GUM"], "images": ["https://www.rei.com/media/76821bdb-5e66-4e88-922c-5041174893b5"], "category": "Hiking Boots", "url": "https://www.rei.com/product/237596/merrell-moab-3-mid-waterproof-hiking-boots-mens" } ``` *** ### ๐Ÿ’ผ Use Cases & Examples #### 1. Price & Promotion Monitoring **Retailers and analysts tracking outdoor-gear pricing over time.** **Input:** Keywords or categories you want to watch **Output:** Current price, compare-at price, % off, sale/clearance/outlet flags **Use:** Build a daily price tracker and alert on discounts. #### 2. Catalog & Assortment Research **Buyers mapping what's available in a category.** **Input:** A category path like `/c/tents` **Output:** Every product with brand, price, rating and colors **Use:** Understand assortment breadth, brand mix and price tiers. #### 3. Competitor Pricing Intelligence **Brands and merchandisers benchmarking against REI.** **Input:** Your product keywords **Output:** REI's prices, ratings and promotion status **Use:** Position your own pricing and promotions competitively. #### 4. Product-Feed & Spec Extraction **Teams building product feeds or comparison content.** **Input:** Keywords in Detail mode **Output:** Full spec tables, feature lists and descriptions **Use:** Populate feeds, comparison tables and buying guides. #### 5. Market & Demand Research **Researchers analyzing the outdoor-gear market.** **Input:** Broad keywords across categories **Output:** Ratings, review counts and price distributions **Use:** Spot popular products, gaps and rating trends. #### 6. Review & Reputation Analysis **Analysts studying customer sentiment.** **Input:** Detail mode for top products **Output:** Average rating plus the full star-by-star histogram **Use:** Quantify satisfaction and compare products head-to-head. *** ### ๐Ÿ”— 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/rei-product-scraper').call({ keywords: ['hiking boots'], 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/rei-product-scraper').call( run_input={'keywords': ['hiking boots'], '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~rei-product-scraper/runs?token=YOUR_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"keywords": ["hiking boots"], "scrapeMode": "overview"}' ``` #### Automation Workflows (N8N / Zapier / Make) 1. **Trigger**: Schedule or webhook 2. **HTTP Request**: Call the actor 3. **Process**: Handle JSON results 4. **Action**: Save to a sheet, notify, or transform *** ### ๐Ÿ“Š Performance & Pricing #### FREE Tier (Try It Now) - **25 products** per run โ€” full feature access, same quality - No credit card required - Perfect for testing and small projects #### PAID Tier (Production Ready) - **Unlimited** products per run - Faster processing, no delays - Pay-per-result: only charged for the products you receive ๐Ÿ’ฐ **Transparent pay-per-result pricing** โ€” a cheap, high-volume Overview event and a premium Detail event for full specs. ๐Ÿ”— [View current pricing](https://apify.com/sian.agency/rei-product-scraper?fpr=sian) *** ### โ“ Frequently Asked Questions **Q: How many products can I scrape?** A: FREE tier: 25 per run. PAID tier: unlimited. **Q: What's the difference between Overview and Detail?** A: Overview returns search-result data (price, ratings, images, colors). Detail adds the full spec table, feature list, long description and rating histogram from each product page. **Q: Can I scrape a whole category?** A: Yes โ€” paste a category path (e.g. `/c/tents`) into the Categories field. **Q: What output formats are available?** A: JSON, CSV and Excel โ€” export directly from the Apify dataset. **Q: Does it scrape private or account-only data?** A: No โ€” only publicly available product information shown on REI's site. **Q: How fresh is the data?** A: Every run fetches live data at the moment it runs. *** ### ๐Ÿ› Troubleshooting **No products returned** - Check the keyword spelling, or try a broader term - For categories, make sure the path matches a real REI category (e.g. `/c/tents`) **Fewer results than expected** - FREE tier is capped at 25 products per run โ€” upgrade for unlimited - Lower the `maxResults` only caps the total; raise it to get more **Missing specs/features** - Specs, features and the long description only populate in **Detail** mode *** ### โš–๏ธ 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 the user has chosen to share publicly. 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 notice:** REI and REI Co-op are trademarks of Recreational Equipment, Inc. This actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Recreational Equipment, Inc. All product names, logos and brands are the property of their respective owners. *** ### ๐Ÿค 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 [SIรN Agency Store](https://apify.com/sian.agency?fpr=sian) for more automation tools - ๐Ÿ“ง *** **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 REI searches โ€” exactly what you'd type into the site's search bar. ๐Ÿ“ **EXAMPLES:** `hiking boots` ยท `backpacking tent` ยท `down jacket` ยท `trail running shoes` ๐Ÿ’ก **TIP:** Add one keyword per line โ€” each runs as its own search and all results land in the same dataset. ๐Ÿ–Š๏ธ **BULK EDIT:** Click "Bulk edit" to paste many keywords at once (one per line). โœ… **IMPORTANT:** Provide either keywords OR category paths (at least one is needed to have something to scrape). ## `categories` (type: `array`): ๐Ÿงญ **CATEGORY BROWSING (Advanced):** Scrape a whole REI category instead of a keyword search. ๐Ÿ”ง **HOW TO GET IT:** Open any REI category page and copy the `/c/` path from the URL (e.g. `/c/tents` from `rei.com/c/tents`). Paste either the full path (`/c/tents`) or just the slug (`tents`). ๐Ÿ’ก **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 per line to sweep multiple categories in a single run. ## `scrapeMode` (type: `string`): โš™๏ธ **SCRAPE DEPTH:** Choose how much data to pull per product. โšก **Overview (fast):** Search results only โ€” title, brand, price (current/sale/compare-at), ratings, images, available colors and stock flags. Fastest and cheapest path. ๐Ÿ”ฌ **Detail (enriched specs):** Everything in Overview PLUS the full technical specifications table, the complete feature list, the long product description, the rating histogram and category breadcrumbs scraped from each product page. ๐Ÿ’ก **TIP:** Start with Overview to scope your catalog, then switch to Detail when you need the complete spec sheet for feeds or comparisons. ## `sort` (type: `string`): ๐Ÿ”ƒ **RESULT ORDERING:** Order search results using REI's own native sort options โ€” so you get the same ranking real shoppers see. ๐ŸŽฏ **Best match** is REI's default relevance ranking ยท โญ **Top rated** leads with the highest-reviewed items ยท ๐Ÿ’ฒ **Price** sorts ascending or descending ยท ๐Ÿ†• **Newest** prioritizes the latest arrivals ยท ๐Ÿ”ฅ **Bestselling** surfaces the most popular products. ## `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": [ "hiking boots" ], "scrapeMode": "overview", "sort": "best_match", "maxResults": 100 } ``` # Actor output Schema ## `reiProducts` (type: `string`): Scraped REI products with prices, promotions, ratings, images, colors, specs and features. # 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": [ "hiking boots" ] }; // Run the Actor and wait for it to finish const run = await client.actor("sian.agency/rei-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": ["hiking boots"] } # Run the Actor and wait for it to finish run = client.actor("sian.agency/rei-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": [ "hiking boots" ] }' | apify call sian.agency/rei-product-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sian.agency/rei-product-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "REI Product Scraper", "description": "Scrape REI products โ€” price, ratings, images, colors, specs & features. Keyword or category search, full detail enrichment, clean JSON/CSV, no code.", "version": "1.0", "x-build-id": "fYvigauxY87flL1Vn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~rei-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-rei-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~rei-product-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-rei-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~rei-product-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-rei-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 REI searches โ€” exactly what you'd type into the site's search bar.\n\n๐Ÿ“ **EXAMPLES:** `hiking boots` ยท `backpacking tent` ยท `down jacket` ยท `trail running shoes`\n\n๐Ÿ’ก **TIP:** Add one keyword per line โ€” each runs as its own search and all results land in the same dataset.\n\n๐Ÿ–Š๏ธ **BULK EDIT:** Click \"Bulk edit\" to paste many keywords at once (one per line).\n\nโœ… **IMPORTANT:** Provide either keywords OR category paths (at least one is needed to have something to scrape).", "default": [ "hiking boots" ], "items": { "type": "string" } }, "categories": { "title": "๐Ÿงญ Category Paths (Advanced)", "type": "array", "description": "๐Ÿงญ **CATEGORY BROWSING (Advanced):** Scrape a whole REI category instead of a keyword search.\n\n๐Ÿ”ง **HOW TO GET IT:** Open any REI category page and copy the `/c/` path from the URL (e.g. `/c/tents` from `rei.com/c/tents`). Paste either the full path (`/c/tents`) or just the slug (`tents`).\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 per line to sweep multiple categories in a single run.", "items": { "type": "string" } }, "scrapeMode": { "title": "โš™๏ธ Scrape Mode", "enum": [ "overview", "detail" ], "type": "string", "description": "โš™๏ธ **SCRAPE DEPTH:** Choose how much data to pull per product.\n\nโšก **Overview (fast):** Search results only โ€” title, brand, price (current/sale/compare-at), ratings, images, available colors and stock flags. Fastest and cheapest path.\n\n๐Ÿ”ฌ **Detail (enriched specs):** Everything in Overview PLUS the full technical specifications table, the complete feature list, the long product description, the rating histogram and category breadcrumbs scraped from each product page.\n\n๐Ÿ’ก **TIP:** Start with Overview to scope your catalog, then switch to Detail when you need the complete spec sheet for feeds or comparisons.", "default": "overview" }, "sort": { "title": "๐Ÿ”ƒ Sort Order", "enum": [ "best_match", "top_rated", "price_low", "price_high", "newest", "bestselling" ], "type": "string", "description": "๐Ÿ”ƒ **RESULT ORDERING:** Order search results using REI's own native sort options โ€” so you get the same ranking real shoppers see.\n\n๐ŸŽฏ **Best match** is REI's default relevance ranking ยท โญ **Top rated** leads with the highest-reviewed items ยท ๐Ÿ’ฒ **Price** sorts ascending or descending ยท ๐Ÿ†• **Newest** prioritizes the latest arrivals ยท ๐Ÿ”ฅ **Bestselling** surfaces the most popular products.", "default": "best_match" }, "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 } } } } } } } } } } ```