# Arredo Argentina Scraper - Precios, Stock y Hogar (`latinamericadata/arredo-argentina`) Actor

Extrae productos de dormitorio, baño y hogar de Arredo Argentina. Obtén precios, stock, SKU, EAN, marcas, ofertas y URLs en Dataset, JSON, CSV, Excel o API.

- **URL**: https://apify.com/latinamericadata/arredo-argentina.md
- **Developed by:** [Latin America Data](https://apify.com/latinamericadata) (community)
- **Categories:** Automation, E-commerce, Integrations
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#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

## Arredo Argentina Scraper - Precios, Stock y Hogar

Extraé ropa de cama, productos de baño, cocina y decoración de Arredo Argentina y obtené precios, stock, SKU, referencias, marcas, ofertas e imágenes. El Actor organiza los resultados en un Dataset listo para descargar como JSON, CSV o Excel, o para integrar mediante API.

Para quienes buscan una Arredo Argentina API o un scraper Arredo, este Actor permite consultar sábanas, acolchados, almohadas, toallas, manteles, cortinas, alfombras, muebles y otros artículos para el hogar. Sirve tanto para una búsqueda puntual como para monitorear precios, descuentos y disponibilidad del catálogo argentino.

### Para qué sirve este Actor

Este Actor automatiza la consulta del catálogo público de Arredo Argentina. Podés buscar productos o colecciones por palabra clave con `searchTerms`, recorrer rutas de categoría con `categories`, controlar el volumen y solicitar detalles comerciales y técnicos.

Cada fila exitosa representa una combinación de SKU y vendedor. La paginación usa un orden determinístico y deduplicación para evitar resultados repetidos. Además, conserva `source_url`, `request_url` y `scraped_at` para que puedas auditar el origen y la fecha de cada dato.

### Casos de uso

- Monitorear precios, stock y descuentos de ropa de cama y artículos para el hogar.
- Comparar precio actual, precio de lista, disponibilidad y promociones.
- Seguir sábanas, acolchados, almohadas, toallas, cortinas, alfombras y decoración.
- Detectar cambios de precio o disponibilidad mediante ejecuciones programadas.
- Alimentar catálogos, tableros, alertas, agentes de IA e inteligencia competitiva.
- Integrar datos de Arredo Argentina mediante API o exportarlos a JSON, CSV y Excel.

### Qué datos entrega

- Identificadores `product_id`, `sku_id` y la referencia disponible en `ean`.
- Nombre del producto y del SKU, marca, categoría y especificaciones.
- `price`, `list_price`, `discount_percent` y `currency`.
- Disponibilidad, cantidad informada, vendedor, promociones y cuotas.
- Descripción, imagen y URL pública del producto cuando están disponibles.
- URL exacta de la consulta y fecha de extracción.
- El Dataset solo incluye filas con estado `success`; `no_results`, `blocked` y `failed` quedan registrados en `RUN_SUMMARY` y en los logs.

Arredo no publica un EAN para todos sus SKU. Cuando falta, `ean` usa la referencia pública del producto como valor alternativo para conservar un identificador auditable.

### Ejemplo de entrada

```json
{
  "searchTerms": ["sabanas"],
  "maxItems": 100,
  "withDetails": true
}
```

### Resultado de ejemplo

```json
{
  "status": "success",
  "country": "AR",
  "source": "Arredo Argentina",
  "input_type": "search",
  "input_value": "sabanas",
  "page": 1,
  "product_id": "14684",
  "sku_id": "6830",
  "ean": "109900204",
  "product_name": "Sábana ajustable de algodón",
  "brand": "Arredo",
  "category": "Ropa de cama/Sábanas",
  "price": 44093,
  "list_price": 62990,
  "currency": "ARS",
  "available": true,
  "source_url": "https://www.arredo.com.ar/sabana-ajustable-algodon/p"
}
```

Los valores son ilustrativos. La estructura refleja los nombres de campo reales del Dataset.

### Inicio rápido

1. Abrí el Actor en Apify Console.
2. Cargá uno o más términos en `searchTerms`, o rutas y URLs en `categories`.
3. Definí `maxItems` o `maxPages` si querés limitar costo y duración.
4. Activá `withDetails` para incluir descripción, especificaciones, promociones y cuotas.
5. Ejecutá el Actor y revisá la pestaña Dataset.

### Input

| Campo | Uso |
| --- | --- |
| `searchTerms` | Productos, colecciones o palabras clave para buscar. |
| `categories` | Rutas o URLs completas de categorías públicas de Arredo. |
| `maxItems` | Máximo opcional de registros guardados entre todos los objetivos. |
| `maxPages` | Máximo opcional de páginas por búsqueda o categoría. |
| `startPage` | Primera página que se solicitará, numerada desde 1. |
| `pageSize` | Productos solicitados por página, hasta 50. |
| `sortOrder` | Orden determinístico aplicado a la paginación. |
| `withDetails` | Incluye descripción, especificaciones, promociones y cuotas. |
| `includeUnavailable` | Incluye SKU y ofertas sin stock. |
| `requestDelayMillis` | Espera entre solicitudes al catálogo. |
| `requestTimeoutSecs` | Tiempo máximo por solicitud. |
| `retries` | Cantidad máxima de intentos ante un error transitorio. |
| `failOnNoResults` | Hace fallar la ejecución si no hay coincidencias. |

`maxItems` y `maxPages` son opcionales. Si no los definís, el Actor continúa hasta agotar el alcance seleccionado. Para recorrer Sábanas, por ejemplo, podés ingresar `/ropa-de-cama/sabanas` o su URL completa.

### Precios

El Actor usa pago por evento con una tarifa plana y predecible:

| Concepto | Importe y aplicación |
|---|---|
| `result` (evento principal) | USD 0.003 por cada producto/SKU guardado en el Dataset predeterminado mediante `apify-default-dataset-item`; equivale a USD 3.00 cada 1.000 resultados. |
| Actor start | Evento sintético de Apify de USD 0.00005 por ejecución. Al estar definido, Apify no cobra el uso de plataforma de los primeros 5 segundos de la ejecución. |

`result` es el evento principal que Apify muestra para comunicar el precio. `withDetails` no cambia la tarifa: una fila con descripción, especificaciones, promociones y cuotas cuesta lo mismo que una fila compacta. Las filas operativas `no_results`, `blocked` y `failed` no se guardan en el Dataset ni se cobran como `result`; el cargo de Actor start sí puede aplicar a la ejecución. El uso restante de la plataforma Apify queda a cargo del usuario.

Si el usuario define un máximo total de cobro para la ejecución, el Actor reduce `maxItems` preventivamente y conserva el menor límite entre ese presupuesto y el valor solicitado.

### API, agentes y exportaciones

Podés ejecutar el Actor desde Apify Console, programaciones, REST API, clientes de JavaScript o Python, MCP y flujos con agentes. El Dataset se puede descargar como JSON, CSV o Excel, o consumir directamente desde la API para automatizar monitoreo de precios, análisis de ofertas y alertas de stock.

Ejemplo con cURL:

```bash
curl "https://api.apify.com/v2/acts/USUARIO~arredo-argentina/runs?token=APIFY_TOKEN" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"searchTerms":["acolchado"],"maxItems":25,"withDetails":true}'
```

### Preguntas frecuentes

#### ¿Necesita usuario o contraseña de Arredo Argentina?

No. El Actor consulta el contrato público del catálogo y no accede a cuentas de clientes ni datos privados.

#### ¿Cómo evita resultados duplicados?

Usa paginación determinística y deduplica cada combinación de SKU y vendedor antes de guardarla y facturarla.

#### ¿Qué pasa si una búsqueda no encuentra productos?

No agrega filas al Dataset. Registra `no_results` en `RUN_SUMMARY` y en los logs, sin cobrar un evento `result`; el evento Actor start sí puede aplicar. Si activás `failOnNoResults`, la ejecución falla en ese escenario.

#### ¿El campo EAN siempre contiene un código de barras?

No. Arredo no informa EAN en todos sus productos. Cuando falta, el Actor conserva la referencia pública del catálogo en ese campo para no perder trazabilidad.

### Fuente, límites y uso responsable

El Actor consulta endpoints públicos del catálogo VTEX de Arredo Argentina. La disponibilidad, el precio, las cuotas y las promociones pueden variar por fecha, ubicación, medio de pago o cambios del comercio. Verificá el producto en `source_url` antes de tomar decisiones comerciales.

Usá límites razonables, una espera respetuosa y ejecuciones programadas acordes con tu necesidad. El Actor no elude autenticación, no realiza compras y no extrae datos personales.

### Independencia

Este Actor es una herramienta independiente. No está afiliado, patrocinado ni respaldado por Arredo Argentina ni por VTEX. Arredo y sus marcas relacionadas pertenecen a sus respectivos titulares.

# Actor input Schema

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

Uno o más productos, marcas o palabras clave para buscar.

## `categories` (type: `array`):

Rutas de categoría o URLs completas del catálogo público de Arredo, opcionales.

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

Cantidad máxima opcional de combinaciones de SKU y vendedor de Arredo que se guardarán entre todos los objetivos.

## `maxPages` (type: `integer`):

Límite opcional de páginas para cada búsqueda o categoría. Si se omite, la paginación continúa hasta agotar los resultados.

## `startPage` (type: `integer`):

Primera página de VTEX que se solicitará, numerada desde 1.

## `pageSize` (type: `integer`):

Cantidad de productos solicitados a VTEX por página. VTEX admite hasta 50.

## `sortOrder` (type: `string`):

Un orden determinístico evita productos duplicados entre páginas por desplazamiento de VTEX.

## `withDetails` (type: `boolean`):

Incluye descripción, especificaciones, promociones, vendedor del marketplace y datos de cuotas. El precio por resultado sigue siendo USD 0.003.

## `includeUnavailable` (type: `boolean`):

Incluye SKU y ofertas de Arredo sin stock cuando está habilitado.

## `requestDelayMillis` (type: `integer`):

Espera respetuosa, en milisegundos, entre solicitudes de páginas a VTEX.

## `requestTimeoutSecs` (type: `integer`):

Cantidad máxima de segundos que se esperará por cada solicitud al catálogo.

## `retries` (type: `integer`):

Cantidad máxima de intentos ante un error transitorio del catálogo.

## `failOnNoResults` (type: `boolean`):

Hace fallar la ejecución cuando no hay coincidencias. En caso contrario, el Dataset queda vacío y el estado `no_results` se guarda en `RUN_SUMMARY`.

## Actor input object example

```json
{
  "searchTerms": [
    "sabanas"
  ],
  "maxItems": 100,
  "startPage": 1,
  "pageSize": 50,
  "sortOrder": "OrderByNameASC",
  "withDetails": true,
  "includeUnavailable": false,
  "requestDelayMillis": 100,
  "requestTimeoutSecs": 45,
  "retries": 3,
  "failOnNoResults": false
}
```

# Actor output Schema

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

No description

## `summary` (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 = {
    "maxItems": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("latinamericadata/arredo-argentina").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": 100 }

# Run the Actor and wait for it to finish
run = client.actor("latinamericadata/arredo-argentina").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 '{
  "maxItems": 100
}' |
apify call latinamericadata/arredo-argentina --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=latinamericadata/arredo-argentina",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/8jVad1vexfSKdeH5Y/builds/vTyJ3BM9TfdKMpKFp/openapi.json