# Bazaarvoice & PowerReviews Reviews + Q\&A Scraper (`trev0n/bazaarvoice-reviews-scraper`) Actor

Reviews, Q\&A and rating summaries from any shop on Bazaarvoice or PowerReviews: Target, Home Depot, Sephora, Costco, Lowe's, Boots, Argos, MediaMarkt, Ulta and thousands more. Paste a product URL; filter by stars, date, language, photos, verified buyers; only-new mode.

- **URL**: https://apify.com/trev0n/bazaarvoice-reviews-scraper.md
- **Developed by:** [Paweł](https://apify.com/trev0n) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.80 / 1,000 review, question or product summaries

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## ⭐ Bazaarvoice & PowerReviews Reviews + Q\&A Scraper

🎯 **Every customer review, question and star rating from Target, Home Depot, Sephora, Costco, Lowe's, Boots, Argos, MediaMarkt, Ulta and thousands of other shops — from one product link.**

Most big retailers and brand sites don't build their own review section: they embed Bazaarvoice or PowerReviews. This scraper reads those review sections directly and gives you **clean, structured reviews** (stars, title, text, date, verified-buyer badge, photos, brand replies), **questions with all their answers**, and a **product rating summary** (average, 1–5 star distribution, recommend %, sub-ratings like Quality or Value). Works across US and European shops, even when the shop's own page refuses robots.

### 🚀 What Does It Do?

This scraper automatically collects **structured, ready-to-use review data** from any shop that uses Bazaarvoice or PowerReviews. No manual browsing, no copy-paste — paste product links and hit Start.

💡 **Three ways to tell it what to scrape:**

1. **🔗 Product URL Mode** — paste product page links from any supported shop. The shop, its review account and the product are recognised automatically.
2. **🎯 Direct Mode** — name the shop's review account (e.g. `targetcom`) and a list of product IDs.
3. **🔍 Catalogue Search** — type a keyword (e.g. `airpods`) and scrape the most-reviewed matching products of a shop.

### 👥 Who Is This For?

| 🏢 Use Case                          | 💬 How It Helps                                                                            |
| ------------------------------------ | ------------------------------------------------------------------------------------------ |
| 🏷️ **Brand & product managers**      | See what buyers say about your products at every retailer, side by side with competitors   |
| 📊 **Market researchers & analysts** | Build review datasets across shops and countries for sentiment, feature and trend analysis |
| 🛎️ **Customer care & quality teams** | Get every new 1–2 star review the day it appears and react before it hurts sales           |
| 🧠 **AI & data science teams**       | Feed thousands of real, star-labelled product opinions into models and dashboards          |
| 🛒 **E-commerce sellers**            | Find the questions shoppers ask before buying and the problems they report after           |
| 🕵️ **Competitive intelligence**      | Track rating distribution and review velocity of rival products over time                  |

### ✨ Features

- 🔗 **Paste any product link** — the review account and product are detected for you, no IDs needed
- 🛡️ **Works when shop pages block bots** — Target, Home Depot, Sephora and others are resolved straight from the link
- 🌍 **US & Europe** — Target, Home Depot, Sephora, Costco, Lowe's, Petco, Sam's Club, Macy's, JCPenney, Samsung US, Boots, Argos, Dunelm, Asda, LOOKFANTASTIC, MediaMarkt (DE, NL, ES, AT), MediaWorld IT, CeraVe, Oral-B, Ulta, BuyDig and thousands more
- ⭐ **Full reviews** — stars, title, text, pros/cons, date, recommend yes/no, helpful votes, photos, videos, brand replies, reviewer profile (skin type, age range…)
- ❓ **Questions & answers** — every question with all its answers, brand answers flagged
- 📊 **Product rating summary** — average rating, 1–5 star distribution, review and question counts, recommend %, sub-ratings, EAN/UPC
- ✅ **Trust signals** — verified purchaser, incentivized reviews, staff reviewers, syndicated reviews and where they came from
- 🎛️ **Smart Filters** — star ratings, date range, review language, photos only, verified buyers only, without syndicated or incentivized reviews
- ↕️ **Sorting** — newest, oldest, highest, lowest or most helpful first
- 🔁 **Only-new monitoring** — the next run outputs only reviews posted since the last one, and can ping Slack, Discord, Telegram or a webhook
- ⚡ **Fast & Scalable** — a product with 20 000 reviews is read in about a minute
- 🧹 **Deduplication** — the same product given twice is scraped once
- 📤 **Export Anywhere** — Download results as JSON, CSV, Excel, or push to Google Sheets, Zapier, Make, or your CRM

### 🎛️ Filters & Options

| Option                                                     | What It Does                                                                           |
| ---------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| 🔗 **Product page URLs**                                   | Product links from any Bazaarvoice or PowerReviews shop                                |
| 🏪 **Bazaarvoice account**                                 | The shop's review account name, for Direct Mode (e.g. `targetcom`, `sephora`, `boots`) |
| 🌐 **Bazaarvoice site locale**                             | Which country site of the account to read (e.g. `en_US`, `en_GB`, `de_DE`)             |
| 🧩 **Bazaarvoice site (zone)**                             | The account's site name — almost always the default                                    |
| 🆔 **Product IDs**                                         | Products to scrape in Direct Mode                                                      |
| 🔍 **Catalogue search**                                    | Keyword to find products within the account                                            |
| 📦 **Max products from search**                            | How many products the search may return                                                |
| 🔑 **Bazaarvoice passkey**                                 | Only for shops on the older review display — the run tells you when                    |
| 🧪 **Passkey environment**                                 | Production or test passkeys                                                            |
| 🛍️ **PowerReviews merchant ID, API key, locale, page IDs** | Direct Mode for PowerReviews shops                                                     |
| ⭐ **Reviews**                                             | Output reviews                                                                         |
| ❓ **Questions & answers**                                 | Output questions with their answers                                                    |
| 📊 **Product rating summary**                              | Output one summary per product                                                         |
| 🔢 **Max reviews / questions per product**                 | How many to collect per product (0 = all)                                              |
| 🧮 **Max records in total**                                | Hard cap on the whole run                                                              |
| ↕️ **Sort reviews by**                                     | Newest, oldest, highest, lowest, most helpful                                          |
| ⭐ **Star ratings**                                        | Only the star ratings you pick, e.g. 1 and 2                                           |
| 📅 **Reviews since**                                       | A date (`2026-01-01`) or a period (`30 days`, `6 months`)                              |
| 🗣️ **Review languages**                                    | Only reviews written in chosen locales (e.g. `en*`, `fr_CA`)                           |
| 📸 **Only reviews with photos**                            | Keep reviews with customer photos or videos                                            |
| ✅ **Only verified purchasers**                            | Keep reviews with a verified-buyer badge                                               |
| 🔄 **Include syndicated reviews**                          | Keep or drop reviews shared from the brand's own site                                  |
| 🎁 **Exclude incentivized reviews**                        | Drop reviews written for a free product or sweepstakes                                 |
| 👤 **Include reviewer nicknames**                          | Add or hide the public nickname and location                                           |
| 🆕 **Only new since last run**                             | Monitoring: output only what was posted since the previous run                         |
| 🗝️ **Monitor name**                                        | Name of the saved monitoring state                                                     |
| 🔔 **Webhook, Slack, Discord, Telegram**                   | Get a digest of new reviews in your channel                                            |
| 📄 **Read product pages**                                  | Open each link to detect the review widget (on by default)                             |
| ⚡ **Parallel products**                                   | How many products are processed at once                                                |
| 🛡️ **Proxy**                                               | Optional — not needed for normal runs                                                  |

### 🧪 Example Inputs

🔗 **Product links from several shops:**

```json
{
    "startUrls": [
        { "url": "https://www.target.com/p/lumify-eye-drops/-/A-54293362" },
        { "url": "https://www.sephora.com/product/bareminerals-original-foundation-broad-spectrum-spf-15-P61003" },
        { "url": "https://www.argos.co.uk/product/5981887" },
        { "url": "https://www.ulta.com/p/lash-sensational-sky-high-mascara-pimprod2020260" }
    ],
    "maxReviewsPerProduct": 200,
    "includeQuestions": true
}
```

👎 **Every 1- and 2-star review of the last 90 days, verified buyers only:**

```json
{
    "startUrls": [{ "url": "https://www.homedepot.com/p/Husky-20-in-Tool-Bag-HD60020/1001862925" }],
    "ratings": ["1", "2"],
    "reviewsSince": "90 days",
    "verifiedPurchasersOnly": true,
    "maxReviewsPerProduct": 0
}
```

🔍 **The 20 most-reviewed "air fryer" products at Target, with Q\&A:**

```json
{
    "bvClient": "targetcom",
    "searchQuery": "air fryer",
    "maxProducts": 20,
    "maxReviewsPerProduct": 100,
    "includeQuestions": true
}
```

🎯 **Direct Mode with product IDs (Sam's Club):**

```json
{
    "bvClient": "samsclub",
    "productIds": ["prod21231904", "prod861280"],
    "sortBy": "mostHelpful",
    "maxReviewsPerProduct": 50
}
```

🔁 **Daily monitor: only new reviews, digest to Slack:**

```json
{
    "startUrls": [
        {
            "url": "https://www.boots.com/webapp/wcs/stores/servlet/ProductDisplay?storeId=11352&catalogId=28501&productId=2371454"
        },
        { "url": "https://www.mediamarkt.de/de/product/_playstation-4-slim-500gb-2174051.html" }
    ],
    "onlyNewSinceLastRun": true,
    "stateKey": "my-products",
    "maxReviewsPerProduct": 0,
    "slackWebhookUrl": "https://hooks.slack.com/services/T000/B000/XXXX"
}
```

📊 **Rating summaries only — a quick scorecard of many products:**

```json
{
    "bvClient": "argos",
    "productIds": ["5981887", "8814322", "3650574"],
    "includeReviews": false,
    "includeProductSummary": true
}
```

### 📦 What You Get (Output Fields)

Every run returns three kinds of records, told apart by `recordType`: `review`, `question` and `product`.

#### Shop & product

| Field       | Example                                                  |
| ----------- | -------------------------------------------------------- |
| recordType  | `review`                                                 |
| platform    | `bazaarvoice`                                            |
| retailer    | `Target`                                                 |
| account     | `targetcom`                                              |
| siteLocale  | `en_US`                                                  |
| productId   | `54293362`                                               |
| productName | `Lumify Eye Drops`                                       |
| brand       | `Lumify`                                                 |
| productUrl  | `https://www.target.com/p/lumify-eye-drops/-/A-54293362` |
| sourceUrl   | `https://www.target.com/p/lumify-eye-drops/-/A-54293362` |

#### Review

| Field            | Example                                                                          |
| ---------------- | -------------------------------------------------------------------------------- |
| reviewId         | `395050946`                                                                      |
| rating           | `5`                                                                              |
| title            | `Brighter eyes in minutes`                                                       |
| text             | `You can never go wrong with Lumify eye drops! It makes your eyes so bright…`    |
| pros / cons      | `Fast, no sting` / `Pricey`                                                      |
| isRecommended    | `true`                                                                           |
| submittedAt      | `2025-08-11T23:54:31.000Z`                                                       |
| authorNickname   | `kashley333`                                                                     |
| authorLocation   | `Denver, CO`                                                                     |
| contentLocale    | `en_US`                                                                          |
| helpfulVotes     | `12`                                                                             |
| secondaryRatings | `{ "Quality": 5, "Value": 4 }`                                                   |
| reviewerProfile  | `{ "skinType": "comboSk", "ageRange": "25to34" }`                                |
| photos           | `["https://photos-us.bazaarvoice.com/photo/2/…"]`                                |
| brandResponses   | `[{ "text": "Thanks for sharing!", "respondedAt": "2025-08-13T10:00:00.000Z" }]` |

#### Trust signals

| Field               | Example                 |
| ------------------- | ----------------------- |
| isVerifiedPurchaser | `true`                  |
| isIncentivized      | `false`                 |
| isStaffReviewer     | `false`                 |
| isSyndicated        | `true`                  |
| syndicationSource   | `boots.com`             |
| badges              | `["verifiedPurchaser"]` |

#### Question & answers

| Field           | Example                                                                         |
| --------------- | ------------------------------------------------------------------------------- |
| questionId      | `10866682`                                                                      |
| questionSummary | `If I wear contacts will it sting my eye?`                                      |
| answerCount     | `1`                                                                             |
| hasBrandAnswer  | `true`                                                                          |
| answers         | `[{ "text": "LUMIFY can be used with contacts, but…", "isBrandAnswer": true }]` |

#### Product rating summary

| Field                    | Example                                                 |
| ------------------------ | ------------------------------------------------------- |
| averageRating            | `4.68`                                                  |
| totalReviews             | `22118`                                                 |
| ratingDistribution       | `{ "1": 67, "2": 95, "3": 715, "4": 5015, "5": 16226 }` |
| recommendedPercent       | `98`                                                    |
| secondaryRatingsAverages | `{ "Value": 4.51, "Quality": 4.78 }`                    |
| totalQuestions           | `32`                                                    |
| eans / upcs              | `["3337875597227"]`                                     |

#### Monitoring

| Field      | Example                    |
| ---------- | -------------------------- |
| changeType | `NEW`                      |
| scrapedAt  | `2026-10-20T20:15:00.000Z` |

### 📊 Example Output

```json
{
    "recordType": "review",
    "platform": "bazaarvoice",
    "retailer": "Sephora US",
    "account": "sephora",
    "siteLocale": "en_US",
    "requestedProductId": "P61003",
    "sourceUrl": "https://www.sephora.com/product/bareminerals-original-foundation-broad-spectrum-spf-15-P61003",
    "reviewId": "403724119",
    "productId": "1922541",
    "productName": "Original Loose Mineral Foundation SPF 15",
    "productUrl": "https://www.sephora.com/product/bareminerals-original-foundation-broad-spectrum-spf-15-P61003",
    "brand": "bareMinerals",
    "productImageUrl": "https://www.sephora.com/productimages/sku/s1922541-main-zoom.jpg",
    "originalProductName": "Original Loose Talc-Free Powder Mineral Foundation SPF 15 Fair Ivory 02",
    "rating": 4,
    "ratingRange": 5,
    "title": "Love it! Especially for indoor days!",
    "text": "I love this product with all my heart! It's so simple compared to the primer/concealer/foundation/setting spray routine…",
    "pros": null,
    "cons": null,
    "isRecommended": true,
    "submittedAt": "2026-09-22T05:03:54.000Z",
    "updatedAt": "2026-09-25T23:32:01.000Z",
    "authorNickname": "kashley333",
    "authorLocation": null,
    "contentLocale": "en_US",
    "isVerifiedPurchaser": true,
    "isIncentivized": false,
    "isStaffReviewer": false,
    "badges": ["verifiedPurchaser"],
    "helpfulVotes": 0,
    "notHelpfulVotes": 0,
    "isSyndicated": false,
    "syndicationSource": null,
    "sourceClient": "sephora",
    "isFeatured": false,
    "secondaryRatings": {},
    "reviewerProfile": { "skinTone": "lightMedium", "skinType": "comboSk", "eyeColor": "brown" },
    "tags": {},
    "photos": ["https://photos-us.bazaarvoice.com/photo/2/cGhvdG86c2VwaG9yYQ/d00d5d2c-9d87-5044-8084-60833b8eaf70"],
    "videos": [],
    "brandResponses": [],
    "comments": [],
    "campaignId": "iOS App",
    "scrapedAt": "2026-10-20T20:15:00.000Z"
}
```

### 📋 Dataset Views

The Apify Console gives you **5 ready-made table views** to quickly browse your results:

| View                       | What It Shows                                                                              |
| -------------------------- | ------------------------------------------------------------------------------------------ |
| 📊 **Overview**            | Type, shop, product, stars, title, text or question, date, author, verified badge          |
| ⭐ **Reviews**             | Stars, title, text, date, author, verified, recommends, helpful votes, syndication, photos |
| ❓ **Questions & answers** | Question, date, author, answer count, brand answered, all answers                          |
| 📈 **Product summaries**   | Average rating, review count, star distribution, recommend %, question count               |
| 📋 **Full Details**        | Every single field — the complete dataset                                                  |

### ❓ FAQ

**🤔 Which shops does it work with?**
Any shop or brand site whose review section is powered by Bazaarvoice or PowerReviews — thousands of sites, including Target, Home Depot, Sephora, Costco, Lowe's, Petco, Sam's Club, Macy's, JCPenney, Samsung US, Boots, Argos, Dunelm, Asda, LOOKFANTASTIC, MediaMarkt, CeraVe, Oral-B, Ulta and BuyDig. Paste a link — if a shop isn't recognised, the run tells you exactly what to add.

**🤔 The shop's page doesn't open for robots — will it still work?**
Yes. For the big shops the product is recognised from the link alone, so a blocked page doesn't matter.

**🤔 Do I get the reviews that were written on the brand's own site?**
Yes — they are included and flagged (`isSyndicated`, `syndicationSource`). Switch them off if you want only reviews written on the shop itself.

**🤔 How does "only new since last run" work?**
The first run collects everything and remembers the newest review of each product. Every later run returns only what was posted since — perfect for a daily schedule with a Slack or Telegram alert.

**🤔 Can I get all reviews of a product with tens of thousands of them?**
Yes — set Max reviews per product to 0. Products with 100 000+ reviews are supported.

**🤔 Can I export the data?**
Yes — JSON, CSV, Excel, XML, HTML, RSS. You can also push data directly to Google Sheets, Zapier, Make, or any webhook/API endpoint.

**🤔 How often should I run this?**
For fresh data, run daily or weekly. You can schedule automatic runs on Apify with just a few clicks.

**🤔 Does it work with proxies?**
It doesn't need one for normal runs. If you ever get blocked, switch on Apify Proxy in the Proxy option.

### 🛠️ Need Custom Filters or Features?

**I'm happy to customize this scraper for your specific needs!** 🤝

Whether you need:

- 🎯 Additional filters (review keywords, product categories, reviewer attributes like skin type or age range, minimum helpful votes)
- 📊 Extra data fields or custom output formats
- 🔄 Integration with your CRM, Google Sheets, or database
- ⏰ Scheduled scraping with automatic deduplication
- 🌐 Scraping from other review platforms (Yotpo, Trustpilot, Feefo, Reevoo…) alongside Bazaarvoice and PowerReviews

👉 **Don't hesitate to reach out via private message** — I respond quickly and I'm always open to building exactly what you need. No request is too small or too specific!

### ⚖️ Legal & Ethical Use

This scraper collects **only publicly available information** that shops display on their product pages. It does not log in, access customer accounts, or collect reviewers' contact details. Please use the data responsibly and in compliance with applicable laws (including GDPR) and the platforms' terms of service.

# Actor input Schema

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

Product pages of any shop or brand site that shows Bazaarvoice or PowerReviews ratings, e.g. Target, Home Depot, Sephora, Costco, Lowe's, Macy's, Sam's Club, JCPenney, Boots, Argos, MediaMarkt, Ulta. The account and product are detected automatically — even when the shop's page itself blocks robots.

## `bvClient` (type: `string`):

The shop's Bazaarvoice account name, e.g. "targetcom", "homedepot", "sephora", "boots", "argos", "mediamarkt". It is the part after /deployments/ in the page source (apps.bazaarvoice.com/deployments/<account>/…). Use it with Product IDs or Catalogue search.

## `bvLocale` (type: `string`):

Locale of the account's site, e.g. en_US (default), en_GB, de_DE, fr_FR, en_CA.

## `bvSite` (type: `string`):

Deployment zone of the account. Almost always "main_site" (default); some brands use another, e.g. "dxp_site".

## `productIds` (type: `array`):

Bazaarvoice product IDs within the account above, e.g. Target "54293362", Sephora "P61003", Sam's Club "prod21231904".

## `searchQuery` (type: `string`):

Find products in the account's review catalogue by keyword (most-reviewed first) and scrape them, e.g. "airpods" in targetcom. Combine with Max products.

## `maxProducts` (type: `integer`):

How many products the catalogue search may return.

## `bvPasskey` (type: `string`):

Only for shops on the older Bazaarvoice display (the run tells you when it is needed). It is the public key in the page source after "passkey=". With a passkey, Product IDs work without an account name.

## `bvEnvironment` (type: `string`):

Production for real shops. Staging only for Bazaarvoice test passkeys.

## `prMerchantId` (type: `string`):

For PowerReviews shops without a product URL: the merchant ID from the page source ("merchant_id" / "prMerchantId"), e.g. 6406 for Ulta.

## `prApiKey` (type: `string`):

The public read key from the page source ("api_key" / "prApiKey", a UUID).

## `prLocale` (type: `string`):

Locale of the PowerReviews site, e.g. en_US (default), en_CA, en_GB.

## `prPageIds` (type: `array`):

Product page IDs within the merchant, e.g. "pimprod2020260" (Ulta).

## `includeReviews` (type: `boolean`):

Output one record per review.

## `includeQuestions` (type: `boolean`):

Output one record per customer question, with all its answers (brand answers flagged).

## `includeProductSummary` (type: `boolean`):

Output one summary record per product: average rating, star distribution, review / question counts, recommend %, sub-ratings, EAN/UPC.

## `maxReviewsPerProduct` (type: `integer`):

Stop after this many reviews per product. 0 = all of them.

## `maxQuestionsPerProduct` (type: `integer`):

Stop after this many questions per product. 0 = all of them.

## `maxResults` (type: `integer`):

Hard cap on all records of the run (reviews + questions + summaries). 0 = no cap.

## `sortBy` (type: `string`):

Order in which reviews are collected — matters when you cap the number per product.

## `ratings` (type: `array`):

Only reviews with these star ratings, e.g. 1 and 2 for complaints. Empty = all.

## `reviewsSince` (type: `string`):

Only reviews and questions submitted on or after this date (YYYY-MM-DD), or a relative period such as "30 days", "6 months".

## `contentLocales` (type: `array`):

Only reviews written in these locales, e.g. en_US, fr_CA, or en\* for every English variant. Empty = all.

## `withPhotosOnly` (type: `boolean`):

Keep only reviews that include customer photos or videos.

## `verifiedPurchasersOnly` (type: `boolean`):

Keep only reviews carrying the shop's verified-purchaser / verified-buyer badge.

## `includeSyndicated` (type: `boolean`):

Many reviews are written on the brand's own site and shared to the shop. Keep them (default), or turn off to get only reviews written on this shop.

## `excludeIncentivized` (type: `boolean`):

Drop reviews marked as written in exchange for a free product or sweepstakes entry.

## `includeAuthorNames` (type: `boolean`):

Add the public nickname and location shown next to each review, question and answer.

## `onlyNewSinceLastRun` (type: `boolean`):

Monitoring mode: remembers the newest review and question of every product and, on the next run, outputs only what was posted since (one request per unchanged product). The first run outputs everything as the baseline.

## `stateKey` (type: `string`):

Name of the saved state. Leave empty to derive it from the products and filters; set it to share one baseline across runs whose input changes slightly.

## `webhookUrl` (type: `string`):

In monitoring mode, POST the new reviews and questions as JSON to this URL.

## `slackWebhookUrl` (type: `string`):

In monitoring mode, post a short digest of new reviews to Slack.

## `discordWebhookUrl` (type: `string`):

In monitoring mode, post a short digest of new reviews to Discord.

## `telegramBotToken` (type: `string`):

In monitoring mode, send the digest through this Telegram bot (with the chat ID below).

## `telegramChatId` (type: `string`):

Chat that receives the Telegram digest.

## `readProductPages` (type: `boolean`):

Open each product URL to detect the review widget. Turn off to resolve from the link alone (faster; works for the built-in shops).

## `maxConcurrency` (type: `integer`):

How many products are processed at the same time.

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

Not needed: the review sources answer directly. Turn on only if your runs get blocked.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.target.com/p/lumify-eye-drops/-/A-54293362"
    }
  ],
  "maxProducts": 10,
  "bvEnvironment": "production",
  "includeReviews": true,
  "includeQuestions": false,
  "includeProductSummary": true,
  "maxReviewsPerProduct": 100,
  "maxQuestionsPerProduct": 50,
  "maxResults": 0,
  "sortBy": "newest",
  "withPhotosOnly": false,
  "verifiedPurchasersOnly": false,
  "includeSyndicated": true,
  "excludeIncentivized": false,
  "includeAuthorNames": true,
  "onlyNewSinceLastRun": false,
  "readProductPages": true,
  "maxConcurrency": 5,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `reviews` (type: `string`):

No description

## `questions` (type: `string`):

No description

## `products` (type: `string`):

No description

## `runSummary` (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": [
        {
            "url": "https://www.target.com/p/lumify-eye-drops/-/A-54293362"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("trev0n/bazaarvoice-reviews-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": [{ "url": "https://www.target.com/p/lumify-eye-drops/-/A-54293362" }] }

# Run the Actor and wait for it to finish
run = client.actor("trev0n/bazaarvoice-reviews-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": [
    {
      "url": "https://www.target.com/p/lumify-eye-drops/-/A-54293362"
    }
  ]
}' |
apify call trev0n/bazaarvoice-reviews-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,trev0n/bazaarvoice-reviews-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/MrEgYouA8KXvOtgfI/builds/N8IEHscavbc5pure0/openapi.json