# Chollometro Scraper: Spain Deals, Coupons & Prices (`getascraper/chollometro-scraper`) Actor

Extract hot, new, and most-voted deals from Chollometro, Spain's Nº1 deal community: prices, discounts, temperature scores, coupons, merchants, and shipping. Scrape any list, category, merchant, or search page, with price, temperature, and date filters.

- **URL**: https://apify.com/getascraper/chollometro-scraper.md
- **Developed by:** [GetAScraper](https://apify.com/getascraper) (community)
- **Categories:** E-commerce, Automation
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: 4.00 out of 5 stars

## Pricing

from $1.32 / 1,000 deal records

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?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## 🔥 Chollometro scraper: ofertas, cupones y precios en España

<table width="100%" style="display:table;width:100%"><tr>
<td style="padding:24px 28px;background:#FFF7ED;border:1px solid #FED7AA;border-top:4px solid #C2410C;border-radius:12px">
<span style="font-size:23px;font-weight:800;color:#1C1917;line-height:1.3">Convierte las ofertas públicas de Chollometro en una lista útil de precios.</span><br>
<span style="font-size:15px;color:#57534E;line-height:1.6">Recopila ofertas, descuentos, comercios, cupones y señales de la comunidad para las páginas que te interesan.</span>
</td>
</tr></table>

<table width="100%" style="display:table;width:100%">
<tbody style="display:table;width:100%;border-collapse:collapse">
<tr>
<td width="25%" style="width:25%;background:#FFF7ED;color:#1C1917;padding:14px"><strong style="color:#1C1917">💶 Deal pricing</strong><br /><span style="color:#57534E">Current, original, and next-best prices</span></td>
<td width="25%" style="width:25%;background:#FFFFFF;color:#1C1917;padding:14px"><strong style="color:#1C1917">🔥 Community signals</strong><br /><span style="color:#57534E">Temperature, hot status, comments, and dates</span></td>
<td width="25%" style="width:25%;background:#FFF7ED;color:#1C1917;padding:14px"><strong style="color:#1C1917">🏪 Merchant context</strong><br /><span style="color:#57534E">Merchant, category, voucher, and shipping fields</span></td>
<td width="25%" style="width:25%;background:#FFFFFF;color:#1C1917;padding:14px"><strong style="color:#1C1917">🔎 Focused lists</strong><br /><span style="color:#57534E">Browse public lists or target selected page links</span></td>
</tr>
</tbody>
</table>

Chollometro publica ofertas que cambian rápido. Este Actor las guarda como filas estructuradas para que puedas comparar precios, comercios y promociones sin revisar página por página.

### 🔍 What does this Actor do?

Chollometro, la plataforma española de ofertas, publishes public deal listings for pricing and promotion research. This Actor saves prices, discounts, merchant details, coupon codes, shipping information, community activity, and direct public links when they are displayed.

Use a built-in list, keyword search, or selected category, merchant, group, tag, or search pages. Filters help you keep the deals that fit your price and popularity criteria.

<table width="100%" style="display:table;width:100%"><tr><td style="padding:12px 18px;background:#FFF7ED;border-left:4px solid #C2410C">
<span style="font-size:15px;color:#1C1917">⚡ <b>Empieza con una lista pública o una URL concreta.</b> Filtra por precio, temperatura o fecha para quitar ruido antes de exportar.</span>
</td></tr></table>

### 💡 Why use it

- **I compare Spanish retail promotions** and need the published price, original price, merchant, and discount in one list.
- **I publish or review deals** and want voucher, shipping, category, and public links beside each offer.
- **I track community attention** and need temperature, comments, hot status, and published dates without manual sorting.

### 🚀 How to use it

<table width="100%" style="display:table;width:100%">
<tbody style="display:table;width:100%;border-collapse:collapse">
<tr>
<td style="background:#FFF7ED;color:#1C1917;padding:14px;width:33%"><span style="font-size:12px;font-weight:800;color:#C2410C;letter-spacing:1px">STEP 1</span><br><strong style="color:#1C1917">Pick a public list</strong><br /><span style="color:#57534E">Choose a built-in Chollometro list or add public page links.</span></td>
<td style="background:#FFFFFF;color:#1C1917;padding:14px;width:33%"><span style="font-size:12px;font-weight:800;color:#C2410C;letter-spacing:1px">STEP 2</span><br><strong style="color:#1C1917">Set your criteria</strong><br /><span style="color:#57534E">Use keyword, price, temperature, and date filters.</span></td>
<td style="background:#FFF7ED;color:#1C1917;padding:14px;width:33%"><span style="font-size:12px;font-weight:800;color:#C2410C;letter-spacing:1px">STEP 3</span><br><strong style="color:#1C1917">Review deal rows</strong><br /><span style="color:#57534E">Use saved prices and links in your research or promotion workflow.</span></td>
</tr>
</tbody>
</table>

### 🎛️ Input

| Field                   | Type          | Required    | Description                                                                                         |
| ----------------------- | ------------- | ----------- | --------------------------------------------------------------------------------------------------- |
| `startUrls`             | array of URLs | No          | Up to 20 public category, merchant, group, tag, or search pages. These take precedence over `mode`. |
| `mode`                  | enum          | No          | Public list to collect: newest, featured, most voted, rising hot, or keyword search.                |
| `keywords`              | text          | Conditional | Search text. Use it with keyword-search mode.                                                       |
| `minTemperature`        | number        | No          | Keep deals at or above this public temperature.                                                     |
| `minPrice` / `maxPrice` | number        | No          | Keep deals within this price range.                                                                 |
| `publishedAfter`        | date          | No          | Keep deals published on or after this date.                                                         |
| `hotAfter`              | date          | No          | Keep deals whose public hot date is on or after this date.                                          |
| `maxItems`              | integer       | No          | Maximum unique deal rows to save.                                                                   |
| `proxyConfiguration`    | object        | No          | Optional connection settings.                                                                       |

### 📋 Data table

| Field                                                          | Type             | Description                                                       |
| -------------------------------------------------------------- | ---------------- | ----------------------------------------------------------------- |
| `rowType`                                                      | text             | Type of saved row.                                                |
| `deal_id`                                                      | text             | Published Chollometro deal identifier.                            |
| `title`                                                        | text             | Published deal title.                                             |
| `price` / `original_price` / `next_best_price`                 | number           | Published current, original, and next-best prices when available. |
| `discount_pct` / `discount_type`                               | number / text    | Published discount percentage and discount label.                 |
| `currency`                                                     | text             | Published currency.                                               |
| `temperature` / `is_hot`                                       | number / boolean | Community temperature and published hot flag.                     |
| `merchant_name` / `merchant_id` / `merchant_url_name`          | text / integer   | Published merchant name, identifier, and domain label.            |
| `voucher_code`                                                 | text             | Published voucher code.                                           |
| `category`                                                     | text             | Published Chollometro category.                                   |
| `shipping_cost` / `free_shipping`                              | number / boolean | Published shipping price and free-shipping flag.                  |
| `image_url`                                                    | URL              | Published deal image link.                                        |
| `view_item_url` / `outbound_url`                               | URL              | Public Chollometro deal link and published retailer link.         |
| `user_name` / `author_id` / `author_username`                  | text / integer   | Published deal-poster fields.                                     |
| `author_title` / `author_persona_text` / `author_persona_type` | text             | Published poster profile labels.                                  |
| `author_profile_hidden`                                        | boolean          | Published profile-visibility flag.                                |
| `comments_count`                                               | integer          | Published community comment count.                                |
| `is_expired`                                                   | boolean          | Whether Chollometro marks the deal expired.                       |
| `published_at` / `updated_at` / `hot_date`                     | datetime         | Published, updated, and hot timestamps when available.            |
| `start_date` / `end_date`                                      | datetime         | Published promotion dates when available.                         |
| `content_hash`                                                 | text             | Collected content fingerprint.                                    |
| `scraped_at`                                                   | datetime         | When the Actor collected the row.                                 |

### 📦 Output example

```json
{
    "deal_id": "1971266",
    "title": "AliExpress/Paypal: Hasta 33€ de Descuento (Desde el 17 de Agosto)",
    "price": 0,
    "temperature": 30.55,
    "merchant_name": "AliExpress",
    "category": "Electrónica",
    "is_expired": false,
    "published_at": "2026-08-10T13:45:02.000Z"
}
```

### 💰 Pricing

This Actor uses pay-per-result pricing. Empty runs cost nothing, and there are no subscriptions.

### ⭐ Enjoying Chollometro scraper?

<table width="100%" style="display:table;width:100%;border-collapse:collapse">
<tbody style="display:table;width:100%;border-collapse:collapse">
<tr><td style="background:#FFF7ED;color:#1C1917;padding:16px"><strong style="color:#1C1917">Was this deal export useful?</strong><br /><span style="color:#57534E">Your review helps other teams find a maintained Chollometro dataset.</span></td></tr>
<tr><td style="background:#C2410C;color:#FFFFFF;padding:12px;text-align:center"><a href="https://apify.com/getascraper/chollometro-scraper/reviews" style="display:block;color:#FFFFFF;text-decoration:none;font-weight:800">★ Rate this Actor on Apify</a></td></tr>
</tbody>
</table>

### ❓ FAQ

#### ¿Puedo recopilar ofertas de Chollometro?

Yes. Add its public page link in `startUrls`.

#### ¿Cómo encuentro solo ofertas recientes?

Set `publishedAfter` to keep deals published from that date onward.

#### ¿La marca de oferta caducada la calcula el Actor?

No. `is_expired` is saved only when Chollometro marks the deal as expired.

#### ¿Por qué falta un cupón o el coste de envío?

Those fields appear only when Chollometro publishes them for the deal.

### 🔗 Other actors

- [💰 Falabella Price Monitor: Alerta de Precios (Chile, Peru, Colombia)](https://apify.com/getascraper/falabella-price-monitor) ↗ - Monitor public Falabella prices and availability.
- [💰 Trendyol Price Monitor: Fiyat Takibi (Türkiye)](https://apify.com/getascraper/trendyol-price-monitor) ↗ - Monitor public Trendyol product prices.
- [💻 Epey Turkey Price Comparison Scraper: Fiyat Karsilastirma](https://apify.com/getascraper/epey-prices-scraper) ↗ - Collect public Epey price-comparison listings.
- [🏷️ Wildberries Price & Rank Tracker | Daily Price Monitoring & Search Rank Positions (2026)](https://apify.com/getascraper/wildberries-price-tracker) ↗ - Track public Wildberries prices and search positions.

# Actor input Schema

## `startUrls` (type: `array`):

Optional: add up to 20 category, merchant, group, tag, or search URLs; these take precedence over the mode below.

## `mode` (type: `string`):

Choose the Chollometro listing to crawl when no specific URLs are supplied.

## `keywords` (type: `string`):

Required only for Search by keyword mode.

## `minTemperature` (type: `number`):

Include deals with this Chollometro temperature or higher.

## `minPrice` (type: `number`):

Include deals priced at or above this amount.

## `maxPrice` (type: `number`):

Include deals priced at or below this amount.

## `publishedAfter` (type: `string`):

Include deals published on or after this calendar date; in the newest feed, crawling stops once older pages are reached.

## `hotAfter` (type: `string`):

Include only deals whose source-reported hot date is on or after this calendar date.

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

Maximum unique deal records to return; a lower limit reduces requests and cost.

## `proxyConfiguration` (type: `object`):

Direct requests are the low-cost default for this public HTML surface. Enable Apify Proxy only when your network requires it.

## Actor input object example

```json
{
  "startUrls": [],
  "mode": "nuevos",
  "keywords": "playstation",
  "minTemperature": 0,
  "minPrice": 0,
  "maxPrice": 100000,
  "publishedAfter": "",
  "hotAfter": "",
  "maxItems": 100,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `dataset` (type: `string`):

No description

# 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 = {
    "startUrls": [],
    "mode": "nuevos",
    "keywords": "playstation",
    "minTemperature": 0,
    "minPrice": 0,
    "maxPrice": 100000,
    "publishedAfter": "",
    "hotAfter": "",
    "maxItems": 100,
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("getascraper/chollometro-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 = {
    "startUrls": [],
    "mode": "nuevos",
    "keywords": "playstation",
    "minTemperature": 0,
    "minPrice": 0,
    "maxPrice": 100000,
    "publishedAfter": "",
    "hotAfter": "",
    "maxItems": 100,
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("getascraper/chollometro-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 '{
  "startUrls": [],
  "mode": "nuevos",
  "keywords": "playstation",
  "minTemperature": 0,
  "minPrice": 0,
  "maxPrice": 100000,
  "publishedAfter": "",
  "hotAfter": "",
  "maxItems": 100,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call getascraper/chollometro-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,getascraper/chollometro-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/sa2Tuy4BocpKoaqQq/builds/BGNNcXMmB9WDzboFz/openapi.json