H-E-B+API.SH

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
H-E-B product search
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}
1 credit · $1 per 1,000 calls

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 category/heb/v1/category
category_id490016nameDairy & eggsstore_id92sortrelevancecount30page1
breadcrumbs[]title · urlPath · categoryId · __typename
items[]product_id · sku · name · brand · own_brand · url · image · price · prices · size · store_id · stock
H-E-B product/heb/v1/product
product_id325141sku4122097159nameHill Country Fare Grade A Extra …brandHill Country Fareown_brandtrueurlhttps://www.heb.com/product-deta…imagehttps://images.heb.com/is/image/…price2.76size18 ctstore_id92stockIN_STOCKaisleIn Dairy on the Back Wallon_adfalsecouponfalsenewfalsesnaptruedescriptionWhen you need a dozen and a half…upc041220971596
prices[]online · curbside
nutrition[]servingsPerContainer · servingSize · calories · caloriesFromFat · nutrients · vitaminsAndMinerals · labelModifier · __typename
lifestyles[]formattedName · description · imageUrl · __typename
availability[]schedule · unavailabilityReasons · __typename
H-E-B product search/heb/v1/search
queryeggsstore_id92sortrelevancetotal79count60page1next_page2
items[]product_id · sku · name · brand · own_brand · url · image · price · prices · size · store_id · stock
filters[]id · label · multiple · options
categories[]id · name · count · url
suggested[]text · highlighted · reason · __typename

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

Search and discovery1
H-E-B product search
/heb/v1/search
params q +4 optionaldocstry
$1 · $2 PAYG
1 credit
Products, listings and places1
H-E-B product
/heb/v1/product
params product_id +1 optionaldocstry
$1 · $2 PAYG
1 credit
More data2
H-E-B category
/heb/v1/category
params category_id +4 optionaldocstry
$1 · $2 PAYG
1 credit
H-E-B store finder
/heb/v1/stores
params address +1 optionaldocstry
$1 · $2 PAYG
1 credit

Call the H-E-B API

H-E-B product search: GET https://api.api.sh/heb/v1/search

curl "https://api.api.sh/heb/v1/search?q=eggs" \
  -H "x-api-key: $APISH_KEY"
  1. Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
  2. Create an API keyOne key works for all 918 platforms.
  3. Send the requestJSON back in one call. Add output=csv or output=ndjson for 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.

More e-commerce APIs all e-commerce APIs →

Start with 1,000 free credits
Every month, on every account. One key works for all 918 platforms.
Get a free API key