+H-E-B API
Search H-E-B and pull products, store prices, aisle locations, nutrition and store details as clean JSON.
The API.SH H-E-B API turns the public H-E-B shop into structured JSON. Search by keyword or browse a category for any H-E-B store with the shop's filters and sorts, and get online and curbside prices, size, stock, aisle location and ad, coupon and SNAP flags. Pull a product's ingredients, nutrition labels, warnings, coupons and similar products, and find stores near an address with hours, fulfillment options and departments.
- 4 endpoints
- from $1 / 1,000 calls
- 1,000 free credits / month
- failed calls free
GET https://api.api.sh/heb/v1/ search
{"query": "eggs","store_id": 92,"sort": "relevance","applied_filters": [],"total": 79,"items": [{"product_id": "325141","sku": "4122097159","name": "Hill Country Fare Grade A Extra Large White Eggs, 18 ct","brand": "Hill Country Fare","own_brand": true,"url": "https://www.heb.com/product-detail/hill-country-fare-grade-a-extra-large-white-eggs-18-ct/325141","image": "https://images.heb.com/is/image/HEBGrocery/prd-large/000325141.jpg","price": 2.76,"prices": {"online": {"price": 2.76,"list_price": 2.76,"unit_price": 0.15,"unit": "ct","on_sale": false,"price_cut": false,"priced_by": "EACH"},"curbside": {"price": 2.9,"list_price": 2.9,"unit_price": 0.16,"unit": "ct","on_sale": false,"price_cut": false,"priced_by": "EACH"}},"size": "18 ct","store_id": 92,"stock": "IN_STOCK","aisle": "In Dairy on the Back Wall","category": "Dairy & eggs/Eggs & egg substitutes","on_ad": false,"coupon": false,"new": false,"snap": true,"priced_by_weight": false,"description": "When you need a dozen and a half, pick up some Hill Country Fare Grade A Extra Large White Eggs. Handy to always have on hand in your fridge…"},{"product_id": "313762","sku": "4122091168","name": "Hill Country Fare Grade A Large White Eggs, 12 ct","brand": "Hill Country Fare","own_brand": true,"url": "https://www.heb.com/product-detail/hill-country-fare-grade-a-large-white-eggs-12-ct/313762","image": "https://images.heb.com/is/image/HEBGrocery/prd-large/000313762.jpg","price": 1.67,"prices": {"online": {"price": 1.67,"list_price": 1.67,"unit_price": 0.14,"unit": "ct","on_sale": false,"price_cut": false,"priced_by": "EACH"},"curbside": {"price": 1.75,"list_price": 1.75,"unit_price": 0.15,"unit": "ct","on_sale": false,"price_cut": false,"priced_by": "EACH"}},"size": "12 ct","store_id": 92,"stock": "IN_STOCK","aisle": "In Dairy on the Back Wall","category": "Dairy & eggs/Eggs & egg substitutes","on_ad": false,"coupon": false,"new": false,"snap": true,"priced_by_weight": false,"description": "Pick up a dozen Hill Country Fare Grade A Large White Eggs. They’re useful for so many recipes or tasty on their own, scrambled, sunny-side-…"},"… 58 more"],"filters": [{"id": "savings","label": "Savings","multiple": true,"options": [{"value": "allsave","label": "All savings","count": 8,"selected": false,"filter": "savings:allsave"},{"value": "coupon","label": "Has coupon","count": 7,"selected": false,"filter": "savings:coupon"},"… 1 more"]},{"id": "brand","label": "Brand","multiple": true,"options": [{"value": "HEBOB","label": "All H-E-B brands","count": 46,"selected": false,"filter": "brand:HEBOB"},{"value": "H-E-B","label": "H-E-B","count": 11,"selected": false,"filter": "brand:H-E-B"},"… 26 more"]},"… 2 more"],"categories": [{"id": null,"name": "Dairy & eggs","count": 56,"url": null},{"id": null,"name": "Deli & prepared food","count": 28,"url": null}],"suggested": {"text": null,"highlighted": null,"reason": null,"__typename": "SuggestedText"},"count": 60,"page": 1,"next_page": 2,"cached": false,"credits_used": 1} What you can build with the H-E-B API
Texas grocery price tracking
Track online and curbside prices, ad and coupon flags for the same products across H-E-B stores.
Aisle and stock lookups
Get a product's aisle and stock status at a chosen store for shopping list and store navigation apps.
Nutrition and ingredient data
Collect ingredients, nutrition labels, warnings and lifestyle tags for diet and recipe apps.
Private-label research
Filter search to the H-E-B brand to compare own-brand assortment and prices against other brands.
Store finder data
List H-E-B stores near an address with hours, fulfillment options, pharmacy flag and department phones.
H-E-B data you get
Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.
H-E-B API endpoints and prices
Every H-E-B endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing
| H-E-B product search /heb/ | $1 · $2 PAYG 1 credit |
| H-E-B product /heb/ | $1 · $2 PAYG 1 credit |
| H-E-B category /heb/ | $1 · $2 PAYG 1 credit |
| H-E-B store finder /heb/ | $1 · $2 PAYG 1 credit |
Call the H-E-B API
H-E-B product search: GET https://api.api.sh/heb/
curl "https://api.api.sh/heb/v1/search?q=eggs" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/heb/v1/search",
params={"q": "eggs"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/heb/v1/search");
url.searchParams.set("q", "eggs");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); # Google Sheets (API.SH add-on)
=APISH("/heb/v1/search", "q", "eggs")
# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "H-E-B" and "H-E-B product search".
# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp - Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
- Create an API keyOne key works for all 918 platforms.
- Send the requestJSON back in one call. Add
output=csvoroutput=ndjsonfor files.
Why API.SH for H-E-B data
- Public data only: no H-E-B login, cookies or account needed
- One key and one response shape for H-E-B and 917 other platforms
- Built and maintained by API.SH, not third-party publishers
- Pay per call; errors on our side cost nothing
- No rate limits: run as many calls in parallel as you need
- Live status for every endpoint
API.SH vs the official H-E-B API
H-E-B shares data with its suppliers through a supplier portal, but it does not offer a public product API. API.SH returns public H-E-B product, price and store data as JSON with one key.
Instead of building an H-E-B scraper or relying on unofficial clients, API.SH gives you documented routes, one key and a fixed price per call.
H-E-B API questions
What H-E-B data can I get?+
Product search (/heb/v1/search), category browse (/heb/v1/category), one product with ingredients and nutrition (/heb/v1/product) and stores near an address (/heb/v1/stores).
How much does the H-E-B API cost?+
Every H-E-B endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.
Is there a free trial?+
Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /heb/v1/category at 1 credit each.
Is there an official H-E-B API?+
No public one. H-E-B shares data with suppliers through its supplier portal; API.SH returns the public shop data as JSON.
Do I need an H-E-B account or login?+
No. API.SH reads public H-E-B data only. No endpoint uses a login or anyone's account.
Do the HEB webservers provide a basic API?+
Not a public one for shoppers or developers. API.SH turns the public shop's product, price and store data into documented JSON endpoints.
Are prices store-specific?+
Yes. Pass store_id (from /heb/v1/stores) to get that store's prices, stock and aisles. Without it, results are for store 92.
How do I get started?+
Sign up at api.sh, copy your API key and call /heb/v1/search?q=eggs. The docs at https://api.sh/docs list every parameter; SDKs, Google Sheets, Zapier, Make, n8n and an MCP server (https://api.sh/mcp) use the same key.
Does the H-E-B API have a rate limit?+
No. API.SH puts no rate limit on your key: send as many H-E-B calls in parallel as you need and pay only for the calls that run. If H-E-B itself slows down, the call returns 503 with a retry-after header and is not charged.