# Iherb Product Details Scraper (`soft_alexist/iherb-product-details-scraper`) Actor

Scrape detailed product information from iHerb.com including pricing, ratings, descriptions, SKUs, and images. This scraper delivers 15+ fields per product — perfect for price monitoring, market research, and e-commerce aggregation.

- **URL**: https://apify.com/soft\_alexist/iherb-product-details-scraper.md
- **Developed by:** [Soft Alexist](https://apify.com/soft_alexist) (community)
- **Categories:** Automation, Developer tools, E-commerce
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage

## 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

## iHerb Product Scraper: Extract Supplement & Beauty Data at Scale

***

### What Is iHerb?

iHerb.com is one of the world's largest online retailers of vitamins, supplements, natural health products, and beauty items. With millions of active SKUs across hundreds of brands, iHerb attracts researchers, competitors, and data analysts seeking product intelligence. Manually extracting product details from individual listings is inefficient — the **iHerb Product Scraper** automates this workflow, delivering structured data in minutes.

***

### Overview

The **iHerb Product Scraper** extracts detailed product pages from iHerb.com, capturing comprehensive product information and converting it into clean, machine-readable records. It serves:

- **Price monitoring teams** tracking competitor pricing and promotions
- **Supplement researchers** analyzing product formulations and availability
- **E-commerce aggregators** building product databases
- **Marketing analysts** monitoring product rankings and customer sentiment
- **Retailers** benchmarking against iHerb's catalog

The scraper handles multiple URLs simultaneously, supports proxy rotation for reliable access, and gracefully manages network failures via the `ignore_url_failures` flag.

***

### Input Format

The scraper accepts a JSON configuration specifying product URLs and collection settings:

```json
{
    "urls": [
        "https://www.iherb.com/pr/medicube-collagen-night-wrapping-mask-2-53-fl-oz-75-ml/150472",
        "https://www.iherb.com/pr/advanced-clinicals-collagen-serum-1-75-fl-oz-52-ml/82178",
        "https://www.iherb.com/pr/eucerin-clear-skin-lightweight-sunscreen-lotion-for-face-spf-50-fragrance-free-2-5-fl-oz-75-ml/113261"
    ],
    "max_items_per_url": 200,
    "ignore_url_failures": true
}
```

| Parameter | Description |
|---|---|
| `urls` | Array of direct iHerb product page URLs. Copy from your browser's address bar. |
| `max_items_per_url` | Maximum records per URL (default: 200). Limits output size. |
| `ignore_url_failures` | If `true`, scraper continues if some URLs fail; if `false`, entire run stops on first error. |

> **Best Practice:** Use direct product URLs (ending with a product ID number), not search or category pages.

***

### Output Format

**Output Example:**

```json
{
  "product_id": null,
  "name": "Medicube, Collagen Night Wrapping Mask , 2.53 fl oz (75 ml)",
  "logo": "https://cloudinary.images-iherb.com/image/upload/f_auto,q_auto:eco/images/mcb/mcb11321/g/17.jpg",
  "mpn": "MCB-11321",
  "aggregate_rating": {
    "@type": "AggregateRating",
    "rating_value": 4.6,
    "review_count": 3923
  },
  "brand": {
    "@type": "Brand",
    "name": "Medicube",
    "url": "https://medicube.us/",
    "identifier": "MCB"
  },
  "category": {
    "@type": "Thing",
    "name": "Beauty",
    "identifier": "100483"
  },
  "weight": {
    "@type": "QuantitativeValue",
    "value": "0.23",
    "unit_text": "kg"
  },
  "offers": {
    "@type": "Offer",
    "availability": "https://schema.org/InStock",
    "price": "609764.00",
    "price_currency": "VND",
    "price_specification": [],
    "offer_count": null,
    "availability_starts": null
  },
  "description": "Dedicated To Real Results Night Care Collagen Extract Fills The Skin With Moisture Niacinamide | Ceramide NP Smooth And Firm Skin Overnight Revitalize dull skin and boost skin moisture levels to unveil smooth and firm skin overnight with Collagen Night Wrapping Mask.",
  "size": {
    "@type": "SizeSpecification",
    "name": "2.05x1.6"
  },
  "is_related_to": null,
  "sku": "MCB-11321",
  "gtin12": "8800256113217",
  "image": "https://cloudinary.images-iherb.com/image/upload/f_auto,q_auto:eco/images/mcb/mcb11321/g/17.jpg"
}
```

Each product record contains 15 structured fields capturing essential e-commerce and product data:

#### Product Identification

| Field | Meaning | Example |
|---|---|---|
| `Product ID` | Unique iHerb product identifier | "150472" |
| `SKU` | Stock Keeping Unit for inventory management | "603573502148" |
| `MPN` | Manufacturer Part Number for cross-reference | "MCR-150-2.5" |
| `GTIN-12` | Global Trade Item Number (UPC barcode) | "603573502148" |
| `Name` | Official product title as displayed | "Medicube Collagen Night Wrapping Mask" |

#### Product Classification

| Field | Meaning | Example |
|---|---|---|
| `Brand` | Product manufacturer or brand name | "Medicube" |
| `Category` | Product category on iHerb | "Skincare > Face Masks" |
| `Size` | Package size / volume | "2.53 fl oz (75 ml)" |
| `Weight` | Product weight for shipping calculations | "150 g" |

#### Product Content & Pricing

| Field | Meaning | Example |
|---|---|---|
| `Description` | Full HTML product description including benefits and ingredients | Long HTML text with usage instructions |
| `Offers` | Pricing data including currency, availability, and promotions | `{"price": "$15.99", "availability": "in stock"}` |
| `Aggregate Rating` | Average customer rating (1-5 stars) and review count | "4.7 out of 5 stars (342 reviews)" |

#### Visual & Relational Data

| Field | Meaning | Example |
|---|---|---|
| `Image` | URL of the primary product image for display | "https://cdn.iherb.com/images/product-150472.jpg" |
| `Logo` | Brand logo URL (when available) | "https://cdn.iherb.com/logos/medicube.png" |
| `Is Related To` | Array of related or complementary product IDs | `["150471", "82178", "113261"]` |

***

### How to Use

1. **Gather product URLs** — Browse iHerb.com, find products you want to track, and copy individual product page URLs (the full URL in your browser's address bar).

2. **Prepare your URL list** — Paste URLs into the `urls` array. You can add 1 or 1,000 URLs; the scraper handles bulk collections.

3. **Set collection parameters** — Keep `max_items_per_url` at 200 for full product details. Set `ignore_url_failures: true` if scraping in bulk to avoid interruptions.

4. **Run the scraper** — Start the actor and monitor progress. The run log shows successful and failed URLs.

5. **Export results** — Download output as JSON, CSV, or Excel. Import into spreadsheets, databases, or BI dashboards.

**Troubleshooting:**

- If a URL returns no data, verify the URL is a product detail page (not a category or search page).
- Product URLs typically contain `/pr/` followed by a product name and ID number.
- If getting rate-limited, enable proxy rotation in advanced settings.

***

### Use Cases & Business Value

- **Price intelligence:** Monitor iHerb competitor pricing and promotional calendar
- **Market research:** Analyze supplement trends, brand competition, and customer ratings
- **Content syndication:** Feed iHerb products into your own catalog with structured data
- **Supply chain optimization:** Track product availability and inventory changes over time
- **SEO & content:** Build product comparison pages and buying guides with fresh data

The **iHerb Product Scraper** eliminates hours of manual copy-pasting, delivering clean, normalized data ready for analysis, integration, and business decisions.

***

### Conclusion

Whether monitoring competitors, building product databases, or analyzing the supplement market, the **iHerb Product Scraper** provides fast, reliable access to iHerb's extensive product catalog. With 15 structured output fields covering pricing, ratings, images, and inventory, it turns iHerb listings into actionable business intelligence in minutes.

# Actor input Schema

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

Add the URLs of the Specific product 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.

## Actor input object example

```json
{
  "urls": [
    "https://www.iherb.com/pr/medicube-collagen-night-wrapping-mask-2-53-fl-oz-75-ml/150472",
    "https://www.iherb.com/pr/advanced-clinicals-collagen-serum-1-75-fl-oz-52-ml/82178",
    "https://www.iherb.com/pr/eucerin-clear-skin-lightweight-sunscreen-lotion-for-face-spf-50-fragrance-free-2-5-fl-oz-75-ml/113261",
    "https://www.iherb.com/pr/now-foods-solutions-grapeseed-oil-4-fl-oz-118-ml/59358",
    "https://www.iherb.com/pr/sheamoisture-jamaican-black-castor-oil-strengthen-restore-leave-in-conditioner-11-5-fl-oz-340-ml/102845"
  ],
  "ignore_url_failures": true
}
```

# 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.iherb.com/pr/medicube-collagen-night-wrapping-mask-2-53-fl-oz-75-ml/150472",
        "https://www.iherb.com/pr/advanced-clinicals-collagen-serum-1-75-fl-oz-52-ml/82178",
        "https://www.iherb.com/pr/eucerin-clear-skin-lightweight-sunscreen-lotion-for-face-spf-50-fragrance-free-2-5-fl-oz-75-ml/113261",
        "https://www.iherb.com/pr/now-foods-solutions-grapeseed-oil-4-fl-oz-118-ml/59358",
        "https://www.iherb.com/pr/sheamoisture-jamaican-black-castor-oil-strengthen-restore-leave-in-conditioner-11-5-fl-oz-340-ml/102845"
    ],
    "ignore_url_failures": true
};

// Run the Actor and wait for it to finish
const run = await client.actor("soft_alexist/iherb-product-details-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.iherb.com/pr/medicube-collagen-night-wrapping-mask-2-53-fl-oz-75-ml/150472",
        "https://www.iherb.com/pr/advanced-clinicals-collagen-serum-1-75-fl-oz-52-ml/82178",
        "https://www.iherb.com/pr/eucerin-clear-skin-lightweight-sunscreen-lotion-for-face-spf-50-fragrance-free-2-5-fl-oz-75-ml/113261",
        "https://www.iherb.com/pr/now-foods-solutions-grapeseed-oil-4-fl-oz-118-ml/59358",
        "https://www.iherb.com/pr/sheamoisture-jamaican-black-castor-oil-strengthen-restore-leave-in-conditioner-11-5-fl-oz-340-ml/102845",
    ],
    "ignore_url_failures": True,
}

# Run the Actor and wait for it to finish
run = client.actor("soft_alexist/iherb-product-details-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 '{
  "urls": [
    "https://www.iherb.com/pr/medicube-collagen-night-wrapping-mask-2-53-fl-oz-75-ml/150472",
    "https://www.iherb.com/pr/advanced-clinicals-collagen-serum-1-75-fl-oz-52-ml/82178",
    "https://www.iherb.com/pr/eucerin-clear-skin-lightweight-sunscreen-lotion-for-face-spf-50-fragrance-free-2-5-fl-oz-75-ml/113261",
    "https://www.iherb.com/pr/now-foods-solutions-grapeseed-oil-4-fl-oz-118-ml/59358",
    "https://www.iherb.com/pr/sheamoisture-jamaican-black-castor-oil-strengthen-restore-leave-in-conditioner-11-5-fl-oz-340-ml/102845"
  ],
  "ignore_url_failures": true
}' |
apify call soft_alexist/iherb-product-details-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=soft_alexist/iherb-product-details-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/k1I0k31qeRtY36LMh/builds/jaJCpurc40UKYm18g/openapi.json