Costco

Costco Autocomplete API

Costco search suggestions for a partial query as JSON, plus any warehouse locations whose name matches it, each with its warehouse id and address. Costs 1 credit per request.

POST/api/v1/costco/autocomplete

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

Partial query, 1-100 characters.

Example: kirk

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")

suggest = client.costco.autocomplete("kirk")

print(suggest["data"]["suggestions"][:5])
for w in suggest["data"]["warehouses"]:
    print(w["warehouse_id"], w["name"], w["city"], w["state"])

Response

"query": "kirk",

"response_time": 878

}