# Qvc Product Search Scraper (`stealth_mode/qvc-product-search-scraper`) Actor

Scrape QVC product listings with detailed pricing, availability, and assets data. Extract 12+ fields per item including product numbers, descriptions, images, reviews, and shipping info — perfect for price monitoring, competitive analysis, and inventory tracking.

- **URL**: https://apify.com/stealth\_mode/qvc-product-search-scraper.md
- **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community)
- **Categories:** Automation, Developer tools, E-commerce
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 results

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/platform/actors/running/actors-in-store#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

## QVC Product Search Scraper: Collect Beauty & Retail Data Instantly

***

### What Is QVC.com?

QVC.com is a major online retail platform specializing in beauty, electronics, home goods, fashion, and lifestyle products. With thousands of active listings updated regularly, QVC is a valuable source for price intelligence, product trend analysis, and competitive benchmarking. Manual data collection from QVC search results is labor-intensive — the **QVC Product Search Scraper** automates this, delivering structured product data at scale with minimal effort.

***

### Overview

The **QVC Product Search Scraper** extracts comprehensive product information from QVC search and category pages. It transforms paginated product listings into clean, machine-readable records suitable for:

- **Price monitors & aggregators** tracking QVC products against competitors
- **E-commerce researchers** analyzing product trends and assortment strategies
- **Data analysts** building retail intelligence datasets
- **Inventory managers** monitoring stock and availability signals
- **Marketers** studying product positioning and promotional activity

Key strengths include handling pagination automatically, extracting rich product metadata, configurable item limits per URL, and robust error handling via `ignore_url_failures`.

***

### Input Format

The scraper accepts a JSON configuration with three main parameters:

```json
{
  "urls": [
    "https://www.qvc.com/c/beauty/makeup/-/rhuy/c.html?currentPage=2#plModule"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 200
}
```

| Field | Type | Description |
|---|---|---|
| `urls` | Array | Direct links to QVC product search/category pages. Accepts pagination URLs with page numbers and filters. Paste one URL per entry or use bulk edit for multiple URLs. |
| `ignore_url_failures` | Boolean | If `true`, the scraper continues running if some URLs fail or return no results. If `false`, any failure stops the entire run. Default: `true` for reliability. |
| `max_items_per_url` | Integer | Maximum products to extract from each URL (e.g., `200`). Controls volume and cost. Recommended range: 20–500 depending on needs. |

> **Pro tip:** Use category or search URLs with specific filters (e.g., price range, brand) to narrow data collection and reduce costs.

***

### Output Format

**Sample output**

```json
{
  "product_number": "A723607",
  "item_number": "A723607-A723607-000-000",
  "type": "INVENTORY",
  "short_description": "Kevyn Aucoin Contour Book Face Palette Vol IV with Brush",
  "available_to_sell_indicator": "Y",
  "base_image_url": "http://qvc.scene7.com/is/image/QVC/a/07/",
  "primary_class_code": "6325",
  "swatch_indicator": false,
  "max_orderable_quantity": 0,
  "reviews": {
    "count": 1,
    "average_rating": 5.0
  },
  "pricing": {
    "current_minimum_selling_price": 54.0,
    "current_maximum_selling_price": 54.0,
    "qvc_minimum_price": 54.0,
    "qvc_maximum_price": 54.0,
    "product_credit_terms": [
      {
        "code": "C3",
        "number_of_installments": 3,
        "text": "Available for 3 Easy Payments",
        "min_installment_amount": 18.0,
        "max_installment_amount": 18.0
      }
    ],
    "supress_qvc_price_indicator": false
  },
  "shipping_and_handling": {
    "shipping_handling_charge": 3.5,
    "discount_code": "N",
    "two_man_handling": false,
    "default_shipping_method_code": "GR"
  },
  "attributes": {
    "display_image_url": "http://qvc.scene7.com/is/image/QVC/a/07/a723607.001",
    "last_on_air_date": "2026-01-17T01:52:35Z",
    "first_a_t_s_date": "2026-01-17T00:00:00Z",
    "img_color_url": "http://qvc.scene7.com/is/image/QVC/a/07/a723607.001",
    "best_seller": "0",
    "sales_div_code": "QVC",
    "manstop_i_q_v_c": "false",
    "manstop_internet": "false",
    "more_colors_available": "0",
    "more_options_available": "0"
  },
  "assets": [
    {
      "type": "video",
      "url": "http://www.qvc.com/6387855433112"
    }
  ],
  "from_url": "https://www.qvc.com/c/beauty/makeup/-/rhuy/c.html?currentPage=2#plModule"
}
```

Each scraped product returns a rich record with 12+ fields covering identification, pricing, assets, and attributes:

#### Product Identification

| Field | Description |
|---|---|
| `Product Number` | Unique QVC identifier for the product, often alphanumeric (e.g., `Q-12345`) |
| `Item Number` | Internal SKU or item code used in QVC systems for inventory tracking |
| `Type` | Product category classification (e.g., "Beauty", "Electronics", "Home") |

#### Product Content & Description

| Field | Description |
|---|---|
| `Short Description` | Brief product name and key feature summary displayed on search results |
| `Attributes` | Structured product metadata including color, size, brand, material, specifications, and other variant options |

#### Availability & Ordering

| Field | Description |
|---|---|
| `Available To Sell Indicator` | Flag showing whether the product is currently in stock and purchasable (true/false or status code) |
| `Max Orderable Quantity` | Maximum units a customer can order per transaction (e.g., `5`, `10`, or unlimited) |

#### Visual Assets

| Field | Description |
|---|---|
| `Base Image URL` | URL to the primary product image displayed in search results and detail pages |
| `Assets` | Collection of additional product images, video URLs, or multimedia content for the listing |
| `Swatch Indicator` | Flag indicating whether color/pattern swatches are available for visual comparison |

#### Merchant Data

| Field | Description |
|---|---|
| `Primary Class Code` | Internal classification code mapping the product to QVC's taxonomy for reporting and analysis |

#### Customer & Pricing Intelligence

| Field | Description |
|---|---|
| `Reviews` | Aggregated customer review data including rating count, average score, and review links |
| `Pricing` | Current price(s), original price (if on sale), currency, and promotional pricing if applicable |
| `Shipping And Handling` | Shipping costs, estimated delivery time, and handling fees based on product weight and destination |

***

### How to Use

1. **Find category or search URLs** — On QVC.com, navigate to a category (e.g., Beauty > Makeup) or run a search. Copy the URL from your browser, including pagination parameters if needed.

2. **Prepare your input** — Create a JSON configuration with your URLs. Set `max_items_per_url` to balance data volume and cost (e.g., `50–200` for broad searches).

3. **Configure resilience** — Set `ignore_url_failures: true` for bulk runs to prevent failures from stopping the entire job.

4. **Run the scraper** — Start the actor and monitor progress via the log. The scraper will extract all products from each URL up to the item limit.

5. **Export and analyze** — Download results as JSON, CSV, or Excel. Use for price tracking, competitive analysis, or data pipeline ingestion.

**Common use cases:**

- Extract products from a specific category across multiple pages
- Monitor seasonal promotions by scraping the same URLs weekly
- Compare pricing across search filters (e.g., price ranges, brands)

***

### Use Cases & Business Value

- **Price intelligence:** Track QVC product prices and promotional activity over time
- **Competitive benchmarking:** Compare pricing, descriptions, and imagery against your own product catalog
- **Assortment analysis:** Identify trending categories, new product launches, and discontinuations
- **Review monitoring:** Collect and analyze customer feedback at scale
- **Aggregator platforms:** Feed QVC data into comparison shopping engines or data enrichment services

The **QVC Product Search Scraper** eliminates hours of manual browsing, delivering actionable retail intelligence in minutes.

***

### Conclusion

The **QVC Product Search Scraper** is an efficient, cost-effective solution for anyone needing structured e-commerce data. Whether you're tracking competitor pricing, building a retail dataset, or powering a price aggregator, this scraper delivers clean, rich product records ready for analysis and integration.

# Actor input Schema

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

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

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

The maximum number of items to scrape per URL.

## Actor input object example

```json
{
  "urls": [
    "https://www.qvc.com/c/beauty/makeup/-/rhuy/c.html?currentPage=2#plModule"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20
}
```

# 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.qvc.com/c/beauty/makeup/-/rhuy/c.html?currentPage=2#plModule"
    ],
    "ignore_url_failures": true,
    "max_items_per_url": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("stealth_mode/qvc-product-search-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.qvc.com/c/beauty/makeup/-/rhuy/c.html?currentPage=2#plModule"],
    "ignore_url_failures": True,
    "max_items_per_url": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("stealth_mode/qvc-product-search-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.qvc.com/c/beauty/makeup/-/rhuy/c.html?currentPage=2#plModule"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20
}' |
apify call stealth_mode/qvc-product-search-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/lbxPLP2pOfsGuml2G/builds/8i7X7nbP7j9dYs3Wd/openapi.json