# Vicks Url Scrapers (`getdataforme/vicks-url-scrapers`) Actor
Extract comprehensive Vicks product data effortlessly with Vicks URL Scrapers. Features fast CheerioCrawler-based scraping, structured JSON output, and flexible URL inputs. Ideal for market research, competitive analysis, and e-commerce automation. Start scraping today!
- **URL**: https://apify.com/getdataforme/vicks-url-scrapers.md
- **Developed by:** [GetDataForMe](https://apify.com/getdataforme) (community)
- **Categories:** AI, Agents, E-commerce
- **Stats:** 4 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $9.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.
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
## Vicks Url Scrapers
Vicks Url Scrapers is an Apify Actor designed to extract detailed product information from Vicks website URLs. It efficiently scrapes product pages to gather comprehensive data including titles, descriptions, images, variants, and related products, making it ideal for market research, e-commerce analysis, and data aggregation. This tool ensures reliable, structured data extraction with minimal setup, empowering users to collect insights from Vicks' product catalog seamlessly.
### Features
- **Comprehensive Data Extraction**: Retrieves full product details such as family name, title, GTIN, descriptions, hero images, variants, related products, and metadata.
- **Flexible URL Input**: Supports multiple start URLs, allowing targeted scraping of specific product pages or categories.
- **High Performance**: Built on CheerioCrawler for fast, efficient crawling with configurable request limits to manage load.
- **Structured JSON Output**: Delivers clean, parseable data in JSON format, perfect for integration with databases or analytics tools.
- **Error-Resilient**: Handles common web scraping challenges like dynamic content and provides logging for troubleshooting.
- **Scalable and Customizable**: Easily adjustable parameters for different crawl depths and request volumes.
- **Apify Integration**: Seamlessly runs on the Apify platform with built-in monitoring and export options.
### Input Parameters
| Parameter | Type | Required | Description | Example |
|-----------|------|----------|-------------|---------|
| startUrls | array | Yes | An array of URLs to start the crawl from. Each URL should point to a Vicks product page. | `[{"url": "https://vicks.com/en-us/shop-products/childrens-products/vicks-childrens-vapopatch-soothing-non-medicated-patch-for-kids-with-vicks"}]` |
| maxRequestsPerCrawl | integer | No | The maximum number of requests the crawler can make during a single run. Helps control resource usage. | `10` |
### Example Usage
To run the Actor, provide the input parameters in JSON format. Here's an example input:
```json
{
"startUrls": [
{
"url": "https://vicks.com/en-us/shop-products/childrens-products/vicks-childrens-vapopatch-soothing-non-medicated-patch-for-kids-with-vicks"
}
],
"maxRequestsPerCrawl": 10
}
````
The output will be a JSON array of product objects. Example output:
```json
[
{
"familyName": "CHILDREN'S",
"title": "Children's VapoPatch\u2122, Non-Medicated Soothing Vicks\u00ae Vapors Aroma Patch",
"productShortName": "Children's VapoPatch\u2122, Non-Medicated Soothing Vicks\u00ae Vapors Aroma Patch",
"url": "/en-us/shop-products/childrens-products/vicks-childrens-vapopatch-soothing-non-medicated-patch-for-kids-with-vicks",
"gtin": "00323900040588",
"shortDescription": "Vicks Children's VapoPatch wearable aroma patches provide soothing, non-medicated Vicks vapors in an easy-to-use patch. Instead of dealing with messy ointments or creams, these wearable aroma patches can be worn directly on your child's clothes. Experience the Vicks vapor scent you know and love with no greasy or messy creams or ointments. Soothe your child's senses with Vicks Children's VapoPatch. Each wearable patch contains a blend of eucalyptus and essential oilts + the scents of menthol and camphor. Simply peel, apply to the outside of your child's shirt or other article of clothing, and experience the soothing, non-medicated vapors. Each VapoPatch is long-lasting and can be worn up to 8 hours. Children's VapoPatch can be worn during the day or overnight while sleeping. Children's VapoPatch can be used by children ages 6 and older. Use only one patch at a time. Do not apply to skin.\n\nChildren's VapoPatch wearable aroma patches are non-medicated and not intended to treat cold or flu symptoms.",
"description": "Vicks Children's VapoPatch wearable aroma patches provide soothing, non-medicated Vicks vapors in an easy-to-use patch. Instead of dealing with messy ointments or creams, these wearable aroma patches can be worn directly on your child's clothes. Experience the Vicks vapor scent you know and love with no greasy or messy creams or ointments. Soothe your child's senses with Vicks Children's VapoPatch. Each wearable patch contains a blend of eucalyptus and essential oilts + the scents of menthol and camphor. Simply peel, apply to the outside of your child's shirt or other article of clothing, and experience the soothing, non-medicated vapors. Each VapoPatch is long-lasting and can be worn up to 8 hours. Children's VapoPatch can be worn during the day or overnight while sleeping. Children's VapoPatch can be used by children ages 6 and older. Use only one patch at a time. Do not apply to skin.\n
\nChildren's VapoPatch wearable aroma patches are non-medicated and not intended to treat cold or flu symptoms.",
"heroImage": {
"title": "Vicks Children's VapoPatch box featuring soothing vapors, with illustration of sleeping child and moon on blue packaging.",
"url": "https://images.ctfassets.net/xuuihvmvy6c9/3C2OmCjCW1CWa5SVRartAE/fa42b9c5edbe3b02bb782cab57dc03fc/840X840________33.png"
},
"variants": [
{
"name": "Vicks\u00ae Children's VapoPatch Soothing Non-Medicated Patch 5 count",
"variantName": "5 CT",
"gtin": "00323900040588",
"psId": "323900040588",
"slId": "00323900040588",
"heroImage": {
"title": "Vicks Children's VapoPatch box featuring soothing vapors, with illustration of sleeping child and moon on blue packaging.",
"url": "https://images.ctfassets.net/xuuihvmvy6c9/3C2OmCjCW1CWa5SVRartAE/fa42b9c5edbe3b02bb782cab57dc03fc/840X840________33.png"
},
"images": [
{
"type": "Image",
"url": "https://images.ctfassets.net/xuuihvmvy6c9/3C2OmCjCW1CWa5SVRartAE/fa42b9c5edbe3b02bb782cab57dc03fc/840X840________33.png",
"altText": "Vicks Children's VapoPatch box featuring soothing vapors, with illustration of sleeping child and moon on blue packaging."
},
{
"type": "Image",
"url": "https://images.ctfassets.net/xuuihvmvy6c9/pTKHHHzWweWPdjhcZloNg/707bbf38d3821db0776683150b15b354/840X840________32.png",
"altText": "Vicks Children's VapoPatch box with soothing vapors, featuring cartoon of sleeping child and containing 5 wearable aroma patches."
},
{
"type": "Image",
"url": "https://images.ctfassets.net/xuuihvmvy6c9/5gXrodzQ5ZyhYKZpcF2ECy/fb04d0f8afaa539dbcd4fe2b9a72a776/840X840________31.png",
"altText": "Vicks Children's VapoPatch box featuring soothing vapors, with illustration of sleeping child and moon on blue packaging left view."
},
{
"type": "Image",
"url": "https://images.ctfassets.net/xuuihvmvy6c9/1vgVszuCk2VDe3NYgxNFJV/49b1d06af4837afe49ede0a78aa90196/840X840________34.png",
"altText": "Vicks Children's VapoPatch box with soothing vapors, featuring cartoon of sleeping child and moon on blue packaging."
},
{
"type": "Image",
"url": "https://images.ctfassets.net/xuuihvmvy6c9/20kIha9bfwUX9XCp0hSWmF/a316c470e3a1f8ae707c9e5b295afb01/840X840________35.png",
"altText": "Vicks VapoPatch children's product packaging showing directions, ingredients, and safety information on blue background."
}
]
}
],
"relatedProducts": [
{
"id": "4OdTFuFxy1ba8QauQst7vG",
"title": "Vicks\u00ae DayQuil & NyQuil Kids Honey Combo",
"shortDescription": "Vicks\u00ae DayQuil & NyQuil Kids Honey Combo relieves your child's cough, cold and congestion symptoms. It is specially designed for children with a great tasting, honey-licious flavor. Intended for children ages 6+. The Vicks\u00ae DayQuil & NyQuil Kids Honey combo-pack offers coverage for day and night relief. For nighttime relief, Vicks\u00ae NyQuil Kids Honey will help you treat your child's symptoms so that they can get the rest they need. During the day, keep Vicks\u00ae DayQuil Kids Honey handy to help with coughs and congestion. Next time a cold is bothering your child, try Vicks\u00ae DayQuil & NyQuil Kids Honey.",
"url": "/en-us/shop-products/childrens-products/vicks-r-dayquil-and-nyquil-kids-honey-combo",
"heroImage": {
"title": "Vicks DayQuil and NyQuil Kids honey-flavored cold medicine combo pack with day and night formulas for children 6+.",
"url": "https://images.ctfassets.net/xuuihvmvy6c9/4Wiv4gtGTuh9UflfQRthbA/c7f4a657a966aedc1de11a6e23e32498/00323900044906_C1N1_90384856_downloadPNG.png"
},
"facets": [
"Children's",
"Cough",
"Liquids",
"Child (6\u201311 years)",
"Alcohol free",
"DayQuil and NyQuil Co Packs\u2122",
"Day Night\n",
"Dye free",
"Sugar free",
"Gluten free",
"Lactose free",
"Flavoured / Scented"
]
}
],
"productDetails": [
{
"title": "Product Details",
"descriptions": [
"SOOTHE & COMFORT. Soothing non-medicated vapors in an easy-to-use patch.",
"EASY TO USE. Simply peel, apply and experience the soothing non-medicated vapors.",
"SOOTHING SCENT YOU CAN TRUST, from Vicks.",
"FOR CHILDREN: Ages 6+"
]
}
],
"metadata": {
"pageTitle": "Soothing Non-Medicated VapoPatch Patch for Kids - Vicks",
"metaTitle": "Soothing Non-Medicated VapoPatch Patch for Kids - Vicks",
"metaDescription": "Vick's Children's VapoPatch Soothing Non-Medicated Patch for Kids with Vicks Vapors, 5ct",
"canonicalUrl": "/en-us/shop-products/childrens-products/vicks-childrens-vapopatch-soothing-non-medicated-patch-for-kids-with-vicks"
},
"ratingAndReviewId": "323900040588"
}
]
```
### Use Cases
- **Market Research**: Analyze Vicks product offerings to identify trends in children's health products.
- **Competitive Intelligence**: Compare Vicks products with competitors by extracting detailed specs and images.
- **Price Monitoring**: Track product variants and GTINs for pricing strategies.
- **Content Aggregation**: Build a database of product descriptions and images for e-commerce platforms.
- **Academic Research**: Study consumer health product marketing and descriptions.
- **Business Automation**: Automate data collection for inventory management or supplier integration.
### Installation and Usage
1. Search for "Vicks Url Scrapers" in the Apify Store
2. Click "Try for free" or "Run"
3. Configure input parameters
4. Click "Start" to begin extraction
5. Monitor progress in the log
6. Export results in your preferred format (JSON, CSV, Excel)
### Output Format
The output is a JSON array of objects, each representing a scraped product. Key fields include:
- `familyName`: Product category (e.g., "CHILDREN'S").
- `title`: Full product title.
- `url`: Relative URL path.
- `gtin`: Global Trade Item Number.
- `shortDescription` and `description`: Product details.
- `heroImage`: Main image with title and URL.
- `variants`: Array of product variants with names, GTINs, and images.
- `relatedProducts`: Linked products with IDs, titles, and images.
- `productDetails`: Structured details like features.
- `metadata`: SEO-related fields like page title and description.
- `ratingAndReviewId`: Identifier for reviews.
This structure ensures easy parsing and integration.
### Support
For custom/simplified outputs or bug reports, please contact:
- Email: support@getdataforme.com
- Subject line: "custom support"
- Contact form: https://getdataforme.com/contact/
We're here to help you get the most out of this Actor!
***
Extract comprehensive Vicks product data effortlessly! Features fast CheerioCrawler-based scraping, structured JSON output, and flexible URL inputs. Ideal for market research, competitive analysis, and e-commerce automation. Start scraping today! (148 characters)
# Actor input Schema
## `startUrls` (type: `array`):
URLs to start with.
## `maxRequestsPerCrawl` (type: `integer`):
Maximum number of requests that can be made by this crawler.
## Actor input object example
```json
{
"startUrls": [
{
"url": "https://vicks.com/en-us/shop-products/childrens-products/vicks-childrens-vapopatch-soothing-non-medicated-patch-for-kids-with-vicks"
}
],
"maxRequestsPerCrawl": 10
}
```
# 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 = {
"startUrls": [
{
"url": "https://vicks.com/en-us/shop-products/childrens-products/vicks-childrens-vapopatch-soothing-non-medicated-patch-for-kids-with-vicks"
}
]
};
// Run the Actor and wait for it to finish
const run = await client.actor("getdataforme/vicks-url-scrapers").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 = { "startUrls": [{ "url": "https://vicks.com/en-us/shop-products/childrens-products/vicks-childrens-vapopatch-soothing-non-medicated-patch-for-kids-with-vicks" }] }
# Run the Actor and wait for it to finish
run = client.actor("getdataforme/vicks-url-scrapers").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 '{
"startUrls": [
{
"url": "https://vicks.com/en-us/shop-products/childrens-products/vicks-childrens-vapopatch-soothing-non-medicated-patch-for-kids-with-vicks"
}
]
}' |
apify call getdataforme/vicks-url-scrapers --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=getdataforme/vicks-url-scrapers",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Vicks Url Scrapers",
"description": "Extract comprehensive Vicks product data effortlessly with Vicks URL Scrapers. Features fast CheerioCrawler-based scraping, structured JSON output, and flexible URL inputs. Ideal for market research, competitive analysis, and e-commerce automation. Start scraping today!",
"version": "0.0",
"x-build-id": "4nalZjOGhK4VYUZxZ"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/getdataforme~vicks-url-scrapers/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-getdataforme-vicks-url-scrapers",
"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/getdataforme~vicks-url-scrapers/runs": {
"post": {
"operationId": "runs-sync-getdataforme-vicks-url-scrapers",
"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/getdataforme~vicks-url-scrapers/run-sync": {
"post": {
"operationId": "run-sync-getdataforme-vicks-url-scrapers",
"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": [
"startUrls"
],
"properties": {
"startUrls": {
"title": "Start URLs",
"type": "array",
"description": "URLs to start with.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"maxRequestsPerCrawl": {
"title": "Max Requests per Crawl",
"type": "integer",
"description": "Maximum number of requests that can be made by this crawler.",
"default": 10
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```