CVS

CVS Search API

Search CVS front-store products (no pharmacy) and get each result's product_id and sku_id, regular and sale price, unit price, promotion, rating and review count, size, image, ExtraBucks Rewards and manufacturer coupons, and stock at one store: units in store, for pickup and for same-day delivery, plus online ship stock. Prices are in dollars and the same at every store. Without store_id the stock is store 7019's (New York). Costs 1 credit per request.

POST/api/v1/cvs/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

Search keywords, or a CVS item number. Up to 200 characters.

Example: toothpaste

store_idstring

CVS store number for the stock fields. Defaults to 7019 (150 East 42nd St, New York, NY 10017), and the response's store_id says which store was used. The store number is shown on every cvs.com store page ("Store ID: #7019") and in its URL (.../storeid=7019).

Example: 7019

pageinteger

Results page, 1-based, 1-100. Defaults to 1.

Example: 1

limitinteger

Results per page, 1-48. Defaults to 20.

Example: 20

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

res = client.cvs.search(query="toothpaste", store_id="7019")["data"]

for p in res["products"]:
    s = p["stock"]
    print(p["sku_id"], p["name"], p["sale_price"], "was", p["price"], "in store:", s["in_store"], "pickup:", s["pickup"])

Response

"query": "toothpaste",

"store_id": "7019",

"page": 1,

"limit": 20,

"total_results": 226,

"total_pages": 12,

"count": 20,

"did_you_mean": [],

"response_time": 5241

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") res = client.cvs.search(query="toothpaste", store_id="7019")["data"] for p in res["products"]: s = p["stock"] print(p["sku_id"], p["name"], p["sale_price"], "was", p["price"], "in store:", s["in_store"], "pickup:", s["pickup"])