# Arredo Argentina Scraper - Precios, Stock y Hogar (`pmodinger/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/pmodinger/arredo-argentina.md - **Developed by:** [Latin America Data](https://apify.com/pmodinger) (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 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "maxItems": 100 }; // Run the Actor and wait for it to finish const run = await client.actor("pmodinger/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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "maxItems": 100 } # Run the Actor and wait for it to finish run = client.actor("pmodinger/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 pmodinger/arredo-argentina --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=pmodinger/arredo-argentina", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Arredo Argentina Scraper - Precios, Stock y Hogar", "description": "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.", "version": "0.1", "x-build-id": "vTyJ3BM9TfdKMpKFp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/pmodinger~arredo-argentina/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-pmodinger-arredo-argentina", "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/pmodinger~arredo-argentina/runs": { "post": { "operationId": "runs-sync-pmodinger-arredo-argentina", "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/pmodinger~arredo-argentina/run-sync": { "post": { "operationId": "run-sync-pmodinger-arredo-argentina", "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": { "searchTerms": { "title": "Términos de búsqueda", "type": "array", "description": "Uno o más productos, marcas o palabras clave para buscar.", "default": [ "sabanas" ], "items": { "type": "string" } }, "categories": { "title": "Categorías", "type": "array", "description": "Rutas de categoría o URLs completas del catálogo público de Arredo, opcionales.", "items": { "type": "string" } }, "maxItems": { "title": "Máximo de resultados", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Cantidad máxima opcional de combinaciones de SKU y vendedor de Arredo que se guardarán entre todos los objetivos." }, "maxPages": { "title": "Máximo de páginas por objetivo", "minimum": 1, "maximum": 10000, "type": "integer", "description": "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": { "title": "Página inicial", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Primera página de VTEX que se solicitará, numerada desde 1.", "default": 1 }, "pageSize": { "title": "Tamaño de página", "minimum": 1, "maximum": 50, "type": "integer", "description": "Cantidad de productos solicitados a VTEX por página. VTEX admite hasta 50.", "default": 50 }, "sortOrder": { "title": "Orden", "enum": [ "OrderByNameASC", "OrderByNameDESC", "OrderByPriceASC", "OrderByPriceDESC", "OrderByTopSaleDESC", "OrderByBestDiscountDESC", "OrderByReleaseDateDESC" ], "type": "string", "description": "Un orden determinístico evita productos duplicados entre páginas por desplazamiento de VTEX.", "default": "OrderByNameASC" }, "withDetails": { "title": "Incluir detalles del producto", "type": "boolean", "description": "Incluye descripción, especificaciones, promociones, vendedor del marketplace y datos de cuotas. El precio por resultado sigue siendo USD 0.003.", "default": true }, "includeUnavailable": { "title": "Incluir productos sin stock", "type": "boolean", "description": "Incluye SKU y ofertas de Arredo sin stock cuando está habilitado.", "default": false }, "requestDelayMillis": { "title": "Espera entre solicitudes", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Espera respetuosa, en milisegundos, entre solicitudes de páginas a VTEX.", "default": 100 }, "requestTimeoutSecs": { "title": "Tiempo máximo por solicitud", "minimum": 10, "maximum": 180, "type": "integer", "description": "Cantidad máxima de segundos que se esperará por cada solicitud al catálogo.", "default": 45 }, "retries": { "title": "Intentos por solicitud", "minimum": 1, "maximum": 6, "type": "integer", "description": "Cantidad máxima de intentos ante un error transitorio del catálogo.", "default": 3 }, "failOnNoResults": { "title": "Fallar si no hay resultados", "type": "boolean", "description": "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`.", "default": false } } }, "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 } } } } } } } } } } ```