# HealthWarehouse Scraper (Cheap) (`data_api/healthwarehouse-scraper-cheap`) Actor HealthWarehouse scraper that extracts product data by category, including price, stock, SKU, and URLs, so ecommerce and research teams can automate catalog tracking and monitor pharmacy market changes with a clean dataset output. - **URL**: https://apify.com/data\_api/healthwarehouse-scraper-cheap.md - **Developed by:** [Data API](https://apify.com/data_api) (community) - **Categories:** E-commerce, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.99 / 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## HealthWarehouse Catalog Scraper Pricing and stock data on HealthWarehouse changes constantly, and clicking through category pages to track it by hand does not scale. This scraper pulls a whole HealthWarehouse category into clean rows: pick a category, optionally add a few search keywords, and you get back each product's name, SKU, lowest price, stock status, and image links. Run it once for a snapshot or schedule it to watch prices over time. ![HealthWarehouse Catalog Scraper](cover.jpg) ### What you get Every product in the category becomes one row with a predictable shape, so the data drops straight into a sheet or database. Each row carries: - **Identity** — `itemId`, `itemName`, `itemSku`, `categorySlug` - **Pricing and availability** — `lowestPrice`, `defaultQuantity`, `stockStatus` - **Classification** — `activeFlag`, `visibilityLevel`, `pharmacyItem`, `specialOtcItem`, `taxClassRef` - **Links** — `itemUrl`, `imageLink`, `thumbnailLink` - **Run metadata** — `collectedAt`, plus `errorMessage` if a fetch fails ### Quick start 1. Click **Try for free** and open the input form. 2. Choose a **Catalog category** to scrape. 3. Optionally type a few keywords into **Search terms** to narrow the results. 4. Set a **Results limit** and pick a proxy type, then press **Start**. 5. When the run ends, export to JSON, CSV, Excel, or XML. ![How it works](how-it-works.jpg) ### Use cases - **Price monitoring** — track the lowest price on diabetic supplies, OTC meds, or personal care items over time - **Stock tracking** — watch `stockStatus` across a category to catch restocks and shortages early - **Competitive pricing** — benchmark HealthWarehouse prices against your own catalog or other pharmacies - **Catalog sync** — pull SKUs, names, and images to seed or refresh a product database - **Market research** — size up category breadth and pricing spread in the online pharmacy space ### Input | Field | Type | Required | Description | |-------|------|----------|-------------| | `categorySlug` | string | Yes | The HealthWarehouse category to pull products from. Choose from the dropdown. Default `over-the-counter`. | | `searchTerms` | array of strings | No | Keywords, one per line, searched inside the chosen category. Leave empty to return the full category. | | `stateCode` | string | No | Two-letter US state code passed to the API. Blank skips state filtering. | | `resultsLimit` | integer | No | Most products to collect in one run. Default `50`. | | `batchSize` | integer | No | Products requested per API call. Default `24`. | | `runTimeoutSeconds` | integer | No | Hard cut-off for the whole run, to control spend. Default `360`. | | `requestTimeoutSeconds` | integer | No | Wait per API call before giving up. Default `45`. | | `proxyConfiguration` | object | No | Proxies used for requests. Defaults to datacenter; switch to Residential if you get blocked. | #### Example input ```json { "categorySlug": "over-the-counter", "searchTerms": [ "ibuprofen", "glucose test strips" ], "stateCode": "", "resultsLimit": 50, "batchSize": 24, "runTimeoutSeconds": 360, "requestTimeoutSeconds": 45, "proxyConfiguration": { "useApifyProxy": true } } ```` ### Output Each product returns one row. Fields with no value from the API are left out of that row, so the dataset stays tidy. A row that fails carries `categorySlug`, `errorMessage`, and `collectedAt`. #### Example output ```json { "categorySlug": "over-the-counter", "itemId": 48213, "itemName": "Advil Ibuprofen 200 mg Tablets, 100 Count", "itemSku": "HW-ADV-200-100", "activeFlag": true, "visibilityLevel": 4, "pharmacyItem": false, "specialOtcItem": true, "taxClassRef": 2, "itemUrl": "https://www.healthwarehouse.com/advil-ibuprofen-200mg-tablets-100ct.html", "imageLink": "https://www.healthwarehouse.com/media/catalog/product/a/d/advil-200.jpg", "thumbnailLink": "https://www.healthwarehouse.com/media/catalog/product/a/d/advil-200-thumb.jpg", "lowestPrice": 12.49, "defaultQuantity": 1, "stockStatus": true, "collectedAt": "2026-06-29T12:00:00.000000+00:00", "errorMessage": null } ``` #### Output fields | Field | Type | Description | |-------|------|-------------| | `categorySlug` | string | Category slug requested in the input | | `itemId` | integer | Unique product identifier | | `itemName` | string | Display name of the product | | `itemSku` | string | Stock-keeping unit for the product | | `activeFlag` | boolean | True while the product is active | | `visibilityLevel` | integer | Visibility level reported by the API | | `pharmacyItem` | boolean | True when the product is a pharmacy item | | `specialOtcItem` | boolean | True when tagged special over-the-counter | | `taxClassRef` | integer | Reference to the product's tax class | | `itemUrl` | string | Link to the product detail page | | `imageLink` | string | URL of the main product image | | `thumbnailLink` | string | URL of the product thumbnail | | `lowestPrice` | number | Lowest listed price for the product | | `defaultQuantity` | number | Default order quantity | | `stockStatus` | boolean | True when the product is in stock | | `collectedAt` | string | ISO 8601 timestamp of when the row was captured | | `errorMessage` | string | Reason a record failed; `null` on success | ### Tips for best results - **Start small.** Set `resultsLimit` to 20–50 on your first run so you can confirm the fields fit your pipeline before pulling a full category. - **Use search terms to focus.** Adding keywords trims a broad category down to the products you actually care about. - **Raise the timeouts on residential proxies.** If slower proxy tiers cause dropped calls, bump `requestTimeoutSeconds` toward 60 and give `runTimeoutSeconds` more room. - **Tune `batchSize` for big categories.** A larger batch means fewer API calls; keep it within the 1–100 range. - **Switch to Residential if datacenter IPs get blocked.** Datacenter is fine for most runs, but residential helps when requests start failing. ### How can I use HealthWarehouse product data? **How can I use the HealthWarehouse Catalog Scraper to monitor prices?** Pick a category, set a `resultsLimit`, and run the scraper on a schedule. Each run records `lowestPrice` and `stockStatus` with a `collectedAt` timestamp, so you can chart how prices and availability move over days or weeks across the whole category. **How can I export HealthWarehouse product listings to a spreadsheet?** Run the scraper, then export the dataset as CSV or Excel. Every product comes back as one row with `itemName`, `itemSku`, `lowestPrice`, and `itemUrl`, so the file is ready to filter, sort, or pivot the moment it lands. **How can I pull HealthWarehouse SKUs and images for a product database?** Scrape a category and keep `itemId`, `itemSku`, `itemName`, `imageLink`, and `thumbnailLink`. That gives you the identifiers and media you need to seed a catalog or keep an existing one in sync, without copying anything by hand. **How can I research the online pharmacy market with this scraper?** Run several categories and compare the spread of prices, stock levels, and pharmacy-versus-OTC tagging. The `pharmacyItem` and `specialOtcItem` flags plus `lowestPrice` give you a quick read on how a category is priced and stocked. ### Is it legal to scrape data? Our actors are ethical and do not extract any private user data, such as email addresses or private contact information. They only extract what the user has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/). ### Support Questions, feature requests, or a field you'd like added? Reach out at and we'll get back to you. # Actor input Schema ## `categorySlug` (type: `string`): Pick one supported HealthWarehouse category to pull products from. ## `searchTerms` (type: `array`): Add one or more keywords (one per line) to narrow the results. Every keyword is searched inside the category you chose above. ## `stateCode` (type: `string`): Two-letter US state code passed to the API. Leave it blank to skip any state-based filtering. ## `resultsLimit` (type: `integer`): Highest number of products to collect in one run. ## `batchSize` (type: `integer`): How many products to request from the API in a single call. ## `runTimeoutSeconds` (type: `integer`): Hard cut-off for the whole run so you stay in control of spend. ## `requestTimeoutSeconds` (type: `integer`): How long to wait on each individual API call before giving up. ## `proxyConfiguration` (type: `object`): Route requests through proxies to sidestep IP blocks and rate limits. Datacenter proxies are the quickest; residential proxies are tougher to detect. ## Actor input object example ```json { "categorySlug": "over-the-counter", "searchTerms": [ "ibuprofen", "glucose test strips" ], "stateCode": "", "resultsLimit": 20, "batchSize": 24, "runTimeoutSeconds": 360, "requestTimeoutSeconds": 45, "proxyConfiguration": { "useApifyProxy": 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "categorySlug": "over-the-counter", "searchTerms": [], "stateCode": "", "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("data_api/healthwarehouse-scraper-cheap").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 = { "categorySlug": "over-the-counter", "searchTerms": [], "stateCode": "", "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("data_api/healthwarehouse-scraper-cheap").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 '{ "categorySlug": "over-the-counter", "searchTerms": [], "stateCode": "", "proxyConfiguration": { "useApifyProxy": true } }' | apify call data_api/healthwarehouse-scraper-cheap --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=data_api/healthwarehouse-scraper-cheap", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "HealthWarehouse Scraper (Cheap)", "description": "HealthWarehouse scraper that extracts product data by category, including price, stock, SKU, and URLs, so ecommerce and research teams can automate catalog tracking and monitor pharmacy market changes with a clean dataset output.", "version": "0.0", "x-build-id": "Neh4bCzHXWxEBJJtP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/data_api~healthwarehouse-scraper-cheap/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-data_api-healthwarehouse-scraper-cheap", "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/data_api~healthwarehouse-scraper-cheap/runs": { "post": { "operationId": "runs-sync-data_api-healthwarehouse-scraper-cheap", "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/data_api~healthwarehouse-scraper-cheap/run-sync": { "post": { "operationId": "run-sync-data_api-healthwarehouse-scraper-cheap", "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": [ "categorySlug" ], "properties": { "categorySlug": { "title": "Catalog category", "enum": [ "diabetic-supplies", "easytouch", "fsa", "hw-logo-products", "home-medical", "needles-syringes", "over-the-counter", "contraceptive", "personal-care", "products" ], "type": "string", "description": "Pick one supported HealthWarehouse category to pull products from.", "default": "over-the-counter" }, "searchTerms": { "title": "Search terms", "type": "array", "description": "Add one or more keywords (one per line) to narrow the results. Every keyword is searched inside the category you chose above.", "items": { "type": "string" } }, "stateCode": { "title": "State code", "type": "string", "description": "Two-letter US state code passed to the API. Leave it blank to skip any state-based filtering.", "default": "" }, "resultsLimit": { "title": "Results limit", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Highest number of products to collect in one run.", "default": 20 }, "batchSize": { "title": "Batch size", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many products to request from the API in a single call.", "default": 24 }, "runTimeoutSeconds": { "title": "Run timeout (seconds)", "minimum": 30, "maximum": 3600, "type": "integer", "description": "Hard cut-off for the whole run so you stay in control of spend.", "default": 360 }, "requestTimeoutSeconds": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "How long to wait on each individual API call before giving up.", "default": 45 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Route requests through proxies to sidestep IP blocks and rate limits. Datacenter proxies are the quickest; residential proxies are tougher to detect." } } }, "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 } } } } } } } } } } ```