HEB

HEB Search API

Search H-E-B products by keyword and get structured rows as JSON: price in cents, list price, sale flag, unit price, size, UPC, stock status, SNAP eligibility, category, aisle location and images. Costs 2 credits per request.

POST/api/v1/heb/search

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

querystringrequired

Keywords to search for, 1-200 characters.

Example: salsa verde

pageintegerdefault:1

Results page, 1-based.

Example: 2

page_sizeintegerdefault:30

Results per page, 1-60.

Example: 10

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

results = client.heb.search("salsa verde", page_size=10)

for item in results["data"]["results"]:
    sale = " (SALE)" if item["on_sale"] else ""
    print(item["name"], item["price"], item["unit_price"], sale)

Response

"query": "salsa verde",

"total_results": 87,

"page": 1,

"page_size": 2,

"response_time": 2841

}

HEB