Dollar General

Dollar General Search API

Search Dollar General products at one store and get that store's price and original price, units on hand (available_quantity), the raw inventory_status code, rating and review count, categories, digital coupons and promotions, UPC and product URL. Prices are in dollars. store_id is required. Costs 1 credit per request.

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

Example: paper towels

store_idstringrequired

Dollar General store number. Prices and unit counts are that store's. Find numbers with /api/v1/dollargeneral/stores.

Example: 12629

pageinteger

Results page, 1-based. Defaults to 1. 24 results per page.

Example: 1

sortstring

recommended (default), price_low, price_high or rating.

in_stock_onlyboolean

Only products with units on hand at the store. Defaults to false.

Example: true

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

res = client.dollar_general.search(query="paper towels", store_id="12629")["data"]

for p in res["products"]:
    print(p["upc"], p["title"], p["price"], "was", p["original_price"], "on hand:", p["available_quantity"])

Response

"query": "paper towels",

"store_id": "12629",

"page": 1,

"total_results": 64,

"total_pages": 3,

"count": 24,

"response_time": 2913

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") res = client.dollar_general.search(query="paper towels", store_id="12629")["data"] for p in res["products"]: print(p["upc"], p["title"], p["price"], "was", p["original_price"], "on hand:", p["available_quantity"])