# Costco Product Search Scraper (.com, .ca) (`ecomscrape/costco-product-search-scraper`) Actor

Extract comprehensive product data from Costco.com (or .ca) including pricing, inventory, ratings, and specifications. Our advanced scraper captures 70+ data fields from gaming computers, laptops, household items, and more for competitive analysis and market research.

- **URL**: https://apify.com/ecomscrape/costco-product-search-scraper.md
- **Developed by:** [ecomscrape](https://apify.com/ecomscrape) (community)
- **Categories:** E-commerce, Automation, Developer tools
- **Stats:** 19 total users, 2 monthly users, 100.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/actors/running/actors-in-store.md#pay-per-usage

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

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

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Contact

If you encounter any issues or need to exchange information, please feel free to contact us through the following link:
[My profile](https://apify.com/ecomscrape)

## **costco.com Scraper: Extract Product Data & Pricing Intelligence**

### Introduction

Costco.com serves as the digital gateway to one of America's largest membership warehouse clubs, offering electronics, computers, furniture, outdoor living, appliances, and jewelry with low warehouse prices on name-brand products delivered to your door. The platform operates on a unique business model that combines membership-based shopping with volume purchasing efficiencies, making it a critical data source for competitive analysis, pricing intelligence, and market research.

The challenge lies in accessing this valuable data at scale, as Costco.com reflects live, real-time inventory with limited promotional offers. Manual data collection is time-consuming and impractical for businesses needing comprehensive market insights. Our Costco.com Product Search Scraper addresses this challenge by automating the extraction of detailed product information, pricing data, and inventory status across multiple categories.

### Comprehensive Costco.com Data Extraction Solution

Our Costco.com scraper is designed specifically to handle the complexities of extracting data from one of the most sophisticated e-commerce platforms in the retail industry. The tool successfully navigates Costco's dynamic layout changes and anti-bot protection systems while extracting crucial data points like pricing, stock status, product titles, SKUs, and location availability.

The scraper excels at processing large-scale product categories including gaming computers, laptops, bath & body products, household essentials, appliances, and seasonal items. It's particularly valuable for retailers, e-commerce businesses, market researchers, and pricing analysts who need comprehensive competitive intelligence from Costco's extensive product catalog.

**Target Users:**

- E-commerce businesses seeking competitive pricing data
- Market research firms analyzing retail trends
- Retailers developing pricing strategies
- Inventory management teams tracking stock availability
- Business intelligence analysts monitoring consumer electronics markets

### Input and Output Details

Example url 1: https://www.costco.com/gaming-computers.html

Example url 2: https://www.costco.ca/mac.html

Example url 3: https://www.costco.com/bath-body.html

Example Screenshot of product information page:

![](https://i.ibb.co/4n1fFSgB/Screenshot-from-2025-08-27-12-46-33.png)

#### Input Format

The scraper accepts configuration through a JSON object with several key parameters:

##### Scrape with URLs:

```json
{
  "max_retries_per_url": 2, // Maximum number of retry attempts for each URL if scraping fails
  "proxy": { // Proxy configuration to avoid bot detection
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL" 
    ],
    "apifyProxyCountry": "US" // Choose a country that matches your target data location
  },
  "max_items_per_url": 20, // Limit the number of items to scrape per URL
  "urls": [ 
    "https://www.costco.com/televisions.html?refine="
    // Add URLs of product list pages you want to scrape
  ],
  "ignore_url_failures": true // Continue scraping even if some URLs fail
}
```

**The `urls` parameter**: Add the URLs of the product list pages you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

**The `ignore_url_failures` parameter**: If set to `true`, the scraper will continue running even if some URLs fail to be scraped after the maximum number of retries is reached. This ensures that one problematic URL doesn't stop your entire scraping job.

*When you provide a list of URLs for scraping, all options in the "Scrape with search filters" section will be disabled. The system will only collect data from the URLs you specified.*

##### Scrape with Search Filters:

```json
{
  "max_retries_per_url": 2, // Maximum number of retry attempts for each search request
  "proxy": { // Proxy configuration to avoid bot detection
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL" 
    ],
    "apifyProxyCountry": "US" // Choose a country that matches your target data location
  },
  "max_items_per_url": 20, // Total number of items you want to scrape
  "keyword": "tank top", // Search keyword to find products
  "region": "com", // Region to search for items
  "rating": "4", // Filter by minimum rating
  "price_range": "50-100", // Filter by price range
  "sort_by": "item_location_pricing_salePrice+asc", // Sort products by specific criteria
  "page": 1 // Specify the page number to start scraping from
}
```

**The `keyword` parameter**: Enter the keyword to search for items (e.g., "tank top", "laptop", "television", "furniture").

**The `region` parameter**: Select the region to search for items:

- `"com"` - United States
- `"ca"` - Canada

**The `rating` parameter**: Filter items by minimum rating:

- `""` - Any
- `"1"` - 1 Star & Up
- `"2"` - 2 Star & Up
- `"3"` - 3 Star & Up
- `"4"` - 4 Star & Up

**The `price_range` parameter**: Filter items by price range:

- `""` - Any
- `"0-25"` - $0 - $25
- `"25-50"` - $25 - $50
- `"50-100"` - $50 - $100
- `"100-200"` - $100 - $200
- `"200-500"` - $200 - $500
- `"1000-2000"` - $1000 - $2000

**The `sort_by` parameter**: Sort items by specific criteria:

- `""` - Any
- `"item_location_pricing_salePrice+desc"` - Price - High to Low
- `"item_location_pricing_salePrice+asc"` - Price - Low to High
- `"item_ratings+desc"` - Rating - High to Low
- `"item_startDate+desc"` - Date - New to Old
- `"item_page_views+desc"` - Views - High to Low

**The `page` parameter**: Specify the page number to start scraping from (e.g., 1, 2, 3...).

*When using search filters for scraping, you need to leave the `urls` field empty in the "Scrape with URLs" configuration.*

##### General Options:

**The `max_items_per_url` parameter**: Limit the number of items per URL or search filters you want to scrape. The default value is 20, providing a manageable batch size while allowing for comprehensive data collection.

**The `max_retries_per_url` parameter**: Limit the number of retries for each URL or search filters if the scrape is detected as a bot or the page fails to load. The default value is 2, providing a good balance between thoroughness and efficiency.

**The `proxy` parameter**: Proxy configuration is essential for maintaining anonymity and avoiding detection. The residential proxy option ensures that your scraping activities appear as legitimate browsing, reducing the risk of being blocked or rate-limited. You should choose a country that matches the location of the website you're scraping (e.g., US for costco.com, CA for costco.ca).

#### Output Format

You get the output from the costco.com Product Search Scraper stored in a tab. The following is an example of the Information Fields collected after running the Actor.

```json
[ // List of product information
  {
  "item_product_name": "TCL 55\" Class - Q77 Series - 4K UHD QLED Smart TV - Allstate 3-Year Protection Plan Bundle Included for 5 Years of Total Coverage*",
  "item_name": "TCL 55\" Class - Q77 Series - 4K UHD QLED Smart TV - Allstate 3-Year Protection Plan Bundle Included for 5 Years of Total Coverage*",
  "name": "TCL 55\" Class - Q77 Series - 4K UHD QLED Smart TV - Allstate 3-Year Protection Plan Bundle Included for 5 Years of Total Coverage*",
  "description": "TCL 55\" Class - Q77 Series - 4K UHD QLED Smart TV - Allstate 3-Year Protection Plan Bundle Included for 5 Years of Total Coverage*",
  "item_short_description": "TCL 55\" Class - Q77 Series - 4K UHD QLED Smart TV - Allstate 3-Year Protection Plan Bundle Included for 5 Years of Total Coverage*",
  "item_product_short_description": "TCL 55\" Class - Q77 Series - 4K UHD QLED Smart TV - Allstate 3-Year Protection Plan Bundle Included for 5 Years of Total Coverage*",
  "item_number": "9555677",
  "id": "9555677!item.en-US",
  "group_id": "4000362984",
  "brand_attr": [
    "TCL"
  ],
  "item_manufacturing_skus": [
    "846042043205"
  ],
  "item_product_marketing_features": [
    "High Contrast HVA Panel - HVA Panel Technology Provides Incredible Contrast for Stunning Pictures;\n144Hz Native Refresh Rate;\nBacklit Voice Remote;\nQLED - Quantum Dot Technology - Vibrant Colors Covering Nearly the Entire Color Space Bringing Images to Life;\nHDR PRO+ Dolby Vision, HDR10+, HDR10, HLG"
  ],
  "item_product_marketingcontent_keywords": [
    "TCLTVS",
    "Ends615",
    "OahuDelivery",
    "",
    "PuertoRicoDelivery"
  ],
  "item_product_marketing_statement": "Price valid through 9/21/25<p class='promo'>Qualifies for Costco Direct Savings. See Product Details.</p>",
  "item_location_pricing_price_per_unit_price": 279.99,
  "item_location_pricing_sale_price": 279.99,
  "item_location_pricing_list_price": 279.99,
  "min_sale_price": 279.99,
  "max_sale_price": 279.99,
  "item_location_currency_code": "USD",
  "item_ratings": 4.397600173950195,
  "item_review_ratings": "4.397600173950195",
  "item_rating_value": [
    "1 & Up",
    "2 & Up",
    "3 & Up",
    "4 & Up"
  ],
  "item_review_count": 0,
  "item_product_review_count": 83,
  "item_rating_average_value": 0,
  "item_fsa_eligible": false,
  "item_buyable": true,
  "item_product_buyable": true,
  "item_chdi_eligible": false,
  "item_status_published": true,
  "item_product_status_published": true,
  "item_eligible_for_review": "true",
  "item_product_review_eligible": true,
  "item_searchable": true,
  "item_disponzeroinv": true,
  "item_product_status_disponzeroinv": true,
  "item_program_eligibility": [
    "3rdPartyDelivery",
    "LocationControlledInventory",
    "InWarehouse",
    "UseWarehouseInventory",
    "LTLPickUp",
    "WarehouseDelivery",
    "Standard",
    "ShipIt"
  ],
  "item_variableweight": false,
  "item_member_only": false,
  "item_backorderflag": 0,
  "item_product_status_backorderflag": 0,
  "item_backorderqty": 0,
  "item_product_status_backorderqty": 0,
  "in_warehouse_status": null,
  "delivery_status": "in stock",
  "item_location_availability": "in stock",
  "item_location_stock_status": "in stock",
  "item_location_item_number": "9555677",
  "item_location_location_number": "1255-3pl",
  "item_location_fulfillment_restrictions_min_qty": "1",
  "item_location_fulfillment_restrictions_max_qty": "10",
  "is_item_in_stock": true,
  "category_path_ss": [
    "/televisions.html",
    "/electronics.html",
    "/55-inch-tvs-through-59-inch-tvs.html"
  ],
  "item_as400_department": "24",
  "item_as400_category": "ADB",
  "item_classification_itemclass": "Standard",
  "content_type": [
    "product"
  ],
  "item_collateral_primaryimage": "https://bfasset.costco-static.com/U447IH35/as/kgf74zqpx72m5hxtp6qwmx/4000362984-847__1?auto=webp&format=jpg&width=350&height=350&fit=bounds&canvas=350,350",
  "item_product_primary_image": "https://bfasset.costco-static.com/U447IH35/as/kgf74zqpx72m5hxtp6qwmx/4000362984-847__1?auto=webp&format=jpg&width=350&height=350&fit=bounds&canvas=350,350",
  "image": "https://bfasset.costco-static.com/U447IH35/as/kgf74zqpx72m5hxtp6qwmx/4000362984-847__1?auto=webp&format=jpg&width=350&height=350&fit=bounds&canvas=350,350",
  "item_image_swatchable": false,
  "item_product_image_swatchable": false,
  "images": [
    {
      "item_collateral_primaryimage": "https://bfasset.costco-static.com/U447IH35/as/kgf74zqpx72m5hxtp6qwmx/4000362984-847__1?auto=webp&format=jpg&width=350&height=350&fit=bounds&canvas=350,350"
    }
  ],
  "item_product_comparable": true,
  "item_comparable": true,
  "item_product_price_in_cart_only": "0",
  "has_single_sku": true,
  "item_start_date": "2025-04-24T00:00:00Z",
  "is_future_date": false,
  "product_spercifications": null,
  "from_url": "https://www.costco.com/televisions.html?refine="
}, // ... Many other product details
]
```

Our scraper extracts over 70 data fields, providing complete product intelligence:

**Core Product Information:**

- **Product Name/Item Name**: Primary product identifier for catalog management
- **Description/Short Description**: Detailed and abbreviated product descriptions for content optimization
- **Product Number/ID/Group ID**: Unique identifiers for inventory tracking and database integration
- **Brand Attributes**: Manufacturer information for brand analysis and supplier intelligence

**Pricing and Financial Data:**

- **Price per Unit/Sale Price/List Price**: Current and original pricing for profit margin analysis
- **Min Sale Price/Max Sale Price**: Price range data for dynamic pricing strategies
- **Currency Code**: International currency support for global market analysis
- **FSA Eligible**: Health Savings Account eligibility for healthcare market segments

**Inventory and Availability:**

- **Stock Status/In Stock**: Real-time inventory levels for supply chain optimization
- **Warehouse Status/Delivery Status**: Location-specific availability for logistics planning
- **Location Availability/Location Number**: Regional stock distribution intelligence
- **Backorder Flag/Backorder Quantity**: Out-of-stock product forecasting data

**Customer Intelligence:**

- **Ratings/Review Ratings/Average Rating**: Customer satisfaction metrics for quality assessment
- **Review Count/Product Review Count**: Engagement metrics for popularity analysis
- **Rating Values**: Detailed rating breakdowns for sentiment analysis

**Marketing and Merchandising:**

- **Marketing Features/Marketing Content Keywords**: SEO and content strategy insights
- **Marketing Statement**: Promotional messaging analysis
- **Primary Image/Images**: Visual content for competitive design analysis
- **Category Path/AS400 Department**: Product categorization for market segmentation

### Step-by-Step Usage Guide

#### Method 1: Scrape with URLs

**1. Configuration Setup**
Configure your scraping parameters based on data volume needs and target categories. Set appropriate retry limits and proxy settings to ensure consistent data collection without triggering anti-bot measures.

**2. URL Selection**
Add specific Costco.com category pages or product listing URLs to the `urls` array. Focus on categories most relevant to your competitive analysis - electronics, appliances, or household items typically provide rich datasets. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

**3. Execution and Monitoring**
Launch the scraper and monitor progress through built-in logging. The tool handles pagination automatically and manages rate limiting to maintain consistent data flow.

**4. Data Processing**
Review extracted data for completeness and accuracy. The scraper provides structured output in JSON format, ready for database import or analytical processing.

#### Method 2: Scrape with Search Filters

**1. Configuration Setup**
Configure your scraping parameters including proxy settings and retry limits to ensure reliable data collection.

**2. Search Criteria Definition**
Define your search criteria using the available filters:

- **Keyword**: Enter the product search term (e.g., "laptop", "television", "furniture")
- **Region**: Select United States (com) or Canada (ca) to target specific market
- **Rating**: Filter products by minimum star rating (1-4 stars & up)
- **Price Range**: Narrow results to specific price brackets ($0-$25, $25-$50, etc.)
- **Sort By**: Choose sorting criteria (price, rating, date, or views)
- **Start Page**: Specify which page to begin scraping from

**3. Execution and Monitoring**
Launch the scraper with your configured filters. The tool automatically navigates through search results, handles pagination, and manages rate limiting to maintain consistent data flow.

**4. Data Processing**
Review extracted data for completeness and accuracy. The scraper provides structured output in JSON format, ready for database import or analytical processing.

#### Best Practices:

- **Start Small**: Begin with smaller page limits to test configuration and validate results
- **Use Residential Proxies**: Maintain consistent access and avoid detection by using residential proxy groups
- **Regular Collection**: Schedule regular data collection for pricing trend analysis and market monitoring
- **Data Validation**: Implement validation checks for critical fields like pricing, availability, and ratings
- **Region-Specific Scraping**: Match your proxy country setting with the target region (US for .com, CA for .ca)
- **Filter Optimization**: When using search filters, start broad and gradually refine to ensure you capture all relevant products
- **Leave URLs Empty**: When using search filters, ensure the `urls` field is empty to avoid conflicts

### Business Value and Applications

**Time Efficiency:** Automated data collection replaces hours of manual research with comprehensive datasets delivered in minutes. Businesses can effectively monitor real-time stock availability, track restocking schedules, and investigate intricate inventory trends.

**Competitive Intelligence:** Access to Costco's pricing strategies, product positioning, and inventory management provides crucial competitive advantages for retailers and e-commerce businesses.

**Market Research Applications:**

- Pricing strategy development and dynamic pricing implementation
- Product assortment analysis and gap identification
- Seasonal trend monitoring and demand forecasting
- Supply chain optimization through inventory pattern analysis

**ROI Impact:** Companies typically see 300-500% ROI through improved pricing decisions, better inventory management, and enhanced competitive positioning based on comprehensive Costco market intelligence.

### Conclusion

Our Costco.com Product Search Scraper delivers comprehensive e-commerce intelligence through automated data extraction of pricing, inventory, and product information. With over 70 data fields and robust handling of Costco's sophisticated platform, it provides the competitive advantages businesses need for data-driven decision making.

Transform your market research and competitive analysis capabilities with reliable, real-time Costco product data. Start extracting valuable insights from one of retail's most important platforms today.

## Your feedback

We are always working to improve Actors' performance. So, if you have any technical feedback about costco.com Product Search Scraper or simply found a bug, please create an issue on the Actor's Issues tab in Apify Console.

# Actor input Schema

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

Add the URLs of the Product list page 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 after the maximum number of retries is reached.

## `keyword` (type: `string`):

Enter the keyword to search for items

## `region` (type: `string`):

Enter the region to search for items

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

Enter the rating to search for items

## `price_range` (type: `string`):

Enter the price range to search for items

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

Enter the sort by to search for items

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

Enter the start page to search for items

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

Limit the number of items per URL or search filters you want to scrape

## `max_retries_per_url` (type: `integer`):

Limit the number of retries for each URL or search filters if the scrape is detected as a bot or the page fails to load

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

Select proxies to be used by your scraper.

## Actor input object example

```json
{
  "urls": [
    "https://www.costco.com/televisions.html?refine="
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20,
  "max_retries_per_url": 2,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

# 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.costco.com/televisions.html?refine="
    ],
    "ignore_url_failures": true,
    "max_items_per_url": 20,
    "max_retries_per_url": 2,
    "proxy": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "US"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("ecomscrape/costco-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.costco.com/televisions.html?refine="],
    "ignore_url_failures": True,
    "max_items_per_url": 20,
    "max_retries_per_url": 2,
    "proxy": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "US",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("ecomscrape/costco-product-search-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.costco.com/televisions.html?refine="
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20,
  "max_retries_per_url": 2,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}' |
apify call ecomscrape/costco-product-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,ecomscrape/costco-product-search-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/g1zMGhs7wrJQXLteB/builds/fsBRZE1dfO4JYedUA/openapi.json