# SoloTodo Chile Price Scraper (`normdata/solotodo-scraper`) Actor

Scrape SoloTodo.cl, Chile's price comparison site: the lowest price in CLP and USD, the cheapest store, every store's offer with coupons and links, and clean specs. Search, pick a category or paste links. Fast, no proxy.

- **URL**: https://apify.com/normdata/solotodo-scraper.md
- **Developed by:** [Norm Data](https://apify.com/normdata) (community)
- **Categories:** E-commerce, Automation
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $16.00 / 1,000 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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

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

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

![Norm Data](https://raw.githubusercontent.com/FabriAV/normdata/refs/heads/main/assets/banner_norm2.png)

## 🛒 SoloTodo Chile Price Scraper

Extract product prices from **SoloTodo.cl**, Chile's biggest price comparison site. For every product you get the lowest price in CLP (and USD), the normal card price, the cheapest store, how many stores sell it and which ones, plus **every store's offer** (Falabella, Paris, Ripley, PC Factory, Lider, Hites, Abcdin, Mercado Libre and 300+ more) with cash price, card price, coupon, condition, SKU and link. Each product also comes with its **clean spec sheet** (processor, RAM, screen, storage and so on). Fast, no browser and no proxy.

### 🎯 Who uses it?

#### 🏪 Chilean retailers and e-commerce teams

See what every competing store charges for the products you sell, including coupons and cash vs. card prices.

#### 🏭 Brands and distributors

Check how your products are priced across Chilean stores and spot sellers going under your recommended price.

#### 📈 Market and pricing analysts

Track price levels for a whole category (notebooks, TVs, phones, appliances) and compare specs against price.

#### 🛍️ Deal hunters and affiliate sites

Find the biggest current discounts and publish them with the cheapest store's link.

### ✨ What it does

- **Search** by one or more product names, **pick a category** (69 of them, from Notebooks to Refrigeradores), or **paste links**: product pages, category pages or searches from solotodo.cl.
- **Every store's offer** for each product, cheapest first: the same list the product page shows.
- **Clean specs** for each product: SoloTodo's full spec sheet, without internal IDs and sort keys.
- **Sorting** just like the site: relevance, lowest price, most popular or biggest discount.
- **Whole categories:** pick a category and leave the search empty to get all of it.

### 🏆 Why this scraper

- **The whole comparison in one row.** Each product carries every Chilean store's offer with cash price, card price and coupon, so you see the full price spread at once.
- **Specs included.** Filter notebooks by RAM or TVs by screen size without a second scraper.
- **Fast.** About 1,000 products with every offer and specs in under 20 seconds.
- **Complete.** SoloTodo's own paging repeats some products and skips others when sorting by relevance; this actor picks up the skipped ones, so a whole category really is the whole category.
- **Clean numbers.** Prices are whole CLP numbers, never text like "$1.189.990".

### ⚖️ How it compares

| Capability | This actor | Other SoloTodo actors |
|---|:--:|:--:|
| Categories | **all 69** | a handful |
| Search by product name | **yes** | no |
| Paste product, category or search links | **yes** | no |
| Sort (price, popular, discount) | **yes** | no |
| Products per run | **no limit** (1,300+ in seconds) | up to 100 |
| Every store's offer per product | **yes** | yes |
| Coupon code and % per store | **yes** | no |
| Clean spec sheet | **yes** | varies |
| Price in USD | **yes** | no |
| Whole category without missed products | **yes** | no |
| Proxy | **none needed** | none needed |

### 📦 What data you get

| Field | Description |
| --- | --- |
| `productId`, `name`, `url` | SoloTodo's product ID, name and product page link. |
| `category`, `brand` | The site's category and the brand. |
| `searchTerm`, `position` | Which of your searches found it, and its place in the results. |
| `price`, `normalPrice`, `currency` | Lowest cash/transfer price right now and the lowest normal (card) price, in CLP. |
| `priceUsd` | The lowest price in US dollars, as SoloTodo converts it. |
| `bestStore`, `storeCount`, `stores` | The cheapest store, how many stores sell it, and their names (cheapest first). |
| `description`, `image`, `listedSince` | Short description, main photo and the date SoloTodo first listed it. |
| `offers` | *(on by default)* Every store's offer: `store`, `storeId`, `title`, `price`, `normalPrice`, `condition`, `couponCode`, `couponPercent`, `sku`, `url`, `updatedAt`. Cheapest first. |
| `highestPrice` | *(with offers)* The priciest offer, so you see the spread at a glance. |
| `specs` | *(on by default)* The spec sheet, e.g. `processor`, `ram_quantity`, `screen`, `storage_drive`, `operating_system`. |
| `scrapedAt` | When the row was collected (UTC). |
| `error` | Only present when a product's store offers didn't load. |

#### Example row (trimmed)

```json
{
  "productId": 191394,
  "name": "Toshiba Canvio Basics 3.0 4 TB [HDTB540XK3CA]",
  "url": "https://www.solotodo.cl/products/191394-toshiba-canvio-basics-30-4-tb-hdtb540xk3ca",
  "category": "Discos duros externos",
  "brand": "Toshiba",
  "price": 168416,
  "normalPrice": 177280,
  "currency": "CLP",
  "priceUsd": 171.55,
  "bestStore": "Winpy",
  "storeCount": 17,
  "stores": ["Winpy", "Alca Plus", "Casa Royal", "PC Factory", "..."],
  "offers": [
    { "store": "Winpy", "price": 168416, "normalPrice": 177280, "condition": "new", "couponCode": null, "sku": "HDTB540XK3CA", "url": "https://www.winpy.cl/venta/disco-duro-externo-toshiba-canvio-basics-de-4tb-usb-3-0-negro/" }
  ],
  "highestPrice": 211600,
  "specs": { "capacity": "4 TB", "connector": "USB 5Gbps", "technology": "HDD (Disco duro)", "format": "2.5\"", "rpm": "5400 rpm" },
  "scrapedAt": "2026-10-03T14:56:03.560Z"
}
```

### 💡 Use cases

#### 💻 Every notebook in Chile with prices and specs

```json
{ "category": "1" }
```

#### 📱 iPhone prices across all Chilean stores

```json
{ "maxItems": 50, "searchTerms": ["iphone 16"] }
```

#### 🔥 Biggest TV discounts right now

```json
{ "maxItems": 100, "category": "11", "sortBy": "discount" }
```

#### ⚡ Prices only, no offers or specs, for a big catalog

```json
{ "searchTerms": ["refrigerador", "lavadora"], "includeOffers": false, "includeSpecs": false }
```

#### 🔎 Track a list of exact products daily

```json
{ "urls": [{ "url": "https://www.solotodo.cl/products/191394-toshiba-canvio-basics-30-4-tb-hdtb540xk3ca" }] }
```

### ⚙️ How the input is organised

| Section | What it's for |
| --- | --- |
| **Maximum products** | Always first, caps the whole run. Empty means no limit. |
| **Search** | Search terms, category, pasted links and sort order. |
| **What to include** | Every store's offer and specs (both on by default). |

### 💰 Pricing

Pay-per-event: a one-time **$0.003** when the run starts, plus a price per product saved to your dataset. The price depends on your Apify plan tier:

| Your Apify plan | Price per product |
| --- | --- |
| Free | $0.022 |
| Bronze | $0.02 |
| Silver | $0.018 |
| Gold / Platinum / Diamond | $0.016 |

Approximate total cost (includes the $0.003 start fee):

| Products collected | Free | Bronze | Silver | Gold+ |
| --- | --- | --- | --- | --- |
| 100 | $2.20 | $2.00 | $1.80 | $1.60 |
| 1,000 | $22.00 | $20.00 | $18.00 | $16.00 |
| 10,000 | $220.00 | $200.00 | $180.00 | $160.00 |

One product row carries every store's offer and the spec sheet, so you pay once per product, not once per store. New Apify accounts start with $5 in free credit. On the Free plan a run saves up to 10 products.

**Speed:** about 1,000 products with every offer and specs in under 20 seconds.

### 🚀 Run it

1. Create a free Apify account with $5 in credit.
2. Open the SoloTodo Chile Price Scraper.
3. Type a product (or keep the prefilled one), pick a category, or paste links, set Maximum products, then click **Start**.
4. Export the results as CSV, Excel, JSON, or XML from the Dataset tab.

Run it programmatically through the Apify API (`run-sync-get-dataset-items`) or the ApifyClient for JavaScript and Python, and schedule it with Apify's built-in Scheduler.

### 🤖 Use with AI agents (MCP)

Give an AI agent live access to Chilean prices through the Model Context Protocol:

```
claude mcp add --transport http apify "https://mcp.apify.com?tools=normdata/solotodo-scraper"
```

Then prompt it in plain language to run the scraper and read back the results.

### 🔧 Troubleshooting

**Search finds nothing.**
Search in Spanish, as Chilean shoppers type it ("notebook", "refrigerador", "audífonos"). Brand and model names always work.

**A search returns accessories along with the product.**
That's SoloTodo's own relevance. Pick a category too (e.g. "notebook" in Notebooks) to keep only that kind of product.

**Some rows have `position` empty.**
SoloTodo's paging repeats some products and skips others. The actor collects the skipped ones in a second pass; they have no position because the site never ranked them.

**A pasted link was skipped.**
Only product pages (`/products/...`), category pages (`/notebooks`, `/televisores`...) and searches (`/search?search=...`) are supported.

**A product has `storeCount` 0.**
No Chilean store has it available right now; `price` then shows the last price SoloTodo listed.

### ❓ FAQ

| Question | Answer |
| --- | --- |
| Do I need a SoloTodo account? | No. Only public price data is read. |
| Does it need a proxy? | No. |
| Are prices live? | Yes, read fresh on every run. Each offer has `updatedAt`, when SoloTodo last checked that store. |
| What's the difference between `price` and `normalPrice`? | `price` is the cash/transfer price SoloTodo headlines; `normalPrice` is the price paying by card. |
| Which stores are included? | The Chilean stores the product page lists, available right now, cheapest first. |
| Does it follow the store link? | No. `url` on each offer is the store's own product page. |
| Can I schedule it? | Yes, with Apify's built-in Scheduler. |

### 🛡️ Limits & responsible use

This Actor reads only public price data from SoloTodo. It never signs in, never buys and never visits store pages. Use the data in line with the site's terms and applicable law.

### 📧 Contact

Need a scraper for a different site, or found something wrong with this one? norm.data.scrapers@gmail.com

### 🧪 Local development

```powershell
bun install
bun run typecheck
bun test/qa.mjs
apify run
```

Local results are stored in `storage/datasets/default`.

# Actor input Schema

## `maxItems` (type: `integer`):

Stop after this many products. Leave empty for no limit (the run stops once the search runs out). The Apify Free plan is always capped at 10.

## `searchTerms` (type: `array`):

Products to look up, as Chilean shoppers type them, e.g. "notebook", "iphone 16", "refrigerador". Each term runs its own search and is tagged on every row.

## `category` (type: `string`):

Limits the search terms to one category. With no search terms, scrapes the whole category.

## `urls` (type: `array`):

Product, category or search links from solotodo.cl. A product link returns that product (handy for tracking a fixed list); a category link scrapes the category (with its search, if any).

## `sortBy` (type: `string`):

Order of the results, same as on the site. Matters when you set a Maximum.

## `includeOffers` (type: `boolean`):

Adds `offers`: each store selling the product with cash price, normal (card) price, coupon, condition, SKU, link and last update, cheapest first, plus `highestPrice`. Cheapest store, store count and store list are always included.

## `includeSpecs` (type: `boolean`):

Adds `specs`: the clean spec sheet (processor, RAM, screen, storage, etc. depending on the category).

## Actor input object example

```json
{
  "maxItems": 10,
  "searchTerms": [
    "notebook"
  ],
  "category": "1",
  "urls": [
    {
      "url": "https://www.solotodo.cl/products/109812-apple-iphone-12"
    },
    {
      "url": "https://www.solotodo.cl/notebooks"
    }
  ],
  "sortBy": "relevance",
  "includeOffers": true,
  "includeSpecs": true
}
```

# Actor output Schema

## `products` (type: `string`):

One row per product.

# 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 = {
    "maxItems": 10,
    "searchTerms": [
        "notebook"
    ],
    "category": "1"
};

// Run the Actor and wait for it to finish
const run = await client.actor("normdata/solotodo-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 = {
    "maxItems": 10,
    "searchTerms": ["notebook"],
    "category": "1",
}

# Run the Actor and wait for it to finish
run = client.actor("normdata/solotodo-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "maxItems": 10,
  "searchTerms": [
    "notebook"
  ],
  "category": "1"
}' |
apify call normdata/solotodo-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,normdata/solotodo-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/8lWsTT4Im6dtmHCAa/builds/CDqLOiZ16mebwtMtO/openapi.json