Walgreens Product Data API - Prices, Store Stock, Stores
Walgreens product data as structured JSON - search walgreens.com retail products with regular and sale price, unit price, promotions, coupons, rewards and rebates, read one product with UPC, ingredients, warnings and offers, find Walgreens and Duane Reade stores near a ZIP, and check live unit counts of one product at up to 20 stores in one call. 4 endpoints; search, product and stores 2 credits, stock 4.
Walgreens via Scavio
Search Walgreens retail products (health, beauty, household, grocery; nothing pharmacy) with regular and sale price, unit price, promotion, coupon, rewards and rebate messages, rating and review count, up to 70 per page. Read one product with UPC, ingredients, warnings and its current offers. Find Walgreens and Duane Reade stores near a ZIP, and check live unit counts of one product at up to 20 stores in a single call. All endpoints return structured JSON.
When to trigger
Use this skill when the user asks to:
- Find health, beauty, personal care or household items at Walgreens by keyword
- Check a Walgreens product's price, sale price, unit price, or the coupons and rewards on it
- Check whether nearby Walgreens stores have an item in stock, and how many units each has
- Find Walgreens or Duane Reade stores near a ZIP code or coordinates
- Read a product's ingredients, warnings or UPC
- List what is on sale or on clearance in a search
- Compare Walgreens prices with CVS or other retailers, or monitor them
Setup
Get a free API key at scavio.dev (50 free credits to get started, no card required):
export SCAVIO_API_KEY=sk_live_your_key
If you do not have a key yet
An agent running this skill without SCAVIO_API_KEY set will get 401 on every
call below. The whole path from nothing to a working key is self-serve:
- Sign up at dashboard.scavio.dev - email or Google, no card required.
- A key is created for the account automatically at signup. It is on the dashboard under API Keys, ready to copy.
- A new account starts with 50 credits. Search, product and stores cost 2 credits each; stock costs 4.
When the balance runs out the API answers 402 with a JSON body carrying
billing_url. Topping up needs no code change - the same key keeps working.
Every request is a POST with a JSON body and:
Authorization: Bearer $SCAVIO_API_KEY
Endpoints
Base URL: https://api.scavio.dev.
| Endpoint | Credits | What it returns |
|---|---|---|
POST /api/v1/walgreens/search | 2 | Up to 70 products per page: product id, SKU, UPC, name, brand, size, regular and sale price, multi-buy text, unit price, promotion, coupon, rewards and rebate messages, rating, review count, image, URL, ship / pickup / delivery availability, online stock status, clearance flag |
POST /api/v1/walgreens/product | 2 | One product by id or URL: SKU, UPC, GTIN, name, brand, size, regular and sale price, savings, unit price, offers (rewards and rebates with dates), description, ingredients, warnings, rating, review count, categories, images, ship and pickup availability, FSA eligibility, clearance flag |
POST /api/v1/walgreens/stores | 2 | Walgreens and Duane Reade stores near a ZIP or coordinates, nearest first: store number, name, brand, address, phone, coordinates, distance, opening and closing time, time zone and store page URL, paged |
POST /api/v1/walgreens/stock | 4 | Live in-store stock of one product at up to 20 stores: per store the status (In Stock, Out of Stock, Not Available), unit count and in_stock. Unrecognized store numbers are listed in unknown_store_ids |
Workflow
- Find the product: call
/walgreens/searchwithquery. Each row has aproduct_id. - One product in full: call
/walgreens/productwith theproduct_idfor offers, ingredients and warnings. - Nearby stores: call
/walgreens/storeswith the user'szip. Each row has astore_number. - Who has it: call
/walgreens/stockwith theproduct_idand up to 20store_ids(thestore_numbervalues). One call covers every store.
Parameters
Search (/search)
| Parameter | Type | Default | Description |
|---|---|---|---|
query | string | required | Keywords (1-200 chars) |
page | integer | 1 | 1-based page (1-100), up to 70 results per page |
sort | string | relevance | relevance, top_sellers, price_low_to_high, price_high_to_low, unit_price_low_to_high, brand_name_asc, brand_name_desc, most_reviewed, highest_rated, most_viewed or newest_arrival |
store_id | string | - | Store number from /stores. Each row's availability.text then describes that store ("Not sold at your store") |
Product (/product)
| Parameter | Type | Default | Description |
|---|---|---|---|
product_id | string | required | Walgreens product id, a search row's product_id ("300452904" or "prod6345045"), or a walgreens.com product URL |
Stores (/stores)
| Parameter | Type | Default | Description |
|---|---|---|---|
zip | string | one of | US ZIP code to search around |
latitude, longitude | number | one of | Coordinates to search around, instead of zip |
radius | number | 25 | Search radius in miles, 1-100 |
page | integer | 1 | 1-based page (1-100) |
limit | integer | 10 | Stores per page, 1-25 |
Stock (/stock)
| Parameter | Type | Default | Description |
|---|---|---|---|
product_id | string | required | Product id or walgreens.com product URL |
store_ids | string[] | required | 1-20 store numbers, the store_number values from /stores |
Examples
curl -X POST https://api.scavio.dev/api/v1/walgreens/stock \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"product_id": "300452904", "store_ids": ["15350", "15992", "249", "178", "1173"]}'
Captured response (Walgreens shampoo at five Chicago stores):
{
"data": {
"product_id": "300452904",
"article_id": "000000000012456764",
"planogram": "40000735502",
"count": 5,
"in_stock_count": 5,
"stores": [
{ "store_number": "15350", "status": "In Stock", "quantity": 3, "in_stock": true },
{ "store_number": "15992", "status": "In Stock", "quantity": 5, "in_stock": true },
{ "store_number": "249", "status": "In Stock", "quantity": 3, "in_stock": true },
{ "store_number": "178", "status": "In Stock", "quantity": 3, "in_stock": true },
{ "store_number": "1173", "status": "In Stock", "quantity": 1, "in_stock": true }
],
"unknown_store_ids": []
},
"response_time": 2263,
"credits_used": 4
}
A captured /search row for {"query": "shampoo", "store_id": "15350"} (image trimmed):
{
"position": 1,
"product_id": "300452904",
"sku_id": "400675110",
"upc": "19560214708",
"name": "Walgreens Shiny & Smooth Shampoo",
"brand": "Walgreens",
"product_name": "Shiny & Smooth Shampoo",
"size": "33.8 fl oz",
"product_type": "Shampoo",
"price": 4.99,
"sale_price": 3.74,
"sale_text": null,
"on_sale": true,
"unit_price": null,
"unit_price_size": null,
"promotion": null,
"coupon": null,
"loyalty_message": "Earn $10 rewards on $30+ spent on select Walgreens brands*",
"rebate": "Extra 15% off $35+ eligible items sitewide* with code NOV15 or 20% off $50+ eligible items sitewide* with code NOV20",
"rating": 4,
"review_count": 90,
"url": "https://www.walgreens.com/store/c/walgreens-shiny-%26-smooth-shampoo/ID=300452904-product",
"availability": { "ship": true, "pickup": false, "delivery": false, "text": "In stock but not available for pickup" },
"online_stock_status": "In Stock",
"clearance": false,
"article_id": "000000000012456764",
"planogram": "40000735502"
}
import requests
BASE = "https://api.scavio.dev"
# Your key from https://scavio.dev. Load it from your environment or secret
# store in real code - keep it out of source control.
API_KEY = "sk_your_key_here"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
def wag(endpoint, body):
r = requests.post(f"{BASE}/api/v1/walgreens/{endpoint}", headers=HEADERS, json=body, timeout=120)
r.raise_for_status()
return r.json()["data"]
# 1. Find the product (2 credits)
row = wag("search", {"query": "shampoo", "sort": "top_sellers"})["products"][0]
print(row["name"], row["price"], "sale", row["sale_price"], row["promotion"], row["coupon"])
# 2. The 20 nearest stores (2 credits)
stores = wag("stores", {"zip": "60614", "limit": 20})["stores"]
by_number = {s["store_number"]: s for s in stores}
# 3. Units at all 20 in one call (4 credits)
stock = wag("stock", {"product_id": row["product_id"], "store_ids": list(by_number)})
for s in stock["stores"]:
if s["in_stock"]:
st = by_number[s["store_number"]]
print(st["address"]["street"], st["distance_miles"], "mi:", s["quantity"], "units")
Response shapes
Every response uses the envelope { data, response_time, fetched_at, credits_used, credits_remaining }. Nothing is cached; fetched_at is when Walgreens answered.
- search -
query,page,sort,store_id,total_results,total_pages,count,products[](position,product_id,sku_id,upc,name,brand,product_name,size,product_type,price,sale_price,sale_text,on_sale,unit_price,unit_price_size,promotion,coupon,loyalty_message,rebate,rating,review_count,image,url,availability{ship,pickup,delivery,text},online_stock_status,clearance,article_id,planogram). - product -
product_id,sku_id,upc,gtin,name,display_name,brand,size,product_type,walgreens_brand,price,sale_price,sale_text,on_sale,unit_price,unit_price_size,promotion,savings_amount,savings_percent,loyalty_message,rebate,offers[]{type,title,headline,details,description,link_text,start_date,end_date},clearance,store_pricing,description,ingredients[]{group,type,ingredients[]},warnings,rating,review_count,categories[]{id,name,url},images[],ship_available,pickup_available,ship_message,fsa_eligible,article_id,planogram,url. - stores -
zip,latitude,longitude,radius_miles,page,total_results,total_pages,has_more,count,stores[](store_number,name,brand,address{street,city,state,zip,intersection},phone,latitude,longitude,distance_miles,open_time,close_time,time_zone,temporarily_closed,url). - stock -
product_id,article_id,planogram,count,in_stock_count,stores[](store_number,status,quantity,in_stock),unknown_store_ids[].
Guardrails
- Prices are in dollars and national:
4.99is $4.99 at every store.store_pricingis false on every product, and no endpoint takes a store for price, so never claim a store-specific price. priceis the regular price;sale_priceis the single-unit sale price. A multi-buy deal keeps its text insale_text("2/$12.00 or 1/$6.99").on_salemeans a sale price below the regular price.promotion,coupon,loyalty_messageandrebateare the site's own text; quote them as written and do not compute a final price from them./storesreturnsstore_number; pass those values asstore_id(search) andstore_ids(stock)./stockquantities are live units at each store.status"Not Available" means the store does not carry the product, which is different from "Out of Stock". A store number Walgreens does not recognize lands inunknown_store_ids.- Without
store_idon search,availability.textreads "Store inventory unavailable". Use/stockfor real counts. - Retail only: prescriptions and pharmacy services are not covered.
- Never fabricate prices, stock or offers. Only return what the API returned, with the product
url.
Failure handling
400means a missing or invalid parameter (noqueryorproduct_id, an unknownsort, a ZIP that is not 5 digits, neitherzipnor coordinates on/stores,limitabove 25, or more than 20store_ids).401means the API key is invalid or missing. CheckSCAVIO_API_KEY.402means the balance is out of credits. The body carriesbilling_url.404on/productor/stockmeans no such product, or Walgreens does not report store stock for it; use aproduct_idfrom search. Not charged.429means rate or usage limit exceeded. Wait before retrying. See rate limits.502means Walgreens is temporarily unavailable. It is not charged; retry after a few seconds.
SDKs
pip install scavio==0.32.0
npm install scavio@0.32.0
import { Scavio } from "scavio";
const scavio = new Scavio(); // reads SCAVIO_API_KEY
const { data: found } = await scavio.walgreens.search({ query: "shampoo", sort: "price_low_to_high" });
const item = await scavio.walgreens.product({ product_id: found.products[0].product_id });
const { data: near } = await scavio.walgreens.stores({ zip: "60614", limit: 20 });
const stock = await scavio.walgreens.stock({
product_id: found.products[0].product_id,
store_ids: near.stores.map((s) => s.store_number),
});
MCP: the Scavio MCP server exposes all 4 endpoints as tools (search_walgreens, get_walgreens_product, get_walgreens_stores, get_walgreens_stock). Walgreens is opt-in: add walgreens to SCAVIO_PLATFORMS.
{
"mcpServers": {
"scavio": {
"command": "npx",
"args": ["-y", "@scavio/mcp-server@0.30.0"],
"env": {
"SCAVIO_API_KEY": "sk_live_your_key",
"SCAVIO_PLATFORMS": "default,walgreens"
}
}
}
}
Docs
Full reference per endpoint: search, product, stores, stock. Overview: Walgreens API.
Related skills
- Downloads
- 96All time
- Security audit
- Pass
- Last updated
- 2w ago
- Current version
- v1.0.0
- License
- MIT-0
