Costco

Costco Gas Prices API

Current regular, premium and diesel prices at Costco gas stations near a zip code or coordinates, or at specific warehouses, with each station's address, distance and hours. Costs 1 credit by location; by warehouse, 1 credit per 5 warehouses.

POST/api/v1/costco/gas

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. Send zip, latitude and longitude, or warehouse_ids.

Example: 90001

latitudenumber

Latitude, -90 to 90.

Example: 33.974

longitudenumber

Longitude, -180 to 180.

Example: -118.249

warehouse_idsarray<string>

Specific warehouses instead of a location, up to 10. 1 credit per 5 warehouses (2 per warehouse on costco.ca).

Example: ["769", "569"]

limitintegerdefault:10

Nearest stations to return, 1-50.

Example: 5

countryenum<string>default:us

costco.com (us) or costco.ca (ca).

Example: ca

us — costco.com, United States.
ca — costco.ca, Canada.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

gas = client.costco.gas(zip="90001", limit=5)

for s in gas["data"]["stations"]:
    p = s["prices"]
    print(s["warehouse_id"], s["name"], p["regular"], p["premium"], p["diesel"])

Response

"country": "us",

"currency": "USD",

"count": 5,

"response_time": 3163

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") gas = client.costco.gas(zip="90001", limit=5) for s in gas["data"]["stations"]: p = s["prices"] print(s["warehouse_id"], s["name"], p["regular"], p["premium"], p["diesel"])