# Costco API: Find nearby warehouses > Finds the US Costco warehouses nearest a city, address or ZIP code, with today's and weekly hours, gas station hours, services and posted gas prices. Unofficial. Not affiliated with or endorsed by Costco. - Page: https://fous.com/methods/costco.com/search-warehouses - Method: `costco.com/search_warehouses`, version 1 - Website: costco.com - Returns: warehouse name, address, phone, distance, today's and weekly hours, gas hours, regular/premium/diesel prices, services, page link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `location` | string | yes | `"Kirkland, WA"` | City, street address, or ZIP code to search near, such as Kirkland, WA. | | `max_results` | integer | no | `5` | Maximum number of nearest warehouses to return, for example 5. Default 5. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "location": "Kirkland, WA", "max_results": 5 } ``` Its output: ```json { "warehouses": [ { "phone": "(425) 827-1693", "address": "8629 120TH AVE NE, KIRKLAND WA 98033-5822", "services": [ "Food Court", "Gas Station", "Hearing Aids" ], "weekly_hours": "Executive Member Mon-Fri: 9:00 AM - 8:30 PM; Gold Star & Business Member Mon-Fri: 10:00 AM - 8:30 PM; Executive Member Sat: 9:00 AM - 7:00 PM; Gold Star & Business Member Sat: 9:30 AM - 7:00 PM; Executive Member Sun: 9:00 AM - 6:00 PM; Gold Star & Business Member Sun: 10:00 AM - 6:00 PM", "distance_miles": 1.1, "warehouse_name": "Kirkland Warehouse", "diesel_gas_price": null, "warehouse_number": "8", "gas_station_hours": "Mon-Fri: 6:00 AM - 10:00 PM; Sat: 6:00 AM - 8:30 PM; Sun: 6:00 AM - 7:30 PM", "premium_gas_price": 5.899, "regular_gas_price": 5.499, "gas_price_currency": "USD", "today_opening_hours": "Executive Member Mon-Fri: 9:00 AM - 8:30 PM; Gold Star & Business Member Mon-Fri: 10:00 AM - 8:30 PM", "warehouse_page_link": "https://www.costco.com/w/-/wa/kirkland/8" }, { "phone": "(425) 406-5382", "address": "7725 188TH AVE NE, REDMOND WA 98052-6088", "services": [ "Food Court", "Gas Station", "Hearing Aids" ], "weekly_hours": "Executive Member Mon-Fri: 9:00 AM - 8:30 PM; Gold Star & Business Member Mon-Fri: 10:00 AM - 8:30 PM; Executive Member Sat: 9:00 AM - 7:00 PM; Gold Star & Business Member Sat: 9:30 AM - 7:00 PM; Executive Member Sun: 9:00 AM - 6:00 PM; Gold Star & Business Member Sun: 10:00 AM - 6:00 PM", "distance_miles": 5.25, "warehouse_name": "Redmond Warehouse", "diesel_gas_price": 7.159, "warehouse_number": "1225", "gas_station_hours": "Mon-Fri: 6:00 AM - 10:00 PM; Sat: 6:00 AM - 8:30 PM; Sun: 6:00 AM - 7:30 PM", "premium_gas_price": 5.999, "regular_gas_price": 5.449, "gas_price_currency": "USD", "today_opening_hours": "Executive Member Mon-Fri: 9:00 AM - 8:30 PM; Gold Star & Business Member Mon-Fri: 10:00 AM - 8:30 PM", "warehouse_page_link": "https://www.costco.com/w/-/wa/redmond/1225" }, { "phone": "(425) 806-7700", "address": "24008 SNOHOMISH WOODINVILLE RD, WOODINVILLE WA 98072-9743", "services": [ "Food Court", "Gas Station", "Hearing Aids" ], "weekly_hours": "Executive Member Mon-Fri: 9:00 AM - 8:30 PM; Gold Star & Business Member Mon-Fri: 10:00 AM - 8:30 PM; Executive Member Sat: 9:00 AM - 7:00 PM; Gold Star & Business Member Sat: 9:30 AM - 7:00 PM; Executive Member Sun: 9:00 AM - 6:00 PM; Gold Star & Business Member Sun: 10:00 AM - 6:00 PM", "distance_miles": 7.68, "warehouse_name": "Woodinville Warehouse", "diesel_gas_price": 7.399, "warehouse_number": "747", "gas_station_hours": "Mon-Fri: 6:00 AM - 10:00 PM; Sat: 6:00 AM - 8:30 PM; Sun: 6:00 AM - 7:30 PM", "premium_gas_price": 5.899, "regular_gas_price": 5.339, "gas_price_currency": "USD", "today_opening_hours": "Executive Member Mon-Fri: 9:00 AM - 8:30 PM; Gold Star & Business Member Mon-Fri: 10:00 AM - 8:30 PM", "warehouse_page_link": "https://www.costco.com/w/-/wa/woodinville/747" } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"costco.com/search_warehouses","input":{"location":"Kirkland, WA","max_results":5}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - What are the closest Costco warehouses to ZIP 80202 and what are their hours today? - Find me the 3 nearest Costco locations to 1450 Market St, San Francisco, CA, including gas prices for regular and premium. - Which warehouse stores near Plano, TX have a gas station that sells diesel, and what's the current price per gallon? - Show up to 10 warehouse club locations around Raleigh, NC with phone numbers, weekly hours, and services like pharmacy or tire center. - I'm in Scottsdale, AZ — list the nearest Costco stores with distance and what time their gas stations open tomorrow. ## Input schema ```json { "type": "object", "required": [ "location" ], "properties": { "location": { "type": "string", "minLength": 1, "description": "City, street address, or ZIP code to search near, such as Kirkland, WA." }, "max_results": { "type": "integer", "default": 5, "maximum": 20, "minimum": 1, "description": "Maximum number of nearest warehouses to return, for example 5." } } } ``` ## Output schema ```json { "type": "object", "required": [ "warehouses" ], "properties": { "warehouses": { "type": "array", "items": { "type": "object", "required": [ "warehouse_name", "address", "phone", "distance_miles", "today_opening_hours", "weekly_hours", "gas_station_hours", "regular_gas_price", "premium_gas_price", "diesel_gas_price", "gas_price_currency", "services", "warehouse_page_link", "warehouse_number" ], "properties": { "phone": { "type": [ "string", "null" ] }, "address": { "type": "string" }, "services": { "type": "array", "items": { "type": "string" } }, "weekly_hours": { "type": [ "string", "null" ] }, "distance_miles": { "type": "number" }, "warehouse_name": { "type": "string" }, "diesel_gas_price": { "type": [ "number", "null" ] }, "warehouse_number": { "type": "string" }, "gas_station_hours": { "type": [ "string", "null" ] }, "premium_gas_price": { "type": [ "number", "null" ] }, "regular_gas_price": { "type": [ "number", "null" ] }, "gas_price_currency": { "enum": [ "USD" ], "type": "string" }, "today_opening_hours": { "type": [ "string", "null" ] }, "warehouse_page_link": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } ``` ## See more - [Starbucks API: Find nearby cafés](https://fous.com/methods/starbucks.com/search-stores.md): Finds Starbucks cafés near a city, address or ZIP code, nearest first, with whether each is open now, today's local hours and amenities; optionally only cafés open now. - [AutoZone API: Search stores near a location](https://fous.com/methods/autozone.com/search-stores.md): Finds the AutoZone stores nearest a US ZIP code, city or street address, with contact details, opening hours, whether each is open now, distance and store page links. - [GasBuddy API: List cheapest gas stations](https://fous.com/methods/gasbuddy.com/list-cheapest-gas-stations.md): Finds nearby GasBuddy stations for a US or Canadian city, address or postal code and lists their reported prices for a fuel grade, lowest listed price first. - [McDonald's API: Search restaurants](https://fous.com/methods/mcdonalds.com/search-restaurants.md): Finds McDonald's restaurants within 50 miles of a US city, address or ZIP code, nearest first. Each result includes today's hours, services and directions. Open-now status follows the listed hours. - [Instacart API: Search store products](https://fous.com/methods/instacart.com/search-products.md): Searches a named Instacart store's guest-visible grocery products for a US ZIP code. Prices are in USD and can differ from in-store prices; stock estimates can change. - [GasBuddy API: Get average gas prices](https://fous.com/methods/gasbuddy.com/get-average-gas-prices.md): Gets GasBuddy's latest reported average regular gas price, its changes and the diesel benchmark for a US state or a listed metro area. Midgrade, premium and area low/high prices are not published with these averages; updates may lag the current day. - [AAA API: Get gas prices](https://fous.com/methods/gasprices.aaa.com/get-gas-prices.md): Gets AAA average gasoline and diesel prices for the US, a state, or a metro area listed on its state page, with yesterday, week, month and year-ago comparisons and record highs, as of the date AAA shows. - [Target API: Check store stock](https://fous.com/methods/target.com/check-store-stock.md): Checks a Target product's stock and pickup, drive-up and same-day delivery availability at the stores nearest a US ZIP code.