WebstaurantStore Product Scraper: Extract Commercial Equipment Data

---

What Is WebstaurantStore?

WebstaurantStore is a leading B2B e-commerce platform specializing in commercial foodservice equipment, supplies, and smallwares. With hundreds of thousands of product listings ranging from commercial refrigerators to point-of-sale systems, it serves restaurants, catering businesses, and hospitality enterprises globally. Manually extracting structured data from product listings is inefficient — the WebstaurantStore Product Scraper automates this process, delivering comprehensive product information in machine-readable format.

---

Overview

The WebstaurantStore Product Scraper extracts detailed product information from search result pages, converting each listing into a structured record with 70+ fields. It is ideal for:

• Price monitoring platforms tracking commercial equipment costs across vendors
• Product researchers analyzing equipment specifications and market trends
• Restaurant & hospitality operators comparing alternatives programmatically
• E-commerce aggregators building comprehensive equipment catalogs
• Business intelligence teams conducting competitive analysis

Key features include configurable item limits per page, graceful error handling, and comprehensive product data including pricing, inventory status, specifications, and customer reviews.

---

Input Format

The scraper accepts a JSON configuration object:

{
  "urls": [
    "https://www.webstaurantstore.com/search/commercial-refrigerator.html?page=2"
  ],
  "max_items_per_url": 200,
  "ignore_url_failures": true
}

Parameter	Type	Description
urls	array	Direct links to WebstaurantStore product search result pages. Include page numbers in the URL (e.g., ?page=2). Can add multiple URLs for batch processing.
max_items_per_url	integer	Maximum number of products to extract per URL. Default: 500. Recommended: 200–500 for balanced performance.
ignore_url_failures	boolean	If true, continues scraping even if a URL fails. If false, halts on first failure. Recommended: true for batch jobs.

Best practices: Use specific search URLs to target product categories (refrigeration, cooking, storage, etc.). Pagination parameters (?page=N) are preserved in the scrape URL, allowing sequential collection across multiple result pages.

---

Output Format

Example output snippet:

{
  "minimum_customization_price": 0.0,
  "is_customizable": false,
  "customization_required": false,
  "customization_url": "",
  "alt": "Avantco SS-1R-G-HC 29 inch Stainless Steel Glass Door Reach-In Refrigerator",
  "alt_html": "Avantco SS-1R-G-HC 29 inch Stainless Steel Glass Door Reach-In Refrigerator",
  "is_in_stock": true,
  "unit_of_measure": "Each",
  "units_per_packaging": 1,
  "minimum_buy": 1,
  "must_buy": 1,
  "start_buy": 1,
  "minimum_quantity_can_purchase": 1,
  "show_below_minimum_advertised_price_for_logged_in_customers": false,
  "show_below_minimum_advertised_price_for_platinum_and_plus_customers": false,
  "must_purchase_more_than_one": false,
  "one_to_five_star_rating": 3,
  "overall_rating": 3,
  "accessories": [],
  "is_webstaurant_plus_eligible": true,
  "product_badges": [
    {
      "name": "115 Volts",
      "image_path": "/uploads/design/2016/12/bolt.png",
      "show_badge_fraction": false,
      "priority": 6,
      "classification_name": "Voltage"
    }
  ],
  "has_badge": true,
  "badge_image_path": "/uploads/design/2016/12/bolt.png",
  "badge_display_text": "115 Volts",
  "badge_classification_name": "Voltage",
  "has_accessories": false,
  "has_available_accessories": false,
  "has_required_accessories": false,
  "link": "/avantco-ss-1r-g-hc-29-glass-door-reach-in-refrigerator/178SS1RGHC.html",
  "item_number": "178ss1rghc",
  "item_number_id": 228816,
  "original_id": "178ss1rghc",
  "description": "Avantco SS-1R-G-HC 29\" Stainless Steel Glass Door Reach-In Refrigerator",
  "description_html": "Avantco SS-1R-G-HC 29\" Stainless Steel Glass Door Reach-In Refrigerator",
  "price": {
    "price": 1899,
    "display_sale_price": false,
    "sale_price": 0,
    "has_quantity_discounts": false,
    "has_lot_quantity_discounts": false,
    "has_single_lot_quantity_discount": false,
    "lot_quantity_discounts": [],
    "quantity_discounts": [],
    "display_minimum_advertised_price": false,
    "apply_type_l_price_to_platinum_plus": false,
    "minimum_advertised_price_properties": {
      "price": 0,
      "type": " "
    },
    "minimum_advertised_price_override": {
      "price_level5": 1719
    }
  },
  "is_price_override": false,
  "is_new_product": false,
  "is_equivalent_part": false,
  "is_replacement_eligible": false,
  "primary_image_path": "/images/products/medium/228816/2153434.jpg",
  "secondary_image_path": "/images/products/medium/228816/2148590.jpg",
  "grouping": false,
  "grouping_attributes": {
    "configuration_option_summary": [],
    "group_members": [],
    "is_virtual": false,
    "is_group_master": false,
    "is_group_member": false,
    "virtual_group_item_number": ""
  },
  "outlet_attributes": {
    "is_outlet": false,
    "warehouse_location": 0,
    "original_price": 0.0,
    "outlet_product_id": 0,
    "call_for_pricing": false
  },
  "shipping_type": "C",
  "has_free_shipping": true,
  "weight_in_pounds": 298,
  "is_automatic_reorder_eligible": false,
  "customer_exclusivity": {
    "disallow_non_member_to_purchase": false,
    "allow_platinum_to_purchase": false,
    "allow_webstaurant_plus_to_purchase": false
  },
  "compatible_parts": [],
  "compatible_accessories": [],
  "compatible_models": [],
  "companion_products_v2": [],
  "brand": "Avantco Refrigeration",
  "brand_logo": "avantcorefrigeration_logo_hr.svg",
  "brand_link": "/vendor/avantco-refrigeration.html",
  "product_specifications": [],
  "disclaimers": {
    "warranty_information": "Note: Avantco Refrigeration equipment with a labor warranty purchased prior to May 1st, 2024, is warranted for 1-year parts & labor / 5-year compressor. Any equipment installed outdoors, in a temporary structure, food truck, other mobile application, or in a residence or home-based business is covered by a 30-day replacement warranty through the place of purchase."
  },
  "categories": [
    {
      "default": true,
      "id": 52705,
      "name": "Reach-In Refrigerators"
    }
  ],
  "feed_identifier": "178CFD1RRG",
  "source_vendors": [
    {
      "name": "Avantco Refrigeration",
      "code": "XIN502",
      "hidden": false
    }
  ],
  "parent_categories": [
    {
      "name": "Refrigeration Equipment"
    },
    {
      "name": "Reach-In Refrigerators and Freezers"
    },
    {
      "name": "Reach-In Refrigerators"
    }
  ],
  "brands": [
    {
      "is_primary": true,
      "name": "Avantco Refrigeration",
      "our_brand": {
        "is_our_brand": true
      }
    },
    {
      "is_primary": false,
      "name": "Avantco",
      "our_brand": {
        "is_our_brand": true
      }
    }
  ],
  "actual_vendor_item_number": "ND-CFD-1RR-G-HC",
  "product_review_count": 26,
  "is_request_a_quote_enabled": false,
  "video_ids": [
    18166,
    16794,
    13028,
    12946
  ],
  "divide_by_unit": "",
  "divide_quantity": 0.0,
  "header": "Avantco SS-1R-G-HC 29\" Stainless Steel Glass Door Reach-In Refrigerator",
  "variation_membership": {
    "has_membership": true,
    "variation_groups": [
      {
        "id": 4818,
        "is_collapsed": false,
        "is_sorted": false,
        "option_name": "Style",
        "collapsed_label_override": "",
        "display_type_id": 2,
        "show_as_modal": false,
        "variation_group_items": [
          {
            "item_number": "178ss1r2hc",
            "display_text": "Other Available Styles",
            "variation_text": "Stainless Steel Half Door",
            "thumbnail": "/images/products/small/393164/3014855.jpg",
            "is_in_stock": true,
            "seo_link": "/avantco-ss-1r-2-hc-29-stainless-steel-solid-half-door-reach-in-refrigerator/178SS1R2HC.html",
            "item_order_by": 1,
            "order_by": 82,
            "is_webstaurant_plus_eligible": true,
            "product_price": 2249.0
          },
          {
            "item_number": "178ss1rghc",
            "display_text": "Other Available Styles",
            "variation_text": "Glass Door",
            "thumbnail": "/images/products/small/228816/2153434.jpg",
            "is_in_stock": true,
            "seo_link": "/avantco-ss-1r-g-hc-29-glass-door-reach-in-refrigerator/178SS1RGHC.html",
            "item_order_by": 2,
            "order_by": 82,
            "is_webstaurant_plus_eligible": true,
            "product_price": 1899.0
          },
          {
            "item_number": "178ss1rhc",
            "display_text": "Other Available Styles",
            "variation_text": "Solid Door",
            "thumbnail": "/images/products/small/228852/3014871.jpg",
            "is_in_stock": true,
            "seo_link": "/avantco-ss-1r-hc-29-solid-door-reach-in-refrigerator/178SS1RHC.html",
            "item_order_by": 3,
            "order_by": 82,
            "is_webstaurant_plus_eligible": true,
            "product_price": 1799.0
          }
        ]
      }
    ]
  },
  "breadcrumbs": [
    {
      "title": "Refrigeration Equipment",
      "link": "/refrigeration-equipment.html",
      "category_id": 13403
    },
    {
      "title": "Reach-In Refrigerators and Freezers",
      "link": "/13421/reach-in-refrigerators-and-freezers.html",
      "category_id": 13421
    },
    {
      "title": "Reach-In Refrigerators",
      "link": "/52705/reach-in-refrigerators.html",
      "category_id": 52705
    }
  ],
  "from_url": "https://www.webstaurantstore.com/search/commercial-refrigerator.html?page=2"
}

Each product record includes 70+ fields organized by category:

Product Identification

Field	Meaning & Use Case
Item Number	Unique WebstaurantStore SKU—use as primary key in your database
Item Number ID	Internal numeric ID for database lookups
Original ID	Manufacturer original part number (if applicable)
Link	Product detail page URL—link back to full product info
Feed Identifier	Catalog feed ID—useful for tracking data source
Brand	Manufacturer brand name (e.g., "Turbo Air", "Hobart")
Brand Logo	URL to brand logo image—useful for category displays
Brand Link	Link to brand page on WebstaurantStore

Descriptive Content

Field	Meaning & Use Case
Description	Full product name and marketing description
Description HTML	HTML-formatted description with formatting and links
Product Specifications	Detailed spec sheet (dimensions, capacity, wattage, materials, etc.)—critical for equipment buyers comparing models
Disclaimers	Legal disclaimers or usage restrictions—important for compliance
Categories	Product category hierarchy (e.g., "Refrigeration > Reach-In Refrigerators")
Parent Categories	Higher-level category groupings
Breadcrumbs	Navigation breadcrumb trail for context

Pricing & Promotions

Field	Meaning & Use Case
Price	Current selling price (typically in USD)
Is Price Override	Indicates if price is manually set or auto-calculated
Minimum Customization Price	Base price for customizable products before add-ons
Is Customizable	Whether the product offers customization options
Customization Required	Whether customization is mandatory before purchase
Customization URL	Link to customization builder or form
Show Below Minimum Advertised Price For Logged In Customers	Indicates if a lower MAP applies to registered users
Show Below Minimum Advertised Price For Platinum And Plus Customers	Special pricing for loyalty program members

Inventory & Availability

Field	Meaning & Use Case
Is In Stock	Boolean flag—true if item is available for immediate shipment
Unit Of Measure	Measurement unit (pieces, cases, pallets, etc.)
Units Per Packaging	How many units come per package—essential for bulk buyers
Minimum Buy	Minimum quantity that must be ordered
Must Buy	Indicates mandatory purchase quantity constraints
Start Buy	Starting quantity tier for bulk pricing
Minimum Quantity Can Purchase	Lowest allowed order quantity
Must Purchase More Than One	Forces multi-unit orders—useful for identifying minimum order constraints

Shipping & Logistics

Field	Meaning & Use Case
Shipping Type	How the item ships (standard, expedited, freight, etc.)
Has Free Shipping	Boolean—true if eligible for free shipping
Weight In Pounds	Product weight—critical for freight cost estimation
Divide By Unit	Shipping calculation multiplier
Divide Quantity	Quantity-based division for shipping rates

Customer Reviews & Ratings

Field	Meaning & Use Case
Overall Rating	Average star rating (1–5 scale)
One To Five Star Rating	Detailed rating breakdown
Product Review Count	Number of customer reviews—indicator of product popularity

Media & Visuals

Field	Meaning & Use Case
Primary Image Path	URL to main product image
Secondary Image Path	URL to alternate product images
Alt	Alt text for image accessibility
Alt HTML	HTML-formatted alt text

Product Badges & Promotions

Field	Meaning & Use Case
Has Badge	Boolean—indicates promotional badge presence
Badge Image Path	URL to badge graphic (e.g., "Bestseller", "New")
Badge Display Text	Text shown on the badge
Badge Classification Name	Internal badge category (helps identify promotion type)
Product Badges	Array of all badges applied to the product

Features & Eligibility

Field	Meaning & Use Case
Is New Product	Boolean—true for newly added products
Is Equivalent Part	Indicates if product is a substitute for another model
Is Replacement Eligible	Whether product qualifies for warranty replacement programs
Is WebstaurantStore Plus Eligible	Eligible for loyalty program benefits
Is Automatic Reorder Eligible	Can be set up for recurring auto-shipments
Is Request A Quote Enabled	Can request custom bulk pricing via quote form

Accessories & Compatibility

Field	Meaning & Use Case
Accessories	Array of recommended add-on products
Has Accessories	Boolean—true if accessories are listed
Has Available Accessories	Indicates if recommended accessories are in stock
Has Required Accessories	Required add-ons for this product
Compatible Parts	Parts compatible with this product
Compatible Accessories	Accessories that work with this product
Compatible Models	Other models this product works with
Companion Products V2	Related bundle items or kits

Organization & Sourcing

Field	Meaning & Use Case
Grouping	Product grouping or family classification
Grouping Attributes	Attributes defining the product grouping
Outlet Attributes	Flags for outlet/clearance/overstock inventory
Source Vendors	Vendors supplying this product
Actual Vendor Item Number	Manufacturer's part number
Brands	Brand array (for multi-brand bundled products)
Customer Exclusivity	Usage restrictions (B2B-only, certain geographies, etc.)

Additional Features

Field	Meaning & Use Case
Header	Section header or product category header text
Variation Membership	Product variant grouping (color, size, capacity variations)
Video IDs	YouTube or Vimeo video IDs showcasing the product

---

How to Use

1. Find search URLs — Navigate to WebstaurantStore and run a product search (e.g., "commercial refrigerator"). Copy the result page URL, including pagination parameters.

2. Prepare configuration — Add URLs to the urls array. Adjust max_items_per_url based on your needs:

   • 200–300: For focused analysis of a single product category
   • 500+: For comprehensive market research across multiple pages

3. Enable robust error handling — Set ignore_url_failures: true if running multiple URLs to prevent interruption from temporary connection issues.

4. Execute the scrape — Start the actor and monitor progress in the run log. The scraper will extract all product fields and format output as JSON, CSV, or Excel.

5. Process results — Load output into your analytics tool, database, or BI platform:

   • Filter by Is In Stock to identify available inventory
   • Group by Brand to analyze supplier market share
   • Sort by Price and Overall Rating to identify best-value products
   • Use Minimum Buy to calculate procurement costs for bulk orders

Handling common scenarios:

• Multi-page scraping: Add multiple URLs with ?page=1, ?page=2, etc., to the array
• Category filtering: Target URLs with specific product filters (e.g., ?_brand=Turbo%20Air) to narrow scope
• Failed URLs: Keep ignore_url_failures: true to skip pages that timeout or return 404 errors

---

Use Cases & Business Value

• Price monitoring: Track competitor pricing on key equipment categories and identify margin opportunities
• Market research: Analyze product availability, specifications, and ratings to understand market trends
• Procurement optimization: Compare equivalent products by price, ratings, and minimum order quantities to negotiate better deals
• Inventory management: Monitor stock status and automate reorder alerts when items become available
• Equipment planning: Extract specifications to match requirements with compatible models across vendors
• Customer intelligence: Analyze review counts and ratings to guide purchasing decisions and vendor selection

The WebstaurantStore Product Scraper transforms tedious manual research into actionable data, enabling informed purchasing decisions and competitive positioning in the foodservice industry.

---

Conclusion

Whether you're comparing equipment prices, researching product specifications, or building a comprehensive equipment catalog, the WebstaurantStore Product Scraper delivers the detailed, structured data you need. With 70+ fields per product and support for large-scale batch processing, it scales from single-product lookups to enterprise-grade market analysis.