# Samsclub Reviews Scraper (`stealth_mode/samsclub-reviews-scraper`) Actor

Harvest customer reviews from Sams Club with advanced filtering capabilities. This scraper extracts author details, ratings, review text, verified purchase badges, sentiment analysis, media attachments, and 40+ metadata fields per review — perfect for market research, competitor analysis.

- **URL**: https://apify.com/stealth\_mode/samsclub-reviews-scraper.md
- **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.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.
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?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Sams Club Reviews Scraper: Extract Product Feedback & Ratings

***

### What Is Sams Club?

Sams Club is a membership-based warehouse retailer operating primarily in the United States, offering bulk groceries, electronics, home goods, and more. With millions of active members, Sams Club hosts extensive product review sections that provide genuine customer feedback. Manually collecting and analyzing these reviews across multiple products is labor-intensive — the **Sams Club Reviews Scraper** automates this, delivering structured review data ready for analysis.

***

### Overview

The **Sams Club Reviews Scraper** extracts comprehensive product reviews and ratings from Sams Club's review pages, transforming unstructured feedback into clean, machine-readable records. It is designed for:

- **Market researchers** tracking consumer sentiment on bulk products
- **Competitor analysts** monitoring product reception and feedback trends
- **Product managers** gathering customer insights for decision-making
- **E-commerce platforms** aggregating review data for comparative analysis
- **Reputation management teams** monitoring brand perception

Key strengths include flexible filtering by rating and verification status, multiple sorting options, configurable pagination, and optional URL-based or product-ID-based scraping modes.

***

### Input Format & Configuration

The scraper supports two primary modes:

#### Mode 1: Scrape by URLs

Direct scraping from review list URLs:

```json
{
  "urls": [
    "https://www.samsclub.com/reviews/product/13630507032?sort=submission-desc&ratings=4&vp=true"
  ],
  "max_items_per_url": 200,
  "ignore_url_failures": true,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "NL"
  }
}
```

#### Mode 2: Scrape by Product ID & Filters

Programmatic scraping with advanced filters:

```json
{
  "product_id": "13630507032",
  "sort_by": "submission-desc",
  "rating": "4",
  "is_verified": true,
  "page": 1,
  "max_items_per_url": 200,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "NL"
  }
}
```

#### Input Parameters

| Parameter | Type | Description |
|---|---|---|
| `urls` | Array | Direct URLs to Sams Club review pages |
| `product_id` | String | Product ID (e.g., `13630507032` from product URL) |
| `sort_by` | String | Relevancy, submission-desc, helpful, rating-desc, rating-asc |
| `rating` | String | Filter by stars: "5", "4", "3", "2", or "1" |
| `is_verified` | Boolean | If `true`, only scrape verified purchase reviews |
| `page` | Integer | Start page number for pagination |
| `max_items_per_url` | Integer | Maximum reviews per URL (e.g., `200`) |
| `ignore_url_failures` | Boolean | If `true`, continue on failed URLs |

> **Tip:** Use `is_verified: true` and `sort_by: "submission-desc"` for the freshest verified customer feedback.

***

### Output Format & Data Fields

**Example output snippet:**

```json
{
  "author_id": "1d29aa8a-f29a-40af-b3d3-2bc739e610f7",
  "badges": [
    {
      "badge_type": "Custom",
      "content_type": "REVIEW",
      "id": "verifiedPurchaser",
      "glass_badge": {
        "id": "VerifiedPurchaser",
        "text": "Verified Purchase"
      }
    }
  ],
  "user_badges": null,
  "condition_group_code": null,
  "condition": null,
  "user_location": null,
  "negative_feedback": 0,
  "positive_feedback": 0,
  "rating": 4,
  "recommended": true,
  "review_id": "434202847",
  "review_reference_id": "234157bf-bc68-5cb0-90e8-c45d673c5e26",
  "original_language": null,
  "original_locale": null,
  "translated_language": null,
  "translated_locale": null,
  "show_translation_cta": null,
  "review_submission_time": "7/28/2026",
  "review_text": "Kids love them",
  "review_title": "Kids love them",
  "review_aspects": [],
  "review_aspect_start": null,
  "review_aspect_end": null,
  "review_sentiment_start": null,
  "review_sentiment_end": null,
  "snippet_from_title": null,
  "show_recommended": true,
  "fulfilled_by": null,
  "status": "APPROVED",
  "seller_name": null,
  "item_id": null,
  "item_image_url": "https://i5.walmartimages.com/asr/f0a676b5-833f-4fae-bbc5-671bba7886fd.476ba423718a4029222e4b00fb461466.jpeg",
  "item_name": "Doritos Nacho Cheese Flavored Tortilla Chips, 18.38 oz.",
  "review_type": null,
  "client_responses": null,
  "syndication_source": null,
  "user_nickname": "Zach",
  "external_source": "bazaarvoice",
  "media": null,
  "photos": [],
  "features": [],
  "from_url": "https://www.samsclub.com/reviews/product/13630507032?sort=submission-desc&ratings=4&vp=true&page=1"
}
```

Each review record contains 40+ fields providing comprehensive review metadata:

#### Core Review Information

| Field | Meaning |
|---|---|
| `Review ID` | Unique identifier for the review in Sams Club system |
| `Review Reference ID` | Alternative internal reference ID |
| `Review Title` | Headline written by the reviewer |
| `Review Text` | Full review body content |
| `Review Type` | Category of review (e.g., product review, Q\&A) |
| `Rating` | Star rating provided (1–5 stars) |
| `Recommended` | Boolean: whether reviewer recommends the product |
| `Show Recommended` | Display flag for recommendation badge |

#### Reviewer Identity & Location

| Field | Meaning |
|---|---|
| `Author ID` | Unique identifier for the reviewer account |
| `User Nickname` | Display name of the reviewer |
| `User Location` | Geographic location of reviewer (when provided) |
| `Badges` | Earned reviewer badges (e.g., Top Reviewer) |
| `User Badges` | All custom badges assigned to user |

#### Purchase & Verification

| Field | Meaning |
|---|---|
| `Condition Group Code` | Product condition at time of review (e.g., new, open box) |
| `Condition` | Detailed condition description |
| `Fulfilled By` | Whether Sams Club or third-party fulfilled the purchase |
| `Status` | Review approval status (pending, approved, rejected) |

#### Feedback & Sentiment

| Field | Meaning |
|---|---|
| `Positive Feedback` | Count of helpful votes received |
| `Negative Feedback` | Count of not helpful votes received |
| `Review Aspects` | Structured aspects reviewed (e.g., "quality", "value") |
| `Review Aspect Start` | Index start for aspect text |
| `Review Aspect End` | Index end for aspect text |
| `Review Sentiment Start` | Index start for sentiment text |
| `Review Sentiment End` | Index end for sentiment text |
| `Snippet From Title` | Excerpt pulled from review title |

#### Languages & Localization

| Field | Meaning |
|---|---|
| `Original Language` | Language in which review was written |
| `Original Locale` | Locale code (e.g., en\_US) of original review |
| `Translated Language` | Language of translation (if applicable) |
| `Translated Locale` | Locale of translated review |
| `Show Translation CTA` | Whether to show "View original review" link |

#### Product & Item Information

| Field | Meaning |
|---|---|
| `Item ID` | Product ID being reviewed |
| `Item Name` | Official product name |
| `Item Image URL` | Product thumbnail or image URL |
| `Seller Name` | Name of the seller (Sams Club or third-party) |

#### Media & Attachments

| Field | Meaning |
|---|---|
| `Media` | Associated media objects (photos, video links) |
| `Photos` | Array of review photos uploaded by reviewer |
| `Features` | Product features highlighted in the review |

#### Additional Metadata

| Field | Meaning |
|---|---|
| `Review Submission Time` | Timestamp when review was posted |
| `Client Responses` | Seller/admin replies to the review |
| `Syndication Source` | Source if review was syndicated from external platform |
| `External Source` | Original platform if imported from elsewhere |
| `Condition Group Code` | Warehouse code for product condition |

***

### How to Use

#### Option A: URL-Based Scraping

1. Navigate to a Sams Club product page and click "Reviews"
2. Apply filters if desired (e.g., 4+ stars, verified purchases)
3. Copy the full URL from your browser
4. Paste into the `urls` array
5. Set `max_items_per_url` to control pagination depth

#### Option B: Product ID Scraping

1. Extract the product ID from the URL (e.g., `13630507032`)
2. Set `product_id` and use filter parameters: `rating`, `is_verified`, `sort_by`, `page`
3. Leave `urls` empty
4. Run the scraper

#### Best Practices

- **For recent feedback:** Use `sort_by: "submission-desc"`
- **For authentic reviews:** Set `is_verified: true`
- **For volume collection:** Use `max_items_per_url: 200` with pagination
- **For reliability:** Enable `ignore_url_failures: true` in bulk runs
- **For compliance:** Use `RESIDENTIAL` proxies matching the US to avoid detection

**Common scenarios:**

- Scrape reviews for a single product → Use Product ID mode with filters
- Compare reviews across multiple products → Use URL mode with multiple URLs
- Monitor review changes over time → Schedule recurring runs with the same configuration

***

### Use Cases & Business Value

- **Sentiment analysis:** Aggregate review text to understand customer perception by product category
- **Quality monitoring:** Track rating trends and identify emerging issues early
- **Competitive intelligence:** Compare your product reviews against competitors on Sams Club
- **Customer insight:** Identify frequently mentioned features, benefits, and complaints
- **SEO & content:** Repurpose authentic customer feedback for marketing materials
- **Pricing strategy:** Understand how customers perceive value at bulk price points

The scraper eliminates weeks of manual review copying, enabling data-driven decisions backed by authentic customer feedback at scale.

***

### Conclusion

The **Sams Club Reviews Scraper** is a powerful tool for anyone needing customer feedback data from one of America's largest membership retailers. With 40+ output fields and flexible filtering options, it provides the depth and scale needed for serious market research, product development, and competitive analysis. Extract genuine customer insights and transform them into actionable business intelligence.

# Actor input Schema

## `urls` (type: `array`):

Add the URLs of the reviews list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

## `ignore_url_failures` (type: `boolean`):

If true, the scraper will continue running even if some URLs fail to be scraped.

## `product_id` (type: `string`):

Enter the product ID of the product you want to scrape.

## `sort_by` (type: `string`):

Sort items by options

## `rating` (type: `string`):

Filter by rating stars

## `is_verified` (type: `boolean`):

If true, only scrape items from verified Purchases.

## `page` (type: `integer`):

Specify the page number to start scraping from

## `max_items_per_url` (type: `integer`):

The maximum number of items to scrape per URL.

## `proxy` (type: `object`):

Select proxies to be used by your scraper.

## Actor input object example

```json
{
  "urls": [
    "https://www.samsclub.com/reviews/product/13630507032?sort=submission-desc&ratings=4&vp=true"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "NL"
  }
}
```

# Actor output Schema

## `results` (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 = {
    "urls": [
        "https://www.samsclub.com/reviews/product/13630507032?sort=submission-desc&ratings=4&vp=true"
    ],
    "ignore_url_failures": true,
    "is_verified": false,
    "max_items_per_url": 20,
    "proxy": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "NL"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("stealth_mode/samsclub-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 = {
    "urls": ["https://www.samsclub.com/reviews/product/13630507032?sort=submission-desc&ratings=4&vp=true"],
    "ignore_url_failures": True,
    "is_verified": False,
    "max_items_per_url": 20,
    "proxy": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "NL",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("stealth_mode/samsclub-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 '{
  "urls": [
    "https://www.samsclub.com/reviews/product/13630507032?sort=submission-desc&ratings=4&vp=true"
  ],
  "ignore_url_failures": true,
  "is_verified": false,
  "max_items_per_url": 20,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "NL"
  }
}' |
apify call stealth_mode/samsclub-reviews-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,stealth_mode/samsclub-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/nq8ooT2imdM6frH8f/builds/j8n5xrjhhcju44NMa/openapi.json