# MercadoLibre Product Scraper (`sian.agency/mercado-libre-product-scraper`) Actor

Scrape MercadoLibre products across Argentina, Brazil, Mexico & Chile — price, condition, seller, ratings, specs & images. Keyword or URL search, full detail enrichment, dual-currency USD, clean JSON/CSV, no code.

- **URL**: https://apify.com/sian.agency/mercado-libre-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 $1.50 / 1,000 overview product extracteds

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

## MercadoLibre Product Scraper — Prices, Sellers, Ratings & Specs 🛒

[![SIÁN Agency Store](https://img.shields.io/badge/Store-SI%C3%81N%20Agency-1AE392)](https://apify.com/sian.agency?fpr=sian) [![Taobao & Tmall Product Scraper](https://img.shields.io/badge/Store-Taobao%20%26%20Tmall-FF4F00)](https://apify.com/sian.agency/taobao-tmall-product-scraper?fpr=sian) [![1688 Wholesale Scraper](https://img.shields.io/badge/Store-1688%20Wholesale-FF6A00)](https://apify.com/sian.agency/alibaba-1688-wholesale-scraper?fpr=sian) [![JD.com Product Scraper](https://img.shields.io/badge/Store-JD.com%20Products-E3101A)](https://apify.com/sian.agency/jd-com-product-scraper?fpr=sian)

#### 🎉 Scrape MercadoLibre across Argentina, Brazil, Mexico & Chile — every product field, in one clean dataset
##### Built for price-monitoring teams, resellers, and market researchers across Latin America

---

### 📋 Overview

**Track an entire MercadoLibre category in minutes** — this scraper turns any keyword search or listing URL into a structured dataset of products with prices, condition, sellers, ratings, full spec tables and image galleries, across the four biggest MercadoLibre marketplaces.

**Why teams choose this scraper:**
- ✅ **Four countries, one actor**: Argentina, Brazil, Mexico and Chile — switch with a single field.
- ⚡ **Two speeds**: a fast Overview list scrape for price snapshots, or a full Detail scrape with seller, ratings, sold quantity and the complete spec table.
- 🎯 **Complete product records**: up to 28 fields per product — price, original price, condition, brand, rating, review count, sold quantity, free-shipping flag, full specifications and every image.
- 💵 **Dual currency**: every local price (ARS, BRL, MXN, CLP) is normalized to USD with a live FX rate, so you can compare across countries instantly.
- 💰 **Pay per result**: only successful products are charged — no monthly subscription.
- ✨ **No code, no account**: paste a keyword or URL and press Start.

---

### ✨ Features

- 🌎 **Multi-country**: scrape Argentina, Brazil, Mexico or Chile marketplaces.
- 🔍 **Keyword or URL search**: type a keyword or paste any pre-filtered listing URL — your filters are preserved.
- 📋 **Overview & Detail modes**: cheap list scrape or rich per-product detail.
- 💲 **Full pricing**: current price, struck-through original price, currency, and a normalized USD value.
- ⭐ **Ratings & social proof**: average rating, review count and sold quantity.
- 🏪 **Seller data**: store name and seller signals.
- 🔧 **Complete spec tables**: every technical attribute as clean key:value rows.
- 🖼️ **Image galleries**: all hi-res product photos, with a thumbnail-first field.
- 🚚 **Filters**: new/used condition, price range, free shipping, and sort order.
- 📤 **Clean export**: JSON, CSV and Excel, straight from the dataset.

---

### 🎬 Quick Start

Pick a country, type a keyword (or paste a search URL), choose Overview or Detail, and press Start. Results stream into the dataset as they are extracted.

```bash
curl -X POST "https://api.apify.com/v2/acts/sian.agency~mercado-libre-product-scraper/runs?token=YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"scrapeMode":"overview","site":"MLA","searchQueries":["notebook gamer"],"maxResults":100}'
````

***

### 🚀 Getting Started (3 Simple Steps)

#### Step 1: Choose your country & mode

Select Argentina, Brazil, Mexico or Chile, and pick Overview (fast list) or Detail (full product page).

#### Step 2: Enter what to scrape

Type one or more search keywords, or paste a MercadoLibre listing URL. In Detail mode you can also paste product URLs or IDs directly.

#### Step 3: Press Start

The scraper extracts the products and streams them to your dataset.

**That's it! In a few minutes, you'll have:**

- A structured product dataset (JSON / CSV / Excel)
- Prices in local currency **and** USD
- A clean run report with a sample preview

***

### 📥 Input Configuration

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| scrapeMode | string | No | `overview` (fast list) or `detail` (full product page) |
| site | string | No | Country: `MLA` (AR), `MLB` (BR), `MLM` (MX), `MLC` (CL) |
| searchQueries | array | No | Search keywords, one product family per line |
| searchUrls | array | No | Paste full listing URLs (filters preserved) |
| detailUrls | array | No | Product URLs or IDs to scrape directly (Detail mode) |
| sort | string | No | `relevance`, `price_asc`, `price_desc` |
| condition | string | No | `new` or `used` |
| priceMin / priceMax | integer | No | Price-range filter (local currency) |
| freeShipping | boolean | No | Only free-shipping items |
| maxResults | integer | No | Max products (FREE capped at 20) |

**Example:**

```json
{
  "scrapeMode": "detail",
  "site": "MLB",
  "searchQueries": ["iphone 15"],
  "condition": "new",
  "maxResults": 200
}
```

***

### 📤 Output

Results are saved to the Apify dataset with **up to 28 fields** including:

| Field | Type | Description |
|-------|------|-------------|
| id | string | Product ID (e.g. MLA-1234567890) |
| title | string | Product title |
| price | number | Current price (local currency) |
| originalPrice | number | Struck-through original price |
| currency | string | Local currency (ARS, BRL, MXN, CLP) |
| priceUsd | number | Price normalized to USD |
| condition | string | New / Used / Refurbished |
| rating | number | Average buyer rating |
| reviewCount | number | Number of reviews |
| soldQuantity | string | Units sold |
| seller | string | Store / seller name |
| brand | string | Product brand |
| attributes | array | Full spec table (key:value) |
| images | array | All product image URLs |
| url | string | Product page URL |

**Example:**

```json
{
  "id": "MLA-22826188",
  "title": "Notebook EXO Smart T38 Intel N4020 4GB SSD 128GB Windows 11",
  "price": 318449,
  "originalPrice": 569999,
  "currency": "ARS",
  "priceUsd": 264.32,
  "condition": "Nuevo",
  "rating": 4.6,
  "reviewCount": 5207,
  "seller": "Tienda oficial EXO",
  "brand": "EXO",
  "attributes": ["Marca: EXO", "Memoria RAM: 4 GB", "Sistema operativo: Windows 11"],
  "imageCount": 18,
  "url": "https://www.mercadolibre.com.ar/.../p/MLA22826188"
}
```

***

### 💼 Use Cases & Examples

#### 1. Price Monitoring

**E-commerce teams tracking competitor prices across LatAm.**
**Input:** Keyword or category URL · **Output:** Daily price + stock snapshots · **Use:** Repricing, promotion timing.

#### 2. Reseller & Arbitrage Research

**Resellers finding underpriced inventory.**
**Input:** Product keywords with price filters · **Output:** Price, condition, seller, sold quantity · **Use:** Spot arbitrage opportunities.

#### 3. Market & Demand Analysis

**Analysts sizing a product category.**
**Input:** Broad keyword across countries · **Output:** Price distribution, ratings, sold quantity · **Use:** Demand and price benchmarking.

#### 4. Catalog & Content Building

**Marketplaces and apps building a product catalog.**
**Input:** Search URLs · **Output:** Titles, specs, images, brands · **Use:** Seed a catalog with clean structured data.

#### 5. Dropshipping Product Discovery

**Dropshippers sourcing trending items.**
**Input:** Trending keywords · **Output:** Best-sellers by sold quantity + rating · **Use:** Validate winning products.

#### 6. Brand & Reputation Tracking

**Brands monitoring their listings and resellers.**
**Input:** Brand keyword · **Output:** Sellers, prices, ratings · **Use:** Detect unauthorized sellers and price erosion.

***

### 🔗 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/mercado-libre-product-scraper').call({
  scrapeMode: 'overview',
  site: 'MLA',
  searchQueries: ['notebook gamer'],
});

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/mercado-libre-product-scraper').call(
    run_input={'scrapeMode': 'overview', 'site': 'MLB', 'searchQueries': ['iphone']}
)

for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item)
```

#### cURL

```bash
curl -X POST 'https://api.apify.com/v2/acts/sian.agency~mercado-libre-product-scraper/runs?token=YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"scrapeMode":"overview","site":"MLM","searchQueries":["audifonos"]}'
```

#### 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, or transform

***

### 📊 Performance & Pricing

#### FREE Tier (Try It Now)

- **20 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 successful products

💰 **Fair, transparent pricing** — a cheap per-product Overview event plus an optional richer Detail event.

🔗 [View current pricing](https://apify.com/sian.agency/mercado-libre-product-scraper?fpr=sian)

***

### ❓ Frequently Asked Questions

**Q: Which countries are supported?**
A: Argentina (MLA), Brazil (MLB), Mexico (MLM) and Chile (MLC).

**Q: How many products can I scrape?**
A: FREE tier: 20 per run. PAID tier: unlimited.

**Q: What's the difference between Overview and Detail mode?**
A: Overview is a fast list scrape (price, condition, lead image). Detail opens each product page for seller, ratings, sold quantity, the full spec table and all photos.

**Q: Can I use my own filtered search?**
A: Yes — filter on MercadoLibre, then paste the resulting URL. Your filters are preserved.

**Q: What output formats are available?**
A: JSON, CSV and Excel — export directly from the Apify dataset.

**Q: Are prices in USD?**
A: Prices are returned in the local currency, plus a normalized USD value using a live FX rate.

**Q: Is this legal?**
A: Yes — only publicly available data is extracted. See the legal section below.

***

### 🐞 Troubleshooting

**No results returned**

- Check the keyword spelling and that the country (site) matches the URL you pasted.
- Broaden your price-range / condition filters.

**Fewer results than expected**

- Increase `maxResults`. FREE runs are capped at 20 products.

**Detail mode returns partial fields**

- Some products simply don't expose every field (e.g. no reviews yet). The row is still returned with whatever is available.

***

### ⚖️ 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:** This is an independent tool and is not affiliated with, endorsed by, or sponsored by MercadoLibre, Inc. or Mercado Livre. "MercadoLibre" and "Mercado Livre" are trademarks of their respective owners. This actor accesses only publicly available data; product names are used for nominative, descriptive 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 the [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

## `scrapeMode` (type: `string`):

🧭 **OVERVIEW** = fast list scrape — price, condition & lead image per product, cheapest per row. **DETAIL** = full product page — seller, ratings, sold quantity, the complete spec table and every photo.

## `site` (type: `string`):

🌎 Which MercadoLibre country marketplace to scrape. Prices are returned in the local currency, with a normalized USD value added for cross-country comparison.

## `searchQueries` (type: `array`):

🔍 **KEYWORD SEARCH:** Keywords to search, one product family per line (e.g. "notebook gamer", "iphone 15"). Leave empty if you paste search or product URLs instead.

💡 **TIP:** Click "Bulk edit" to paste many keywords at once.

## `searchUrls` (type: `array`):

🔗 **URL SEARCH:** Paste full MercadoLibre search/listing URLs — your on-site filters are preserved verbatim. Overrides the keyword + country fields.

💡 **TIP:** Filter on MercadoLibre first, then paste the resulting URL here to carry those exact filters.

## `detailUrls` (type: `array`):

📦 **DIRECT DETAIL:** In Detail mode, paste product page URLs or bare IDs (e.g. `MLA-1234567890`) to scrape those products directly — no search needed.

## `sort` (type: `string`):

↕️ Result ordering for keyword searches.

## `condition` (type: `string`):

✨ Restrict keyword searches to new or used items (optional).

## `priceMin` (type: `integer`):

💰 Lower bound for the price-range filter (in the country's local currency).

## `priceMax` (type: `integer`):

💰 Upper bound for the price-range filter (in the country's local currency).

## `freeShipping` (type: `boolean`):

🚚 Restrict keyword searches to products with free shipping.

## `maxResults` (type: `integer`):

🔢 Maximum number of products to extract. **FREE** runs are capped at 20 products; **PAID** runs are unlimited.

## Actor input object example

```json
{
  "scrapeMode": "overview",
  "site": "MLA",
  "searchQueries": [
    "notebook"
  ],
  "sort": "relevance",
  "freeShipping": false,
  "maxResults": 100
}
```

# Actor output Schema

## `results` (type: `string`):

Scraped MercadoLibre products.

## `htmlReport` (type: `string`):

Human-readable HTML run summary.

# 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 = {
    "searchQueries": [
        "notebook"
    ],
    "maxResults": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("sian.agency/mercado-libre-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 = {
    "searchQueries": ["notebook"],
    "maxResults": 100,
}

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

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "MercadoLibre Product Scraper",
        "description": "Scrape MercadoLibre products across Argentina, Brazil, Mexico & Chile — price, condition, seller, ratings, specs & images. Keyword or URL search, full detail enrichment, dual-currency USD, clean JSON/CSV, no code.",
        "version": "1.0",
        "x-build-id": "hwBbob93pyuHJMXDO"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/sian.agency~mercado-libre-product-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-sian.agency-mercado-libre-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~mercado-libre-product-scraper/runs": {
            "post": {
                "operationId": "runs-sync-sian.agency-mercado-libre-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~mercado-libre-product-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-sian.agency-mercado-libre-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": {
                    "scrapeMode": {
                        "title": "🧭 Scrape mode",
                        "enum": [
                            "overview",
                            "detail"
                        ],
                        "type": "string",
                        "description": "🧭 **OVERVIEW** = fast list scrape — price, condition & lead image per product, cheapest per row. **DETAIL** = full product page — seller, ratings, sold quantity, the complete spec table and every photo.",
                        "default": "overview"
                    },
                    "site": {
                        "title": "🌎 Country",
                        "enum": [
                            "MLA",
                            "MLB",
                            "MLM",
                            "MLC"
                        ],
                        "type": "string",
                        "description": "🌎 Which MercadoLibre country marketplace to scrape. Prices are returned in the local currency, with a normalized USD value added for cross-country comparison.",
                        "default": "MLA"
                    },
                    "searchQueries": {
                        "title": "🔍 Search keywords",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "🔍 **KEYWORD SEARCH:** Keywords to search, one product family per line (e.g. \"notebook gamer\", \"iphone 15\"). Leave empty if you paste search or product URLs instead.\n\n💡 **TIP:** Click \"Bulk edit\" to paste many keywords at once.",
                        "default": [
                            "notebook"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "searchUrls": {
                        "title": "🔗 Search URLs",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "🔗 **URL SEARCH:** Paste full MercadoLibre search/listing URLs — your on-site filters are preserved verbatim. Overrides the keyword + country fields.\n\n💡 **TIP:** Filter on MercadoLibre first, then paste the resulting URL here to carry those exact filters.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "detailUrls": {
                        "title": "📦 Product URLs or IDs (detail mode)",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "📦 **DIRECT DETAIL:** In Detail mode, paste product page URLs or bare IDs (e.g. `MLA-1234567890`) to scrape those products directly — no search needed.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "sort": {
                        "title": "↕️ Sort order",
                        "enum": [
                            "relevance",
                            "price_asc",
                            "price_desc"
                        ],
                        "type": "string",
                        "description": "↕️ Result ordering for keyword searches.",
                        "default": "relevance"
                    },
                    "condition": {
                        "title": "✨ Condition filter",
                        "enum": [
                            "new",
                            "used"
                        ],
                        "type": "string",
                        "description": "✨ Restrict keyword searches to new or used items (optional)."
                    },
                    "priceMin": {
                        "title": "💰 Minimum price",
                        "minimum": 0,
                        "type": "integer",
                        "description": "💰 Lower bound for the price-range filter (in the country's local currency)."
                    },
                    "priceMax": {
                        "title": "💰 Maximum price",
                        "minimum": 0,
                        "type": "integer",
                        "description": "💰 Upper bound for the price-range filter (in the country's local currency)."
                    },
                    "freeShipping": {
                        "title": "🚚 Free shipping only",
                        "type": "boolean",
                        "description": "🚚 Restrict keyword searches to products with free shipping.",
                        "default": false
                    },
                    "maxResults": {
                        "title": "🔢 Max results",
                        "minimum": 1,
                        "type": "integer",
                        "description": "🔢 Maximum number of products to extract. **FREE** runs are capped at 20 products; **PAID** runs are unlimited.",
                        "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```