HEB Product Search Scraper: Extract Grocery Data Instantly

---

What Is HEB.com?

H-E-B (Here Everything's Better) is one of the largest supermarket chains in the United States, operating hundreds of stores across Texas and Mexico. HEB.com is its e-commerce platform, offering grocery delivery and in-store pickup for thousands of products — from fresh meat and produce to packaged goods and household items.

Manually collecting product data from HEB's search results is tedious and impractical at scale. The HEB Product Search Scraper automates this process, extracting structured product records from search results or direct URLs in minutes.

---

Overview

The HEB Product Search Scraper extracts detailed product information from HEB.com search pages and product listings. It supports two flexible scraping modes:

1. URL-based scraping — Paste direct HEB search URLs (with filters pre-applied)
2. Search filter-based scraping — Define keywords, price ranges, and sorting preferences

This scraper is ideal for:

• Retail analysts monitoring competitor pricing and assortment
• Market researchers studying grocery e-commerce trends
• Price comparison platforms building datasets for shopping aggregators
• Inventory managers tracking product availability across categories
• Business intelligence teams benchmarking product lineups and promotions

Key strengths include configurable item limits, flexible search and filter options, graceful handling of URL failures, and pagination support.

---

Input Format

The scraper accepts a JSON configuration object with two modes:

Mode 1: Scrape by URLs

{
  "urls": [
    "https://www.heb.com/search?filter=price%3A0%7C999&q=meat&sortBy=PRICE&sortDirection=ASC"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 200
}

Field	Description
urls	Array of HEB.com search result URLs with pre-applied filters
ignore_url_failures	If true, continues scraping if some URLs fail
max_items_per_url	Maximum products to extract per URL (e.g., 200)

Use this mode when: You already have specific search URLs prepared with your desired filters applied.

Mode 2: Scrape by Search Filters

{
  "keyword": "meat",
  "sort_by": "PRICE",
  "price_range": "0-999",
  "page": 1,
  "max_items_per_url": 200,
  "ignore_url_failures": true
}

Field	Description	Options
keyword	Search term (e.g., "meat", "organic milk")	Any product keyword
sort_by	Sort order for results	SCORE (Best Match), PRICE, PRODUCT_NAME
price_range	Price filter in cents (e.g., "0-999" = $0–$9.99)	0-999, 1000-1999, 2000-2999, etc. up to 15000-15999
page	Starting page number (1-based pagination)	Integer ≥ 1
max_items_per_url	Maximum products per page	Integer
ignore_url_failures	Continue if pagination fails	true or false

Use this mode when: You want to define search criteria and let the scraper generate URLs and paginate automatically.

Tip: Price ranges are in cents. For example, 0-999 = $0–$9.99, and 2000-2999 = $20–$29.99.

---

Output Format

Sample output

{
  "id": "312964",
  "store_id": 92,
  "shopping_context": "EXPLORE_MY_STORE",
  "display_name": "Hill Country Fare Ground Beef, 73% Lean",
  "decoded_display_name": "Hill Country Fare Ground Beef, 73% Lean, 3 lb",
  "full_display_name": "Hill Country Fare Ground Beef, 73% Lean, 3 lb",
  "full_category_hierarchy": "Meat & seafood/Meat/Beef",
  "minimum_order_quantity": 1,
  "maximum_order_quantity": 20,
  "best_available": false,
  "on_ad": false,
  "is_new": false,
  "priced_by_weight": false,
  "show_coupon_flag": false,
  "in_assortment": true,
  "is_ebt_snap_product": true,
  "product_description": "Before your next backyard BBQ, pick up some Hill Country Fare ground beef. Great for making burgers, it has a 73% lean/27% fat ratio, which means all you can taste is rich beefy juiciness. You can also use some for other hamburger-based recipes, like meatloaf, meatballs, chili and more.<br><br>&bull; Ground beef<br>&bull; 73% lean/27% fat<br>&bull; Great for making juicy burgers and more",
  "product_location": {
    "location": "In Meat Market on the Right Wall",
    "__typename": "ProductLocation"
  },
  "past_purchase_info": null,
  "purchase_preference_list": null,
  "inventory": {
    "inventory_state": "IN_STOCK",
    "__typename": "Inventory"
  },
  "brand": {
    "name": "Hill Country Fare",
    "is_own_brand": true,
    "__typename": "Brand"
  },
  "product_category": {
    "id": "490023",
    "name": "Meat & seafood",
    "__typename": "ProductCategory"
  },
  "product_image_urls": [
    {
      "url": "https://images.heb.com/is/image/HEBGrocery/prd-small/000312964.jpg",
      "size": "SMALL",
      "__typename": "Image"
    },
    {
      "url": "https://images.heb.com/is/image/HEBGrocery/prd-medium/000312964.jpg",
      "size": "MEDIUM",
      "__typename": "Image"
    },
    {
      "url": "https://images.heb.com/is/image/HEBGrocery/prd-large/000312964.jpg",
      "size": "LARGE",
      "__typename": "Image"
    }
  ],
  "carousel_image_urls": [
    "https://images.heb.com/is/image/HEBGrocery/000312964-1",
    "https://images.heb.com/is/image/HEBGrocery/000312964-2"
  ],
  "product_page_url": null,
  "skus": null,
  "product_placement_context": null,
  "analytics_product_properties": {
    "is_cross_sell": false,
    "is_every_day_low_price": false,
    "is_limited_time_offer": false,
    "is_own_brand_upsell": false,
    "placement_strategy": null,
    "__typename": "AnalyticsProductProperties"
  },
  "availability": {
    "schedule": null,
    "unavailability_reasons": [],
    "__typename": "Availability"
  },
  "from_url": "https://www.heb.com/search?q=meat"
}

Each scraped product returns a comprehensive record with 30+ fields:

Product Identity & Display

Field	Meaning
ID	Unique HEB product identifier
Display Name	Product name as shown on the listing page
Decoded Display Name	Clean, URL-decoded version of the product name
Full Display Name	Complete product name including size/variant
SKUs	Stock Keeping Unit(s) for inventory tracking
Brand	Manufacturer or distributor brand name

Categorization & Location

Field	Meaning
Product Category	Primary product category (e.g., "Meat & Seafood")
Full Category Hierarchy	Complete path from store section to sub-category
Shopping Context	Aisle or department context for in-store shopping
Store ID	HEB store identifier where item is available
Product Location	Physical location info for in-store pickup or delivery

Pricing & Purchasing

Field	Meaning
Price	Current retail price (extracted from product data)
Price Range	Min-max price if product has variants
Priced By Weight	Boolean flag: true if price varies by weight (e.g., deli meat)
Minimum Order Quantity	Lowest quantity allowed per purchase
Maximum Order Quantity	Highest quantity allowed per order
Show Coupon Flag	true if digital coupons are available

Availability & Inventory

Field	Meaning
Availability	Stock status (e.g., "In Stock", "Out of Stock", "Limited Availability")
Best Available	Boolean: true if item is a preferred/best-selling option
In Assortment	true if item is part of HEB's regular assortment
Inventory	Stock level or availability details

Product Details & Descriptions

Field	Meaning
Product Description	Full HTML product description and attributes
Product Page URL	Direct link to the product detail page on HEB.com
Is New	Boolean: true if this is a newly added product
Is EBT SNAP Product	true if eligible for SNAP/EBT payment

Visual & Media Assets

Field	Meaning
Product Image URLs	Array of product image URLs for e-commerce display
Carousel Image URLs	Additional carousel images from the listing

Additional Metadata

Field	Meaning
On Ad	true if product is featured in current promotions
Past Purchase Info	Customer purchase history flags
Purchase Preference List	Whether item is on a saved list or watch list
Product Placement Context	Merchandising context (e.g., promoted, featured)
Analytics Product Properties	Internal tracking attributes for HEB analytics

---

How to Use

Method 1: URL-Based Scraping

1. Find search results — Navigate to HEB.com and search for products. Apply filters (price, category, etc.) as needed.
2. Copy the URL — Once filters are set, copy the full URL from the address bar.
3. Paste URLs — Enter URLs in the urls array of your configuration.
4. Set max items — Choose max_items_per_url (e.g., 200 for full coverage).
5. Run the scraper — Start the run and monitor progress.

Method 2: Search Filter Scraping

1. Define your search — Choose a keyword (e.g., "meat", "organic milk").
2. Apply filters — Select sort_by option and price_range if desired.
3. Set pagination — Specify starting page and max_items_per_url.
4. Enable error handling — Set ignore_url_failures: true for continuous pagination.
5. Run the scraper — The scraper generates URLs automatically and paginates.

Common tips:

• Price ranges are in cents; check the enumTitles mapping for dollar equivalents.
• For bulk data collection, set max_items_per_url to 200 for maximum coverage per page.
• URL-based mode is faster for targeted scrapes; filter mode is ideal for exploratory research.

---

Use Cases & Business Value

• Price monitoring — Track HEB product prices over time to detect promotions and trends
• Competitor intelligence — Monitor what products HEB stocks versus other retailers
• Assortment analysis — Understand which brands and categories HEB emphasizes
• Inventory insights — Correlate product availability with demand signals
• Shopping aggregators — Feed HEB product data into price comparison platforms
• Academic research — Study retail pricing strategies and product placement

The HEB Product Search Scraper eliminates hours of manual data collection, delivering machine-readable product records that integrate directly into spreadsheets, databases, or data science workflows.

---

Conclusion

The HEB Product Search Scraper is a powerful solution for anyone needing structured grocery product data from one of the largest US supermarket chains. Whether you choose URL-based or filter-based scraping, you'll unlock 30+ fields of actionable product intelligence — from pricing and availability to images and category hierarchies. Start a run today and transform HEB's product catalog into insights.