# Product Review Scraper - Avaliações de Produtos por EAN (`brasildados/product-review-scraper`) Actor Consulte nota e avaliações de produtos brasileiros por EAN (código de barras) em Magalu, Kabum, Pão de Açúcar e outras lojas. | Query product ratings and reviews by EAN barcode from major Brazilian e-commerce stores. - **URL**: https://apify.com/brasildados/product-review-scraper.md - **Developed by:** [BrasilDados.org](https://apify.com/brasildados) (community) - **Categories:** E-commerce, Lead generation, Automation - **Stats:** 1 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $100.00 / 1,000 ean consultados 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 ### Product Review Scraper - Avaliações de Produtos por EAN Consulte **nota e avaliações de produtos brasileiros** por EAN (código de barras) em múltiplas lojas - Magalu, Kabum, Pão de Açúcar, Leroy Merlin e outras. Para cada EAN, receba nota geral ponderada, total de avaliações, tendência temporal (30/90/180/365 dias) e, opcionalmente, os textos das avaliações mais recentes por loja. Disponível em duas formas de uso: - **Execução tradicional** (job): envie sua lista de EANs e baixe o dataset (JSON, CSV, Excel, XML). - **API REST (Standby)**: envie `POST /reviews` com o JSON de entrada e receba os resultados na resposta - pronto para integrar em qualquer pipeline. ### Para quem é - **E-commerce e marketplace**: monitore a reputação dos seus produtos em múltiplas plataformas com uma única chamada. - **Due diligence de fornecedor**: avalie a reputação dos produtos antes de incluir no catálogo. - **Inteligência competitiva**: compare produtos concorrentes pelo EAN. - **Pipelines de NLP e análise de sentimento**: colete reviews reais com `maxReviews > 0`. ### Diferenciais - Cobertura de múltiplas lojas em uma consulta: Magazine Luiza, Kabum, Pão de Açúcar, Leroy Merlin e mais. - Nota geral ponderada pelo volume de cada loja - mais justa do que simples média aritmética. - Tendência temporal pré-calculada (30/90/180/365 dias) pronta para alertas e dashboards. - Deduplicação automática de avaliações repetidas no upstream. - Valores zero nos campos temporais convertidos para `null` - dados limpos sem ruído. ### Input ```json { "eans": ["7891910000197", "7896004004018"], "maxReviews": 5 } ```` | Campo | Tipo | Default | Descrição | |-------|------|---------|-----------| | `eans` | string\[] | obrigatório | Lista de EANs (códigos de barras). Strings numéricas de 8 a 14 dígitos. Máximo 1.000 por execução. | | `maxReviews` | integer | 5 | Quantos textos de avaliações retornar **por loja** no campo `avaliacoes[]`. Cada loja retorna até este número individualmente - não é o total geral. Use `0` para receber apenas dados agregados (nota, totais, tendência) sem textos. Máximo 50. | EANs inválidos (não numéricos ou fora de 8–14 dígitos) retornam `{ "encontrado": false, "erro": "EAN inválido" }` sem custo. ### Output Um registro por EAN no dataset: ```json { "ean": "7891910000197", "encontrado": true, "consultadoEm": "2026-05-28T00:00:00Z", "totalAvaliacoes": 27, "notaGeral": 5.0, "fontes": { "MagazineLuiza": { "totalAvaliacoes": 27, "notaMedia": 5.0, "melhorNota": 5, "piorNota": 5, "primeiraAvaliacaoEm": null, "ultimaAvaliacaoEm": "2023-11-21", "topKeywords": [], "avaliacoes30dias": null, "avaliacoes90dias": null, "avaliacoes180dias": null, "avaliacoes365dias": null, "nota30dias": null, "nota90dias": null, "nota180dias": null, "nota365dias": null, "avaliacoes": [] } } } ``` #### Campos principais | Campo | Descrição | |-------|-----------| | `ean` | EAN consultado. | | `encontrado` | True se o produto foi encontrado com ao menos uma avaliação. | | `totalAvaliacoes` | Soma de avaliações em todas as fontes. | | `notaGeral` | Nota média ponderada pelo volume de avaliações de cada fonte. | | `fontes` | Objeto com dados por loja. Chave = nome da loja (ex: `MagazineLuiza`, `PaoDeAcucar`). | | `fontes.*.avaliacoes` | Textos das avaliações mais recentes, deduplicados (só com `maxReviews > 0`). | Valores zero nos campos temporais são convertidos para `null`. Datas sentinela `0001-01-01` são convertidas para `null`. ### Uso via API REST (Standby) ```bash curl -X POST \ -H "Authorization: Bearer SEU_APIFY_TOKEN" \ -H "Content-Type: application/json" \ -H "Accept-Encoding: gzip" \ --compressed \ -d '{"eans":["7891910000197"],"maxReviews":5}' \ "https://brasildados--product-review-scraper.apify.actor/reviews" ``` A documentação interativa (Swagger UI) fica na aba **Standby** do actor no Apify Console. ### Pricing `$0,10` por EAN consultado. EANs inválidos (formato errado) não são cobrados. | Uso | EANs | Custo | |-----|------|-------| | Triagem de produto | 10 | $1,00 | | Monitoramento semanal | 100 | $10,00 | | Varredura de catálogo | 1.000 | $100,00 | ### Casos de uso - **Monitoramento de marca**: acompanhe nota e volume de avaliações dos seus produtos em múltiplas lojas com uma chamada semanal. - **Due diligence de fornecedor**: avalie a reputação de produtos antes de incluir no catálogo. - **Inteligência competitiva**: compare produtos concorrentes pelo EAN em todas as lojas de uma vez. - **Análise de sentimento**: com `maxReviews > 0`, alimente pipelines de NLP com reviews reais de múltiplas lojas. ### Pipeline / Actors relacionados | Actor | Quando usar no pipeline | |-------|------------------------| | [CNPJ Enrichment & Lead Search](https://apify.com/brasildados/brazil-enrich-data-lead-by-cnpj?fpr=t5lwzq) | Identifique o CNPJ do fabricante ou varejista pelo nome da marca | | [Brazil Sanctions Check](https://apify.com/brasildados/sanctions-check?fpr=t5lwzq) | Verifique se fabricantes ou distribuidores dos produtos têm sanções ativas | | [Government Contracts Check](https://apify.com/brasildados/government-contracts-check?fpr=t5lwzq) | Para produtos vendidos ao governo, consulte o histórico de contratos dos fornecedores | | [DOU Monitor](https://apify.com/brasildados/dou-monitor?fpr=t5lwzq) | Monitore publicações sobre fabricantes e marcas no Diário Oficial | **Exemplo de pipeline de due diligence de produto:** product reviews → enrichment do fabricante → sanctions check. *** ### Perguntas frequentes #### Como consultar a nota de um produto pelo código de barras (EAN)? Envie o EAN no campo `eans`. A API retorna `notaGeral` (média ponderada pelo volume de cada loja) e `totalAvaliacoes`, consolidando todas as lojas que têm o produto. #### Quais lojas a consulta cobre? Magazine Luiza, Kabum, Pão de Açúcar, Leroy Merlin e outras. Cada loja com avaliações aparece como uma chave em `fontes`, com nota, totais e tendência temporal próprios. #### Recebo os textos das avaliações? Sim, quando `maxReviews > 0`. Cada loja retorna até esse número de avaliações recentes (deduplicadas) em `fontes.*.avaliacoes`. Use `maxReviews: 0` para receber só os dados agregados. #### Como a nota geral é calculada? `notaGeral` é a média das notas de cada loja ponderada pelo número de avaliações, mais justa do que uma média aritmética simples entre lojas de volumes diferentes. #### EAN sem avaliações ou inválido é cobrado? EAN inválido (fora de 8-14 dígitos) retorna `encontrado: false` e **não é cobrado**. A cobrança de $0,10 vale por EAN consultado na base. *** ### Product Review Scraper - EAN-Based Reviews (English) Query **ratings and reviews for Brazilian products** by EAN (barcode) across multiple stores - Magalu, Kabum, Pão de Açúcar, Leroy Merlin and others. For each EAN, get a weighted overall score, total review count, time-based trends (30/90/180/365 days) and, optionally, the most recent review texts per store. Available in two modes: - **Traditional run** (job): submit your EAN list, download the dataset (JSON, CSV, Excel, XML). - **REST API (Standby)**: send `POST /reviews` with JSON input and get results in the response - ready for any pipeline. #### Who is it for - **E-commerce and marketplace teams** monitoring product reputation across multiple platforms in one call. - **Supplier due diligence**: assess product reputation before adding to catalog. - **Competitive intelligence**: compare competing products by EAN across all stores at once. - **NLP and sentiment analysis pipelines**: collect real reviews with `maxReviews > 0`. #### Highlights - Multi-store coverage in a single query: Magazine Luiza, Kabum, Pão de Açúcar, Leroy Merlin and more. - Weighted overall score by store volume - fairer than a simple arithmetic average. - Pre-computed time trends (30/90/180/365 days) ready for alerts and dashboards. - Automatic deduplication of repeated reviews from upstream. - Zero temporal values converted to `null` - clean data without noise. #### Input ```json { "eans": ["7891910000197", "7896004004018"], "maxReviews": 5 } ``` | Field | Type | Default | Description | |---|---|---|---| | `eans` | string\[] | required | List of EANs (barcodes), numeric strings 8-14 digits. Max 1,000 per run. | | `maxReviews` | integer | 5 | Review texts returned **per store** in `avaliacoes[]`. Use `0` for aggregates only. Max 50. | Invalid EANs (non-numeric or outside 8-14 digits) return `{ "encontrado": false, "erro": "EAN inválido" }` at no cost. #### Output One record per EAN. `notaGeral` is the volume-weighted average across stores; `fontes` holds per-store breakdown with time trends. ```json { "ean": "7891910000197", "encontrado": true, "consultadoEm": "2026-05-28T00:00:00Z", "totalAvaliacoes": 27, "notaGeral": 5.0, "fontes": { "MagazineLuiza": { "totalAvaliacoes": 27, "notaMedia": 5.0, "ultimaAvaliacaoEm": "2023-11-21", "avaliacoes30dias": null, "nota90dias": null, "avaliacoes": [] } } } ``` Complete field list on the **Dataset schema** tab. #### REST API (Standby) ```bash curl -X POST "https://brasildados--product-review-scraper.apify.actor/reviews" \ -H "Authorization: Bearer YOUR_APIFY_TOKEN" \ -H "Content-Type: application/json" \ --compressed \ -d '{"eans":["7891910000197"],"maxReviews":5}' ``` #### Pricing `$0.10` per EAN queried. Invalid EANs (wrong format) are not billed. | Use | EANs | Cost | |---|---|---| | Product triage | 10 | $1.00 | | Weekly monitoring | 100 | $10.00 | | Catalog scan | 1,000 | $100.00 | #### Related Actors | Actor | When to use | |---|---| | [CNPJ Enrichment](https://apify.com/brasildados/brazil-enrich-data-lead-by-cnpj?fpr=t5lwzq) | Identify the manufacturer or retailer CNPJ by brand name | | [Brazil Sanctions Check](https://apify.com/brasildados/sanctions-check?fpr=t5lwzq) | Check if manufacturers or distributors have active sanctions | | [Government Contracts](https://apify.com/brasildados/government-contracts-check?fpr=t5lwzq) | Procurement history of suppliers selling to the government | | [DOU Monitor](https://apify.com/brasildados/dou-monitor?fpr=t5lwzq) | Monitor official gazette mentions of manufacturers and brands | **Suggested pipeline:** product reviews → manufacturer enrichment → sanctions check. #### FAQ **How do I get a product rating by barcode (EAN)?** Send the EAN in `eans`. You get `notaGeral` (volume-weighted across stores) and `totalAvaliacoes`. **Which stores are covered?** Magazine Luiza, Kabum, Pão de Açúcar, Leroy Merlin and others. Each store with reviews is a key under `fontes`. **Do I get the review texts?** Yes when `maxReviews > 0` (recent, deduplicated, per store). Use `0` for aggregates only. **How is the overall score computed?** Average of each store's score weighted by review volume, fairer than a plain arithmetic mean. **Are invalid or empty EANs charged?** No. Invalid EANs return `encontrado: false` at no cost; the $0.10 charge applies per queried EAN. [Apify Store - brasildados/product-review-scraper](https://apify.com/brasildados/product-review-scraper?fpr=t5lwzq) # Actor input Schema ## `eans` (type: `array`): List of EAN barcodes (8-14 digits). Max 1,000 per run. Invalid EANs return error at no cost. | Lista de EANs (codigos de barras). 8 a 14 digitos. Maximo 1.000 por execucao. EANs invalidos sem cobranca. ## `maxReviews` (type: `integer`): How many review texts to return per store in `avaliacoes[]`. Each store returns up to this limit independently. Use 0 for aggregated scores only (no texts). Max 50. | Quantos textos de avaliacao retornar por loja em `avaliacoes[]`. Cada loja retorna ate este limite. Use 0 para so notas agregadas (sem textos). Maximo 50. ## Actor input object example ```json { "eans": [ "7891910000197", "7896004004018" ], "maxReviews": 5 } ``` # Actor output Schema ## `results` (type: `string`): Dataset com um registro por EAN consultado, contendo nota geral, total de avaliações, tendência temporal e textos de avaliações (quando maxReviews > 0). / Dataset with one record per queried EAN, containing overall rating, review count, time trends and review texts (when maxReviews > 0). # 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 = { "eans": [ "7891910000197", "7896004004018" ], "maxReviews": 5 }; // Run the Actor and wait for it to finish const run = await client.actor("brasildados/product-review-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 = { "eans": [ "7891910000197", "7896004004018", ], "maxReviews": 5, } # Run the Actor and wait for it to finish run = client.actor("brasildados/product-review-scraper").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 '{ "eans": [ "7891910000197", "7896004004018" ], "maxReviews": 5 }' | apify call brasildados/product-review-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=brasildados/product-review-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Product Review Scraper - Avaliações de Produtos por EAN", "description": "Consulte nota e avaliações de produtos brasileiros por EAN (código de barras) em Magalu, Kabum, Pão de Açúcar e outras lojas. | Query product ratings and reviews by EAN barcode from major Brazilian e-commerce stores.", "version": "1.0", "x-build-id": "c3pdbPjbtYCLTHkBb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/brasildados~product-review-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-brasildados-product-review-scraper", "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/brasildados~product-review-scraper/runs": { "post": { "operationId": "runs-sync-brasildados-product-review-scraper", "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/brasildados~product-review-scraper/run-sync": { "post": { "operationId": "run-sync-brasildados-product-review-scraper", "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", "required": [ "eans" ], "properties": { "eans": { "title": "EANs", "minItems": 1, "maxItems": 1000, "type": "array", "description": "List of EAN barcodes (8-14 digits). Max 1,000 per run. Invalid EANs return error at no cost. | Lista de EANs (codigos de barras). 8 a 14 digitos. Maximo 1.000 por execucao. EANs invalidos sem cobranca.", "items": { "type": "string" } }, "maxReviews": { "title": "Review texts per store / Textos de avaliações por loja", "minimum": 0, "maximum": 50, "type": "integer", "description": "How many review texts to return per store in `avaliacoes[]`. Each store returns up to this limit independently. Use 0 for aggregated scores only (no texts). Max 50. | Quantos textos de avaliacao retornar por loja em `avaliacoes[]`. Cada loja retorna ate este limite. Use 0 para so notas agregadas (sem textos). Maximo 50.", "default": 5 } } }, "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 } } } } } } } } } } ```