# Croma Product Scraper (`sian.agency/croma-product-scraper`) Actor

Scrape Croma (India) products — INR price, MRP, discount, ratings, images & specs. Keyword or category search, full detail enrichment, clean JSON/CSV, no code.

- **URL**: https://apify.com/sian.agency/croma-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

## Croma Product Scraper — Price, Specs, Ratings & Images (India · INR) 🛍️

[![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) [![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) [![Walmart Data Scraper](https://img.shields.io/badge/Store-Walmart%20Data%20Scraper-0071CE)](https://apify.com/sian.agency/walmart-data-scraper?fpr=sian)

#### 🎉 Turn any Croma search into a clean product dataset — INR prices, MRP, discounts, ratings & full specifications, in seconds
##### Built for pricing analysts, catalog teams, and e-commerce researchers tracking India's largest electronics retailer

---

### 📋 Overview

**Need live Croma product data without copy-pasting from the site?** The Croma Product Scraper turns any keyword or category into a clean, structured dataset — built for anyone monitoring prices, discounts, and catalogs across India's biggest consumer-electronics retailer.

**Why thousands of professionals choose us:**
- ✅ **Complete product records**: INR price, MRP, discount %, ratings, images, brand, category and full specifications — up to 29 fields per product
- ⚡ **Two speeds, one dataset**: fast Overview search or deep Detail enrichment with the full spec sheet
- 🎯 **Real shopper ranking**: sort by Featured, Price, Discount, Top Rated or Latest Arrival — exactly what Croma shows
- 💰 **Pay-per-result pricing**: only pay for the products you actually receive — no wasted spend
- 💎 **No code, no account, no API key**: type a keyword, press run, export JSON/CSV/Excel
- ✨ **NEW**: detail mode adds the complete specifications table, key features, long description, EAN and full image gallery

---

### ✨ Features

- 🔍 **Keyword search**: scrape any term you'd type into the Croma search bar (`laptop`, `smartphone`, `refrigerator`).
- 🧭 **Category browsing**: harvest an entire Croma category by its id.
- 💵 **India pricing**: current INR price, MRP (list price) and discount amount + percent.
- ⭐ **Ratings & reviews**: average star rating, review count and rating count.
- 📋 **Full specifications**: complete key-value spec table in Detail mode (50-70+ attributes on electronics).
- 📸 **Image gallery**: hero image in Overview, full product gallery in Detail.
- 🛡️ **Warranty & EAN**: standard warranty period and barcode for catalog matching.
- 🔃 **Native sorting**: Featured, Price (low/high), Discount, Top Rated, Latest Arrival.
- 📦 **Bulk runs**: many keywords or categories in a single run, all into one dataset.
- 📤 **Clean exports**: JSON, CSV and Excel straight from the Apify dataset.

---

### 🎬 Quick Start

Add one or more keywords, pick a mode, press **Start** — your products land in the dataset, ready to export. You can also run it via the API:

```bash
curl -X POST https://api.apify.com/v2/acts/sian.agency~croma-product-scraper/runs?token=YOUR_TOKEN \
-H 'Content-Type: application/json' \
-d '{"keywords": ["laptop"], "scrapeMode": "overview", "maxResults": 50}'
````

***

### 🚀 Getting Started (3 Simple Steps)

#### Step 1: Add your searches

Enter one or more keywords (e.g. `smartphone`, `headphones`) — or category ids for whole-category harvesting.

#### Step 2: Choose depth & sort

Pick **Overview** (fast) or **Detail** (full specs), and a sort order that matches your research.

#### Step 3: Run & export

Press Start, then download your results as JSON, CSV or Excel.

**That's it! In under a minute, you'll have:**

- A structured table of Croma products with INR prices and discounts
- Ratings, images, brand and category for every product
- A full specifications sheet (in Detail mode) ready for feeds and comparisons

***

### 📥 Input Configuration

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| keywords | array | No\* | Free-text Croma searches (one per line) |
| categoryIds | array | No\* | Croma category ids for whole-category harvesting |
| scrapeMode | string | No | `overview` (fast) or `detail` (full specs). Default `overview` |
| sort | string | No | `relevance`, `price_low`, `price_high`, `discount`, `top_rated`, `newest` |
| maxResults | integer | No | Cap on total products returned. Default 100 |

\*Provide at least one of `keywords` or `categoryIds`.

**Example:**

```json
{
  "keywords": ["laptop", "smartphone"],
  "scrapeMode": "detail",
  "sort": "discount",
  "maxResults": 100
}
```

**Category browsing:**

```json
{
  "categoryIds": ["20"],
  "scrapeMode": "overview",
  "sort": "price_low"
}
```

***

### 📤 Output

Results are saved to the Apify dataset with **29+ fields** including:

| Field | Type | Description |
|-------|------|-------------|
| productTitle | string | Full product name |
| brand | string | Manufacturer / brand |
| price | number | Current selling price (INR) |
| original\_price | number | MRP / list price (INR) |
| discount\_value | string | Discount label (e.g. "14%") |
| discount\_amount | number | Absolute discount (INR) |
| rating | number | Average rating (0–5) |
| review\_count | integer | Number of reviews |
| in\_stock | boolean | Availability |
| warranty | string | Standard warranty (months) |
| breadcrumbs | array | Category trail (detail mode) |
| specs | object | Full specifications table (detail mode) |
| key\_features | array | Key feature bullets (detail mode) |
| images | array | Product image URLs |
| url | string | Product page link |

**Example:**

```json
{
  "item_id": "315070",
  "productTitle": "ASUS Vivobook 16 X1605VA-MB1627WS Intel Core i5 13th Gen Thin & Light Laptop",
  "brand": "Asus",
  "price": 62990,
  "original_price": 72990,
  "currency": "INR",
  "discount_value": "14%",
  "discount_amount": 10000,
  "rating": 4.67,
  "review_count": 1,
  "in_stock": true,
  "warranty": "12",
  "images": ["https://media.tatacroma.com/.../315070_0.png"],
  "url": "https://www.croma.com/asus-vivobook-16-.../p/315070",
  "source": "overview"
}
```

***

### 💼 Use Cases & Examples

#### 1. Price & Discount Monitoring

**Pricing analysts tracking competitor moves on electronics in India.**

**Input:** A list of product keywords on a schedule
**Output:** Daily INR price, MRP and discount snapshots
**Use:** Spot price drops and promotions the moment they go live.

#### 2. Catalog & Assortment Research

**Category managers mapping what's on the shelf.**

**Input:** Category ids for laptops, phones, TVs
**Output:** Full assortment with brands, prices and ratings
**Use:** Benchmark range depth against your own catalog.

#### 3. Competitive Pricing Intelligence

**Brands and retailers benchmarking against Croma.**

**Input:** Your SKUs as keywords, Detail mode
**Output:** Matched products with specs + EAN for accurate mapping
**Use:** Build a like-for-like price comparison feed.

#### 4. Product Feed Enrichment

**Marketplace sellers needing clean spec sheets.**

**Input:** Keywords in Detail mode
**Output:** Full specifications, key features and image galleries
**Use:** Populate product feeds and PDP content at scale.

#### 5. Market & Demand Research

**Analysts studying India's electronics market.**

**Input:** Broad category sweeps
**Output:** Ratings, review counts and pricing distributions
**Use:** Quantify demand and price bands across segments.

#### 6. Deal & Discount Aggregation

**Deal sites surfacing the best savings.**

**Input:** Keywords sorted by Discount
**Output:** Biggest-saving products first, with MRP vs price
**Use:** Auto-build "top deals" lists.

***

### 🔗 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/croma-product-scraper').call({
  keywords: ['laptop'],
  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/croma-product-scraper').call(
    run_input={'keywords': ['laptop'], '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~croma-product-scraper/runs?token=YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"keywords": ["laptop"], "scrapeMode": "overview"}'
```

#### Automation Workflows (N8N / Zapier / Make)

1. **Trigger**: Schedule or webhook
2. **HTTP Request**: Call the actor API
3. **Process**: Handle the JSON results
4. **Action**: Save to a sheet, notify a channel, or update a price feed

***

### 📊 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

💰 **Best value on the market** — transparent pay-per-result pricing with a cheap, high-volume Overview event.

🔗 [View current pricing](https://apify.com/sian.agency/croma-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 currency are the prices in?**
A: Indian Rupees (INR) — including the current price and the MRP (list price).

**Q: What's the difference between Overview and Detail mode?**
A: Overview returns search-result data (price, MRP, discount, rating, hero image). Detail adds the full specifications table, long description, key features, EAN and the complete image gallery.

**Q: Can I scrape a whole category?**
A: Yes — paste the numeric category id from any Croma category URL into `categoryIds`.

**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.

***

### 🐛 Troubleshooting

**No results returned**

- Check the keyword spelling and try a broader term.
- For category runs, confirm the category id from the Croma URL (the number after `/c/`).

**Fewer products than expected**

- FREE tier caps at 25 products per run — upgrade for unlimited.
- Lower-volume searches simply have fewer matching products.

**Specifications are empty**

- Specs are populated in **Detail** mode only. Switch `scrapeMode` to `detail`.

***

### ⚖️ 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:** Croma is a trademark of Infiniti Retail Limited (a Tata Enterprise). This actor is an independent tool and is **not affiliated with, endorsed by, or sponsored by** Croma or Infiniti Retail Limited. All product names, logos, and brands are the property of their respective owners and are used here for identification purposes only.

***

### 🤝 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
- 📧 <apify@sian-agency.online>

***

**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 Croma searches — exactly what you'd type into the site's search bar.

📝 **EXAMPLES:** `laptop` · `smartphone` · `refrigerator` · `headphones` · `smart tv`

💡 **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 ids (at least one is needed to have something to scrape).

## `categoryIds` (type: `array`):

🧭 **CATEGORY BROWSING (Advanced):** Scrape a whole Croma category instead of a keyword search.

🔧 **HOW TO GET IT:** Open any Croma category page and copy the numeric id from the URL (e.g. `croma.com/computers-tablets/laptops/c/20` → category id `20`). Paste just the number here.

💡 **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 id 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 — INR price, MRP, discount, ratings, hero image and brand/category. Fastest and cheapest path.

🔬 **Detail (enriched specs):** Everything in Overview PLUS the full specifications table, long product description, key features and the complete image gallery 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 Croma's own native sort options — so you get the same ranking real shoppers see.

🏆 **Featured** surfaces the most relevant products first · 💲 **Price** sorts ascending or descending · 🏷️ **Discount** leads with the biggest savings · ⭐ **Top rated** leads with the highest-reviewed items · 🆕 **Latest arrival** prioritizes the newest 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": [
    "laptop"
  ],
  "categoryIds": [],
  "scrapeMode": "overview",
  "sort": "relevance",
  "maxResults": 100
}
```

# Actor output Schema

## `cromaProducts` (type: `string`):

Scraped Croma products with INR prices, discounts, ratings, images and specs.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keywords": [
        "laptop"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("sian.agency/croma-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "keywords": ["laptop"] }

# Run the Actor and wait for it to finish
run = client.actor("sian.agency/croma-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": [
    "laptop"
  ]
}' |
apify call sian.agency/croma-product-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=sian.agency/croma-product-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Croma Product Scraper",
        "description": "Scrape Croma (India) products — INR price, MRP, discount, ratings, images & specs. Keyword or category search, full detail enrichment, clean JSON/CSV, no code.",
        "version": "1.0",
        "x-build-id": "F4j8sFEeCaNMSFYkc"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/sian.agency~croma-product-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-sian.agency-croma-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~croma-product-scraper/runs": {
            "post": {
                "operationId": "runs-sync-sian.agency-croma-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~croma-product-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-sian.agency-croma-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 Croma searches — exactly what you'd type into the site's search bar.\n\n📝 **EXAMPLES:** `laptop` · `smartphone` · `refrigerator` · `headphones` · `smart tv`\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 ids (at least one is needed to have something to scrape).",
                        "default": [
                            "laptop"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "categoryIds": {
                        "title": "🧭 Category IDs (Advanced)",
                        "type": "array",
                        "description": "🧭 **CATEGORY BROWSING (Advanced):** Scrape a whole Croma category instead of a keyword search.\n\n🔧 **HOW TO GET IT:** Open any Croma category page and copy the numeric id from the URL (e.g. `croma.com/computers-tablets/laptops/c/20` → category id `20`). Paste just the number here.\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 id per line to sweep multiple categories in a single run.",
                        "default": [],
                        "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 — INR price, MRP, discount, ratings, hero image and brand/category. Fastest and cheapest path.\n\n🔬 **Detail (enriched specs):** Everything in Overview PLUS the full specifications table, long product description, key features and the complete image gallery 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": [
                            "relevance",
                            "price_low",
                            "price_high",
                            "discount",
                            "top_rated",
                            "newest"
                        ],
                        "type": "string",
                        "description": "🔃 **RESULT ORDERING:** Order search results using Croma's own native sort options — so you get the same ranking real shoppers see.\n\n🏆 **Featured** surfaces the most relevant products first · 💲 **Price** sorts ascending or descending · 🏷️ **Discount** leads with the biggest savings · ⭐ **Top rated** leads with the highest-reviewed items · 🆕 **Latest arrival** prioritizes the newest products.",
                        "default": "relevance"
                    },
                    "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
