# Tiendanube / Nuvemshop Product & Store Scraper (`lautarodelgado/tiendanube-scraper`) Actor Scrape Tiendanube (Nuvemshop in Brazil) stores: products, prices, variants, stock, installments, images and categories, plus public store contacts. Incremental mode returns only new or changed products. Spanish and Portuguese keywords work. - **URL**: https://apify.com/lautarodelgado/tiendanube-scraper.md - **Developed by:** [Lautaro Delgado](https://apify.com/lautarodelgado) (community) - **Categories:** E-commerce, Lead generation - **Stats:** 3 total users, 2 monthly users, 81.8% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.50 / 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 ## Tiendanube / Nuvemshop Product & Store Scraper **Tiendanube Scraper** (called **Nuvemshop** in Brazil) turns any Tiendanube / Nuvemshop online store into clean data: every product with its price, compare-at price, installments, variants (SKU, price, stock, size/color), images, categories, tags and availability. Paste the store URLs, get one row per product. It also has a **store profile** mode that returns the store's country, currency and the contact details the store shows publicly (e-mail, phone, WhatsApp, Instagram, Facebook...). It works with `*.mitiendanube.com`, `*.lojavirtualnuvem.com.br` and stores on their own domain, in Argentina, Mexico, Chile, Colombia, Brazil and the rest of Latin America. Built by a developer based in Argentina. Spanish and Portuguese keywords work (see the Spanish section below). > Not affiliated with or endorsed by Tiendanube or Nuvemshop. The Actor only reads pages that any visitor can open in a browser: no login, no private data, no checkout. ### What you can do with it - **Catalog and price monitoring.** Track competitors' prices, discounts and stock. Schedule the Actor and turn on *incremental mode* so each run returns only **new or changed** products (price, compare-at price, stock or availability) and you only pay for those. - **Marketplace and dropshipping research.** Export a whole store, or just one category, with variants and stock to CSV, Excel or JSON. - **Agency prospecting.** Use *store profile* mode on a list of stores to get country, platform, product count, last catalog update, and public contacts and social profiles. - **Feeds and migrations.** Pull a store's catalog (names, descriptions, images, SKUs, variants) into your own system. ### Modes | Mode | Returns | Event charged | |---|---|---| | **Product catalog** (`catalog`) | One row per product | `product` | | **Store profile** (`storeProfile`) | One row per store | `store` | #### How the catalog is discovered For each store the Actor reads the store's own sitemap (the gzipped sitemap that Tiendanube publishes in `robots.txt`, with `/sitemap.xml` as fallback), keeps the product pages and opens them. If a store has no usable sitemap it walks the catalog pages (`/productos/?page=2`...). A category URL reads only that category, a product URL reads only that product. Most recently modified products come first, so a small limit still gives you the freshest items. ### Input | Field | What it does | |---|---| | `mode` | `catalog` (products) or `storeProfile` (one row per store). | | `stores` | Store URLs or domains, e.g. `https://name.mitiendanube.com`, `shop.mybrand.com`, a category URL or a single product URL. | | `maxProductsPerStore` | Products examined per store (default 100). | | `onlyInStock` | Skip products with nothing available. | | `keywords` | Keep only products whose name, brand, category, tags or URL contain one of these words. | | `since` | Date (`2026-10-01`) or period (`7 days`). Products last modified earlier, according to the store sitemap, are not opened at all. | | `incrementalStoreName` | Name of a snapshot. With it, runs return only new or changed products. Use the same name on every run of the same watchlist. | | `includeDescriptionHtml` | Also return the description with its HTML. | | `requestsPerSecond` | Starting speed for all requests together (default 3). See the FAQ on rate limits. | | `maxConcurrency`, `maxConcurrencyPerStore` | Requests in flight at once (defaults 8 and 4). | | `proxyConfiguration` | Optional. Plain requests work; add a proxy only if a store blocks you. | Example input: ```json { "mode": "catalog", "stores": ["https://tallertextildoscoyotes.mitiendanube.com", "peek-store.com"], "maxProductsPerStore": 20, "onlyInStock": true, "incrementalStoreName": "my-watchlist" } ``` ### Output Real product record (Peek Store, a Tiendanube store in Mexico; description shortened): ```json { "url": "https://peek-store.com/productos/tisha-bendiceme", "productId": 321284040, "name": "Tisha Bendíceme", "brand": null, "description": "Icónica canción de Charles Ans ft Juaninacka perteneciente a su disco LADO A. Esta pieza f...", "categories": ["By Charles Ans"], "tags": [], "price": 600, "compareAtPrice": null, "promotionalPrice": null, "onSale": false, "discountPercent": null, "priceMin": 600, "priceMax": 600, "currency": "MXN", "installments": null, "availability": "InStock", "inStock": true, "stockTotal": 1, "stockUnlimited": false, "sku": null, "variantCount": 2, "variants": [ { "id": 1424187492, "sku": null, "price": 600, "compareAtPrice": null, "promotionalPrice": null, "stock": 0, "available": false, "attributes": { "Color": "NEGRA" }, "image": "https://acdn-us.mitiendanube.com/stores/003/780/562/products/11-tisha-bendiceme-negra-3a26b8dc286167dc9d17699004798242-1024-1024.jpg" }, { "id": 1424187508, "sku": null, "price": 600, "compareAtPrice": null, "promotionalPrice": null, "stock": 1, "available": true, "attributes": { "Color": "BLANCA" }, "image": "https://acdn-us.mitiendanube.com/stores/003/780/562/products/10-tisha-bendiceme-blanca-853285ae7d6f34e83517699004830053-1024-1024.jpg" } ], "images": ["https://acdn-us.mitiendanube.com/stores/003/780/562/products/10-11-tisha-bendiceme-978ab1007c165652a417699004860046-1024-1024.jpg"], "image": "https://acdn-us.mitiendanube.com/stores/003/780/562/products/10-11-tisha-bendiceme-978ab1007c165652a417699004860046-1024-1024.jpg", "weightKg": null, "storeName": "Peek Store", "storeDomain": "peek-store.com", "country": "MX", "language": "es", "platform": "tiendanube", "engine": "next", "lastModified": "2026-10-11T19:09:55.000Z", "scrapedAt": "2026-10-14T01:49:26.123Z" } ``` - `price` is the price a customer pays today for the default (first available) variant. `compareAtPrice` is the crossed-out price when there is one; `discountPercent` is computed from both. - `stock` is `null` when the store sells without stock control; `stockUnlimited` tells you so and `stockTotal` is then `null`. - `installments` (stores on the classic storefront) gives the maximum number of installments, the maximum number without interest and the value of that interest-free installment. - In incremental mode every row has `changeType`: `new` or `changed`. - A run also saves an `OUTPUT` record with the status of each input store (`ok`, `not_tiendanube`, `store_not_found`, `blocked`, `invalid_input`). Store profile rows contain: `name`, `domain`, `platform` (`tiendanube` or `nuvemshop`), `country`, `currency`, `language`, `description`, `logo`, `emails`, `phones`, `whatsapp`, `instagram`, `facebook`, `tiktok`, `youtube`, `twitter`, `pinterest`, `linkedin`, `productCount`, `lastProductUpdate` and (newer storefronts) `createdAt`. ### Pricing Pay per event, no extra platform usage: | Event | FREE / Bronze | Silver | Gold | |---|---|---|---| | `product` (one product row) | $0.001 | $0.0008 | $0.0005 | | `store` (one store profile) | $0.005 | $0.004 | $0.003 | That is about **$1 per 1,000 products** on the free/bronze tier and **$0.50 per 1,000** on Gold. In incremental mode, unchanged products cost nothing. Failed pages, deleted products, stores that are not on Tiendanube and blocked stores are never charged. Free Apify plans return at most 10 results per run. Platform cost of a run (the Actor uses plain HTTP, no browser): a test run on the Apify platform with 10 products from 3 stores took 8 seconds and used USD 0.0010 of platform usage at 2 GB, start-up included. At the default speed (about 3 pages per second) that extrapolates to roughly USD 0.05 per 1,000 products. It is an estimate from a small run. ### FAQ **Does it need proxies?** No. Tiendanube / Nuvemshop storefronts answer normal requests and the runs in testing never needed a proxy. The proxy field is there in case a particular store blocks you or you want to go faster than the default speed. **How fast is it, and what are the rate limits?** Tiendanube / Nuvemshop rate-limit each IP address across all stores: in tests from datacenter IPs, about 2 uncached pages per second were always fine and about 4 per second triggered short rate-limit answers (HTTP 429, a few seconds). The Actor therefore starts at 3 requests per second for the whole run, halves its speed and pauses after every 429, and speeds up again while everything works. Expect roughly 150-200 products per minute; stores whose pages are served from the edge cache are often faster. A 5,000-product store takes about half an hour. With a proxy that rotates IPs you can raise `requestsPerSecond`. **Are there two kinds of storefronts?** Yes. Most stores use the classic theme engine; newer stores use a Next.js storefront. The Actor reads both (the `engine` field tells you which one). **Why did a product from the sitemap not show up?** Stores sometimes leave deleted or hidden products in the sitemap and the store answers with a 404 template. Those are skipped and not charged. **Can it find stores by niche or country?** Not yet. The honest state: stores can be listed from public archives (Common Crawl and the Internet Archive index hundreds to thousands of `*.mitiendanube.com` / `*.lojavirtualnuvem.com.br` hosts), but those archives hold no category or country data, many of the hosts are closed stores, and stores on their own domain do not show up. A real "find me stores that sell X in Argentina" needs a homepage fetch per candidate and returns a small, biased sample, so it is on the roadmap rather than half-built. Today you bring the list of stores (from your CRM, ad libraries, a directory) and the *store profile* mode enriches it. **What about reviews, or the customer's cart?** Not collected: only the public catalog data shown to every visitor. ### Limits - Public pages only; prices are shown as the store shows them to a visitor in its default country and currency. - E-mail addresses are only returned when the store shows one publicly (newer storefronts expose the store e-mail; many classic stores show only WhatsApp and social links). - If a store serves a bot-check or HTTP 403 page, the Actor stops for that store and charges nothing (it fails the run if that happens for every store). - Stores can change their markup; the Actor is checked daily against live stores. ### Spanish / Portugués **Scraper de Tiendanube / Nuvemshop**: pegá las URLs o dominios de las tiendas y obtené un registro por producto: precio, precio tachado, cuotas, variantes (SKU, precio, stock, talle/color), imágenes, categorías, etiquetas y disponibilidad. El modo *Perfil de tienda* devuelve país, moneda y los datos de contacto que la tienda muestra públicamente (WhatsApp, e-mail, teléfono, Instagram, Facebook). - Funciona con `*.mitiendanube.com`, `*.lojavirtualnuvem.com.br` y tiendas con dominio propio. - **Modo incremental**: poné un nombre en `incrementalStoreName` y programá el Actor; cada corrida devuelve solo los productos **nuevos o con cambios** de precio o stock, y solo pagás esos. - `keywords` acepta palabras en español o portugués ("zapatillas", "tênis"). - Hecho por un desarrollador de Argentina. No está afiliado a Tiendanube ni Nuvemshop. **Em português:** o Actor lê lojas Nuvemshop (`*.lojavirtualnuvem.com.br` ou domínio próprio) e devolve produtos, preços, parcelas, variações e estoque; no modo incremental só devolve o que é novo ou mudou. ### More Actors by this developer - [Florida Sunbiz Scraper](https://apify.com/lautarodelgado/florida-sunbiz-scraper): Florida business entities, status and annual report checks. # Actor input Schema ## `mode` (type: `string`): Product catalog: one row per product with prices, variants, stock, images and categories. Store profile: one row per store with its country, currency, public e-mail / phone / WhatsApp / social links and product count. ## `stores` (type: `array`): Store URLs or domains: a Tiendanube/Nuvemshop address (name.mitiendanube.com, name.lojavirtualnuvem.com.br) or the store's own domain (shop.example.com). You can also paste a category URL (only that category is read) or a single product URL. ## `maxProductsPerStore` (type: `integer`): Catalog mode only. The Actor looks at this many products per store, most recently changed first. Products that are skipped (out of stock filter, keywords, unchanged in incremental mode) still count toward this limit but are not charged. ## `onlyInStock` (type: `boolean`): Catalog mode only. Skip products with no available variant. ## `keywords` (type: `array`): Catalog mode only. Keep only products whose name, brand, categories, tags or URL contain at least one of these words (Spanish or Portuguese work). Leave empty to keep everything. ## `since` (type: `string`): Catalog mode only. A date (2026-10-01) or a period ("7 days", "12 hours", "2 weeks"). Products whose store sitemap says they were last modified before that are not opened at all, which saves time. Products without a modification date are always checked. ## `incrementalStoreName` (type: `string`): Catalog mode only. Set a name (letters, numbers, dashes) to remember what each store looked like last run. Scheduled runs then return only NEW or CHANGED products (price, compare-at price, stock, availability) and you are not charged for unchanged ones. Use the same name on every run of the same watchlist. ## `includeDescriptionHtml` (type: `boolean`): Catalog mode only. Add the product description with its HTML formatting (the plain-text description is always included). ## `requestsPerSecond` (type: `integer`): Starting speed for all requests together. Tiendanube / Nuvemshop rate-limit each IP address for a few seconds above roughly 4 uncached pages per second, so the default is conservative; the Actor slows down by itself after a rate-limit answer and speeds up again while all goes well. With a proxy you can set a higher value. ## `maxConcurrency` (type: `integer`): Total requests in flight at the same time across all stores (the speed itself is set by Requests per second). ## `maxConcurrencyPerStore` (type: `integer`): Parallel requests to the same store. ## `proxyConfiguration` (type: `object`): Not needed in normal use: Tiendanube / Nuvemshop storefronts answer plain requests. Add a proxy only if a store blocks your runs. ## Actor input object example ```json { "mode": "catalog", "stores": [ "https://tallertextildoscoyotes.mitiendanube.com" ], "maxProductsPerStore": 5, "onlyInStock": false, "includeDescriptionHtml": false, "requestsPerSecond": 3, "maxConcurrency": 8, "maxConcurrencyPerStore": 4 } ``` # Actor output Schema ## `results` (type: `string`): All records as JSON. Append ?format=csv or ?format=xlsx to the URL for other formats. ## `resultsCsv` (type: `string`): The same records as a CSV file. ## `summary` (type: `string`): Status of every input store (ok, not a Tiendanube store, blocked, not found) and request statistics. # 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 = { "mode": "catalog", "stores": [ "https://tallertextildoscoyotes.mitiendanube.com" ], "maxProductsPerStore": 5 }; // Run the Actor and wait for it to finish const run = await client.actor("lautarodelgado/tiendanube-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "catalog", "stores": ["https://tallertextildoscoyotes.mitiendanube.com"], "maxProductsPerStore": 5, } # Run the Actor and wait for it to finish run = client.actor("lautarodelgado/tiendanube-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 '{ "mode": "catalog", "stores": [ "https://tallertextildoscoyotes.mitiendanube.com" ], "maxProductsPerStore": 5 }' | apify call lautarodelgado/tiendanube-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,lautarodelgado/tiendanube-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 ` 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/fiq7WRxAoyDviwTXP/builds/HXjnNCIYYenm0QQGW/openapi.json