Dollar General

Dollar General Store Locator API

Dollar General stores near a US ZIP code or coordinates, nearest first (up to 25): store number, address, phone, coordinates, distance in miles, opening hours and services. Pass a upc and one call returns that product's unit count at every store in the list. Costs 1 credit per request.

POST/api/v1/dollargeneral/stores

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

zipstring

US ZIP code to search around. Pass this, or latitude and longitude.

Example: 75203

latitudenumber

Latitude to search around.

Example: 32.74

longitudenumber

Longitude to search around.

Example: -96.79

radiusnumber

Search radius in miles, 1-100. Defaults to 25.

Example: 25

upcstring

Product UPC. When set, every store also carries its unit count of that product.

Example: 030772156629

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

res = client.dollar_general.stores(zip="75203", upc="030772156629")["data"]

# One call: the product's unit count at up to 25 nearby stores
for s in res["stores"]:
    print(s["store_id"], s["address"], s["distance_miles"], "mi", "units:", s["quantity"])

Response

"zip": "75203",

"latitude": 32.744,

"longitude": -96.802,

"radius_miles": 25,

"upc": "030772156629",

"total_results": 117,

"count": 25,

"response_time": 6114

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") res = client.dollar_general.stores(zip="75203", upc="030772156629")["data"] # One call: the product's unit count at up to 25 nearby stores for s in res["stores"]: print(s["store_id"], s["address"], s["distance_miles"], "mi", "units:", s["quantity"])