访问 H-E-B 的结构化杂货、类别、产品和商店数据以推动超市搜索、类别浏览、与商店相关的产品发现、目录丰富和杂货智能工作流程 此 API 有助于购物应用程序、零售数据团队和商业运营商搜索实时 H-E-B 产品、检查过滤器、浏览货架，并处理与商店相关的产品上下文
在 Postman 中运行
{
"status": "success",
"source": "heb_us",
"build_id": "e964318c0df074d1dce66c04b81596c9b119c626",
"query": "New Jersey",
"total": 5,
"results": [
{
"id": 694,
"name": "New Braunfels H-E-B plus!",
"address1": "2965 IH35 NORTH",
"city": "NEW BRAUNFELS",
"state": "TX",
"postal_code": "78130-4678",
"latitude": 29.731,
"longitude": -98.0782,
"phone": "+18303125700",
"hours": [
{
"day": "MONDAY",
"opens": "06:00",
"closes": "23:00"
},
{
"day": "TUESDAY",
"opens": "06:00",
"closes": "23:00"
},
{
"day": "WEDNESDAY",
"opens": "06:00",
"closes": "23:00"
},
{
"day": "THURSDAY",
"opens": "06:00",
"closes": "23:00"
},
{
"day": "FRIDAY",
"opens": "06:00",
"closes": "23:00"
},
{
"day": "SATURDAY",
"opens": "06:00",
"closes": "23:00"
},
{
"day": "SUNDAY",
"opens": "06:00",
"closes": "23:00"
}
],
"fulfillments": [
"ALCOHOL_DELIVERY",
"CURBSIDE_DELIVERY",
"CURBSIDE_PICKUP",
"DELIVERY_TO_HOME",
"PICK_UP_IN_STORE"
],
"distance_miles": 0,
"pharmacy_store": true
},
{
"id": 775,
"name": "New Braunfels H-E-B at Walnut",
"address1": "651 S.WALNUT",
"city": "NEW BRAUNFELS",
"state": "TX",
"postal_code": "78130-5722",
"latitude": 29.68903,
"longitude": -98.12631,
"phone": "+18306080017",
"hours": [
{
"day": "MONDAY",
"opens": "06:00",
"closes": "23:00"
},
{
"day": "TUESDAY",
"opens": "06:00",
"closes": "23:00"
},
{
"day": "WEDNESDAY",
"opens": "06:00",
"closes": "23:00"
},
{
"day": "THURSDAY",
"opens": "06:00",
"closes": "23:00"
},
{
"day": "FRIDAY",
"opens": "06:00",
"closes": "23:00"
},
{
"day": "SATURDAY",
"opens": "06:00",
"closes": "23:00"
},
{
"day": "SUNDAY",
"opens": "06:00",
"closes": "23:00"
}
],
"fulfillments": [
"ALCOHOL_DELIVERY",
"CURBSIDE_DELIVERY",
"CURBSIDE_PICKUP"
],
"distance_miles": 4.082978109984235,
"pharmacy_store": true
},
{
"id": 74,
"name": "New Braunfels H-E-B at Hwy 46",
"address1": "1655 W STATE HIGHWAY 46",
"city": "NEW BRAUNFELS",
"state": "TX",
"postal_code": "78130-4753",
"latitude": 29.71304,
"longitude": -98.16039,
"phone": "+18306260937",
"hours": [
{
"day": "MONDAY",
"opens": "06:00",
"closes": "23:00"
},
{
"day": "TUESDAY",
"opens": "06:00",
"closes": "23:00"
},
{
"day": "WEDNESDAY",
"opens": "06:00",
"closes": "23:00"
},
{
"day": "THURSDAY",
"opens": "06:00",
"closes": "23:00"
},
{
"day": "FRIDAY",
"opens": "06:00",
"closes": "23:00"
},
{
"day": "SATURDAY",
"opens": "06:00",
"closes": "23:00"
},
{
"day": "SUNDAY",
"opens": "06:00",
"closes": "23:00"
}
],
"fulfillments": [
"ALCOHOL_DELIVERY",
"CURBSIDE_DELIVERY",
"CURBSIDE_PICKUP",
"DELIVERY_TO_HOME",
"PICK_UP_IN_STORE"
],
"distance_miles": 5.074188101470844,
"pharmacy_store": true
},
{
"id": 455,
"name": "West Hopkins H-E-B",
"address1": "200 WEST HOPKINS ST.",
"city": "SAN MARCOS",
"state": "TX",
"postal_code": "78666-5615",
"latitude": 29.88305,
"longitude": -97.94292,
"phone": "+15123960100",
"hours": [
{
"day": "MONDAY",
"opens": "06:00",
"closes": "23:00"
},
{
"day": "TUESDAY",
"opens": "06:00",
"closes": "23:00"
},
{
"day": "WEDNESDAY",
"opens": "06:00",
"closes": "23:00"
},
{
"day": "THURSDAY",
"opens": "06:00",
"closes": "23:00"
},
{
"day": "FRIDAY",
"opens": "06:00",
"closes": "23:00"
},
{
"day": "SATURDAY",
"opens": "06:00",
"closes": "23:00"
},
{
"day": "SUNDAY",
"opens": "06:00",
"closes": "23:00"
}
],
"fulfillments": [
"PICK_UP_IN_STORE"
],
"distance_miles": 13.242741268698406,
"pharmacy_store": true
},
{
"id": 716,
"name": "Seguin H-E-B",
"address1": "1340 E COURT ST",
"city": "SEGUIN",
"state": "TX",
"postal_code": "78155-5131",
"latitude": 29.57075,
"longitude": -97.94462,
"phone": "+18303798384",
"hours": [
{
"day": "MONDAY",
"opens": "06:00",
"closes": "23:00"
},
{
"day": "TUESDAY",
"opens": "06:00",
"closes": "23:00"
},
{
"day": "WEDNESDAY",
"opens": "06:00",
"closes": "23:00"
},
{
"day": "THURSDAY",
"opens": "06:00",
"closes": "23:00"
},
{
"day": "FRIDAY",
"opens": "06:00",
"closes": "23:00"
},
{
"day": "SATURDAY",
"opens": "06:00",
"closes": "23:00"
},
{
"day": "SUNDAY",
"opens": "06:00",
"closes": "23:00"
}
],
"fulfillments": [
"ALCOHOL_DELIVERY",
"CURBSIDE_DELIVERY",
"CURBSIDE_PICKUP",
"DELIVERY_TO_HOME",
"PICK_UP_IN_STORE"
],
"distance_miles": 13.642031823722933,
"pharmacy_store": true
}
]
}
curl --location --request GET 'https://zylalabs.com/api/12513/h-e-b+us+grocery+api/23830/search+h-e-b+us+stores?query=New Jersey&limit=25' --header 'Authorization: Bearer YOUR_API_KEY'
{
"status": "success",
"source": "heb_us",
"build_id": "e964318c0df074d1dce66c04b81596c9b119c626",
"store_id": 92,
"query": "juice",
"page": 1,
"limit": 10,
"total": 774,
"result_count": 10,
"total_pages": 78,
"items": [
{
"id": "625413",
"sku": "8768400110",
"slug": "/product-detail/capri-sun-100-fruit-punch-juice-blend-10-pk-pouches-6-oz/625413",
"name": "Capri Sun 100% Fruit Punch Juice Blend 10 pk Pouches, 6 oz",
"brand": "Capri Sun",
"barcode": "087684001103",
"source_url": "https://www.heb.com/product-detail/capri-sun-100-fruit-punch-juice-blend-10-pk-pouches-6-oz/625413",
"price": 4.46,
"effective_price": 4.46,
"currency": "USD",
"size": "6 oz",
"unit": "oz",
"unit_quantity": 6,
"price_per_unit_price": 0.07,
"price_per_unit_quantity": 1,
"price_per_unit_unit": "fl oz",
"category": "Juice",
"breadcrumbs": [
"Beverages",
"Juice"
],
"image": "https://images.heb.com/is/image/HEBGrocery/prd-large/000625413.jpg",
"images": [
"https://images.heb.com/is/image/HEBGrocery/prd-large/000625413.jpg",
"https://images.heb.com/is/image/HEBGrocery/prd-medium/000625413.jpg",
"https://images.heb.com/is/image/HEBGrocery/prd-small/000625413.jpg",
"https://images.heb.com/is/image/HEBGrocery/000625413-1",
"https://images.heb.com/is/image/HEBGrocery/000625413-10",
"https://images.heb.com/is/image/HEBGrocery/000625413-2",
"https://images.heb.com/is/image/HEBGrocery/000625413-3",
"https://images.heb.com/is/image/HEBGrocery/000625413-4",
"https://images.heb.com/is/image/HEBGrocery/000625413-5",
"https://images.heb.com/is/image/HEBGrocery/000625413-6",
"https://images.heb.com/is/image/HEBGrocery/000625413-7",
"https://images.heb.com/is/image/HEBGrocery/000625413-8",
"https://images.heb.com/is/image/HEBGrocery/000625413-9"
],
"availability": [
"IN_STORE",
"CURBSIDE_DELIVERY",
"CURBSIDE_PICKUP"
],
"stock_status": "IN_STOCK",
"in_stock": true,
"store_id": 92,
"location": "Aisle 13",
"coupon_available": false,
"on_ad": false
},
{
"id": "3910521",
"sku": "8768401036",
"slug": "/product-detail/capri-sun-juice-drink-blend-30-pk-pouches-variety-pack-6-oz/3910521",
"name": "Capri Sun Juice Drink Blend 30 pk Pouches - Variety Pack, 6 oz",
"brand": "Capri Sun",
"barcode": "087684010365",
"source_url": "https://www.heb.com/product-detail/capri-sun-juice-drink-blend-30-pk-pouches-variety-pack-6-oz/3910521",
"price": 9.47,
"effective_price": 9.47,
"currency": "USD",
"size": "6 oz",
"unit": "oz",
"unit_quantity": 6,
"price_per_unit_price": 0.05,
"price_per_unit_quantity": 1,
"price_per_unit_unit": "oz",
"category": "Juice",
"breadcrumbs": [
"Beverages",
"Juice"
],
"image": "https://images.heb.com/is/image/HEBGrocery/prd-large/003910521.jpg",
"images": [
"https://images.heb.com/is/image/HEBGrocery/prd-large/003910521.jpg",
"https://images.heb.com/is/image/HEBGrocery/prd-medium/003910521.jpg",
"https://images.heb.com/is/image/HEBGrocery/prd-small/003910521.jpg",
"https://images.heb.com/is/image/HEBGrocery/003910521-1",
"https://images.heb.com/is/image/HEBGrocery/003910521-2",
"https://images.heb.com/is/image/HEBGrocery/003910521-3",
"https://images.heb.com/is/image/HEBGrocery/003910521-4",
"https://images.heb.com/is/image/HEBGrocery/003910521-5"
],
"availability": [
"IN_STORE",
"CURBSIDE_PICKUP",
"CURBSIDE_DELIVERY"
],
"stock_status": "IN_STOCK",
"in_stock": true,
"store_id": 92,
"location": "Aisle 13",
"coupon_available": false,
"on_ad": false
},
{
"id": "2880001",
"sku": "4122070379",
"slug": "/product-detail/h-e-b-mi-tienda-manzana-apple-juice-box-6-75-oz/2880001",
"name": "H-E-B Mi Tienda Manzana Apple Juice Box, 6.75 oz",
"brand": "H-E-B Mi Tienda",
"barcode": "041220703791",
"source_url": "https://www.heb.com/product-detail/h-e-b-mi-tienda-manzana-apple-juice-box-6-75-oz/2880001",
"price": 0.4,
"effective_price": 0.4,
"currency": "USD",
"size": "6.75 oz",
"unit": "oz",
"unit_quantity": 6.75,
"price_per_unit_price": 0.06,
"price_per_unit_quantity": 1,
"price_per_unit_unit": "oz",
"category": "Juice",
"breadcrumbs": [
"Beverages",
"Juice"
],
"image": "https://images.heb.com/is/image/HEBGrocery/prd-large/002880001.jpg",
"images": [
"https://images.heb.com/is/image/HEBGrocery/prd-large/002880001.jpg",
"https://images.heb.com/is/image/HEBGrocery/prd-medium/002880001.jpg",
"https://images.heb.com/is/image/HEBGrocery/prd-small/002880001.jpg",
"https://images.heb.com/is/image/HEBGrocery/002880001-1"
],
"availability": [
"IN_STORE",
"CURBSIDE_PICKUP",
"CURBSIDE_DELIVERY"
],
"stock_status": "IN_STOCK",
"in_stock": true,
"store_id": 92,
"location": "Aisle 13",
"coupon_available": true,
"on_ad": false,
"promotion_type": "coupon",
"promotion_label": "Has coupon"
},
{
"id": "1564155",
"sku": "88949789442",
"slug": "/product-detail/juicy-juice-100-juice-variety-pack-32-pk-boxes-4-23-oz/1564155",
"name": "Juicy Juice 100% Juice Variety Pack 32 pk Boxes, 4.23 oz",
"brand": "Juicy Juice",
"barcode": "889497894428",
"source_url": "https://www.heb.com/product-detail/juicy-juice-100-juice-variety-pack-32-pk-boxes-4-23-oz/1564155",
"price": 9.97,
"effective_price": 9.97,
"currency": "USD",
"size": "4.23 oz",
"unit": "oz",
"unit_quantity": 4.23,
"price_per_unit_price": 0.31,
"price_per_unit_quantity": 1,
"price_per_unit_unit": "pack",
"category": "Juice",
"breadcrumbs": [
"Beverages",
"Juice"
],
"image": "https://images.heb.com/is/image/HEBGrocery/prd-large/001564155.jpg",
"images": [
"https://images.heb.com/is/image/HEBGrocery/prd-large/001564155.jpg",
"https://images.heb.com/is/image/HEBGrocery/prd-medium/001564155.jpg",
"https://images.heb.com/is/image/HEBGrocery/prd-small/001564155.jpg",
"https://images.heb.com/is/image/HEBGrocery/001564155-1",
"https://images.heb.com/is/image/HEBGrocery/001564155-2",
"https://images.heb.com/is/image/HEBGrocery/001564155-3",
"https://images.heb.com/is/image/HEBGrocery/001564155-4"
],
"availability": [
"IN_STORE",
"CURBSIDE_DELIVERY",
"CURBSIDE_PICKUP"
],
"stock_status": "IN_STOCK",
"in_stock": true,
"store_id": 92,
"location": "Aisle 13",
"coupon_available": false,
"on_ad": false
},
{
"id": "4925005",
"sku": "4300008024",
"slug": "/product-detail/kool-aid-jammers-variety-pack-30-pk-pouches-6-oz/4925005",
"name": "Kool-Aid Jammers Variety Pack 30 pk Pouches, 6 oz",
"brand": "Kool-Aid",
"barcode": "043000080245",
"source_url": "https://www.heb.com/product-detail/kool-aid-jammers-variety-pack-30-pk-pouches-6-oz/4925005",
"price": 8.27,
"effective_price": 8.27,
"currency": "USD",
"size": "6 oz",
"unit": "oz",
"unit_quantity": 6,
"price_per_unit_price": 0.28,
"price_per_unit_quantity": 1,
"price_per_unit_unit": "count",
"category": "Juice",
"breadcrumbs": [
"Beverages",
"Juice"
],
"image": "https://images.heb.com/is/image/HEBGrocery/prd-large/004925005.jpg",
"images": [
"https://images.heb.com/is/image/HEBGrocery/prd-large/004925005.jpg"
]
}
],
"_note": "Response truncated for documentation purposes"
}
curl --location --request GET 'https://zylalabs.com/api/12513/h-e-b+us+grocery+api/23833/search+h-e-b+us+products?query=juice&page=1&limit=10' --header 'Authorization: Bearer YOUR_API_KEY'
{
"status": "success",
"source": "heb_us",
"build_id": "e964318c0df074d1dce66c04b81596c9b119c626",
"store_id": 92,
"item": {
"id": "1122422",
"sku": "23851100000",
"slug": "/product-detail/h-e-b-simply-wrapped-cream-cheese-jalapeno-poppers/1122422",
"name": "H-E-B Simply Wrapped Cream Cheese Jalapeno Poppers",
"brand": "H-E-B",
"barcode": "238511000008",
"source_url": "https://www.heb.com/product-detail/h-e-b-simply-wrapped-cream-cheese-jalapeno-poppers/1122422",
"price": 8.79,
"effective_price": 8.79,
"currency": "USD",
"size": "Avg. 1.1 lbs",
"price_per_unit_price": 7.99,
"price_per_unit_quantity": 1,
"price_per_unit_unit": "lb",
"image": "https://images.heb.com/is/image/HEBGrocery/prd-medium/001122422.jpg",
"images": [
"https://images.heb.com/is/image/HEBGrocery/prd-medium/001122422.jpg",
"https://images.heb.com/is/image/HEBGrocery/prd-small/001122422.jpg",
"https://images.heb.com/is/image/HEBGrocery/001122422-1",
"https://images.heb.com/is/image/HEBGrocery/001122422-2"
],
"availability": [
"IN_STORE",
"CURBSIDE_PICKUP",
"CURBSIDE_DELIVERY"
],
"stock_status": "IN_STOCK",
"in_stock": true,
"store_id": 92,
"location": "In Meat Market on the Right Wall",
"coupon_available": false,
"on_ad": false,
"description": "Save big time when it's party time with these H-E-B Simply Wrapped jalapeño poppers. Stuffed with cream cheese and wrapped in bacon, they have a delicious crunch, an irresistible creaminess and a kick of heat. Ready to grill or bake, they're a made-in-Texas favorite that's perfect for game day or any day. • Jalapeño poppers • Stuffed with cream cheese • Wrapped in H-E-B bacon • Crunchy, creamy and slightly spicy • Ready to grill or bake • Great for entertaining",
"short_description": "Save big time when it's party time with these H-E-B Simply Wrapped jalapeño poppers. Stuffed with cream cheese and wrapped in bacon, they have a delicious crunch, an irresistible creaminess and a kick of heat. Ready to grill or bake, they're a made-in-Texas favorite that's perfect for game day or any day. • Jalapeño poppers • Stuffed with cream cheese • Wrapped in H-E-B bacon • Crunchy, creamy and slightly spicy • Ready to grill or bake • Great for entertaining",
"ingredients": "Smoked Bacon (Cured With: Water, Salt, Sugar, Sodium Phosphates, Sodium Erythorbate, Sodium Nitrite), JALAPEÑO Pepper, Cream Cheese (Pasteurized Milk, Pasteurized Cream, Cheese Culture, Salt, Stabilizers [Carob Bean And/Or Xanthan And/Or Guar Gums]).",
"safety_warning": "Keep Refrigerated. SAFE HANDLING. Contains: MILK",
"store": {
"id": 92,
"name": "Victoria H-E-B plus!",
"address1": "6106 N. NAVARRO",
"latitude": 28.85178,
"longitude": -96.99499
},
"variants": [
{
"id": "23851100000",
"barcode": "238511000008",
"size": "Avg. 1.1 lbs",
"availability": [
"IN_STORE",
"CURBSIDE_PICKUP",
"CURBSIDE_DELIVERY"
],
"price": 8.79,
"effective_price": 8.79,
"currency": "USD"
}
],
"availability_details": {
"__typename": "Availability"
},
"nutrition": [
{
"servingsPerContainer": "Varied",
"servingSize": "2 pieces (119g)",
"calories": "280",
"caloriesFromFat": "230",
"nutrients": [
{
"title": "Total Fat",
"fontModifier": "BOLD",
"unit": "26g",
"percentage": "40%",
"subItems": [
{
"title": "Saturated Fat",
"fontModifier": "PLAIN",
"unit": "11g",
"percentage": "55%",
"__typename": "DailyValueItemType"
},
{
"title": "Trans Fat",
"fontModifier": "ITALIC",
"unit": "0g",
"__typename": "DailyValueItemType"
}
],
"__typename": "DailyValueItemType"
},
{
"title": "Cholesterol",
"fontModifier": "BOLD",
"unit": "75mg",
"percentage": "25%",
"__typename": "DailyValueItemType"
},
{
"title": "Sodium",
"fontModifier": "BOLD",
"unit": "590mg",
"percentage": "25%",
"__typename": "DailyValueItemType"
},
{
"title": "Total Carbohydrate",
"fontModifier": "BOLD",
"unit": "4g",
"percentage": "1%",
"subItems": [
{
"title": "Dietary Fiber",
"fontModifier": "PLAIN",
"unit": "1g",
"percentage": "4%",
"__typename": "DailyValueItemType"
},
{
"title": "Total Sugars",
"fontModifier": "PLAIN",
"unit": "3g",
"__typename": "DailyValueItemType"
}
],
"__typename": "DailyValueItemType"
},
{
"title": "Protein",
"fontModifier": "BOLD",
"unit": "9g",
"__typename": "DailyValueItemType"
}
],
"vitaminsAndMinerals": [
{
"title": "Potassium",
"fontModifier": "PLAIN",
"unit": "115mg",
"percentage": "3%",
"__typename": "DailyValueItemType"
},
{
"title": "Vitamin A",
"fontModifier": "PLAIN",
"unit": "400mcg",
"percentage": "8%",
"__typename": "DailyValueItemType"
},
{
"title": "Calcium",
"fontModifier": "PLAIN",
"unit": "0mg",
"percentage": "0%",
"__typename": "DailyValueItemType"
},
{
"title": "Vitamin C",
"fontModifier": "PLAIN",
"unit": "40mg",
"percentage": "70%",
"__typename": "DailyValueItemType"
},
{
"title": "Iron",
"fontModifier": "PLAIN",
"unit": "0.8mg",
"percentage": "4%",
"__typename": "DailyValueItemType"
}
],
"labelModifier": "2 pieces (119g)",
"__typename": "NutritionLabelType"
}
]
}
}
curl --location --request GET 'https://zylalabs.com/api/12513/h-e-b+us+grocery+api/23836/get+h-e-b+us+product+by+url?url=https://www.heb.com/product-detail/h-e-b-simply-wrapped-cream-cheese-jalapeno-poppers/1122422' --header 'Authorization: Bearer YOUR_API_KEY'
注册后，每个开发者都会被分配一个个人 API 访问密钥，这是一个唯一的字母和数字组合，用于访问我们的 API 端点。要使用 H-E-B 美国杂货 API 进行身份验证，只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后，请查看上方的"您的 API 访问密钥"。
|
无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。
(年度计费可节省 2 个月 🎉)
每个端点返回与杂货商品、类别和商店信息相关的结构化数据 例如 "搜索 H-E-B 美国产品" 端点提供产品详细信息，如名称、品牌、价格和可用性，而 "获取 H-E-B 美国商店" 端点返回特定商店的详细信息，如地址、营业时间和提供的服务
关键字段因端点而异，但通常包括标识符（例如，产品 ID，商店 ID）、描述性属性（例如，名称，类别，品牌）、定价信息（例如，价格，有效价格）和可用性状态（例如，库存，交货选项）
参数根据终点不同而有所变化 例如终点“搜索H-E-B美国产品”接受关键字进行产品搜索 而终点“搜索H-E-B商店”允许按地址 城市或邮政编码过滤以定位商店
响应数据通常以JSON格式组织，顶层状态字段指示成功或失败，后面跟随相关的数据数组。例如，“搜索H-E-B美国商店”响应包括一个商店对象的列表，每个对象包含详细属性，如名称、地址和营业时间
数据直接来源于H-E-B的库存和商店系统，确保实时反映产品的可用性、价格和促销。这种直接集成有助于保持数据对用户的准确性和相关性
典型的使用案例包括构建食品杂货购物应用程序 提升零售数据分析以及创建个性化购物体验 开发人员可以使用API使用户能够根据他们的偏好搜索产品 定位商店并发现促销活动
用户可以通过利用特定于每个端点的各种参数来自定义请求。例如，在使用“浏览 H-E-B 美国类别”端点时，用户可以指定商店上下文以检索与特定位置相关的类别数据
当遇到部分或空结果时，用户应检查响应中的状态字段。如果状态指示成功但返回没有结果，可能是由于没有匹配项。在这种情况下，实现后备逻辑或用户通知可以增强用户体验
