# Starbucks API: Find nearby cafés > 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. Unofficial. Not affiliated with or endorsed by Starbucks. - Page: https://fous.com/methods/starbucks.com/search-stores - Method: `starbucks.com/search_stores`, version 1 - Website: starbucks.com - Returns: café name, address, distance, phone, today's hours, open now, amenities, store link, store number, coordinates - 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 | `"Seattle, WA"` | City, address, or ZIP code, for example Seattle, WA. | | `max_results` | integer | no | | Maximum number of nearby cafés to return, for example 10. Default 10. | | `open_now_only` | boolean | no | | Only show cafés that are open now, for example false. Default false. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "location": "Seattle, WA" } ``` Its output: ```json { "stores": [ { "address": "701 Fifth Ave, Seattle, WA 98104", "latitude": 47.60422, "open_now": false, "amenities": [ "In café", "Mobile Order and Pay", "MOP ASAP + Scheduled Ordering" ], "longitude": -122.33078, "store_name": "Columbia Center - 4th & Cherry", "today_hours": "5:00 AM to 6:00 PM", "phone_number": "+1 206-447-9934", "store_number": "101-54", "distance_miles": 0.1639, "store_page_link": "https://www.starbucks.com/store-locator/store/11311" }, { "address": "601 Union St, Seattle, WA 98101", "latitude": 47.61034, "open_now": false, "amenities": [ "In café", "Mobile Order and Pay", "MOP ASAP + Scheduled Ordering" ], "longitude": -122.33223, "store_name": "Two Union Square", "today_hours": "5:00 AM to 6:00 PM", "phone_number": "+1 206-264-2534", "store_number": "114-101752", "distance_miles": 0.2917, "store_page_link": "https://www.starbucks.com/store-locator/store/7328" }, { "address": "1401 2nd Ave, Seattle, WA 98101", "latitude": 47.60837, "open_now": true, "amenities": [ "Blonde Espresso", "In café", "Nitro Cold Brew" ], "longitude": -122.33844, "store_name": "Target Seattle Pike Plaza 2786", "today_hours": "7:00 AM to 8:00 PM", "phone_number": "+1 206-494-3250", "store_number": "16891-168546", "distance_miles": 0.3027, "store_page_link": "https://www.starbucks.com/store-locator/store/89776" } ] } ``` ## 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":"starbucks.com/search_stores","input":{"location":"Seattle, WA"}}' ``` 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 - Find the closest Starbucks to 1600 Pennsylvania Ave NW, Washington, DC that's open right now - coffee shops near ZIP 78704, nearest first with today's hours and whether they have a drive-thru - I'm in Portland, Maine. Show me the 5 nearest cafés currently open and their phone numbers - List up to 20 Starbucks locations around Pasadena, CA with addresses, distances and store numbers - Which cafés near 350 5th Ave, New York, NY are open now? Give me their hours and links to the store pages ## Input schema ```json { "type": "object", "required": [ "location" ], "properties": { "location": { "type": "string", "minLength": 1, "description": "City, address, or ZIP code, for example Seattle, WA." }, "max_results": { "type": "integer", "default": 10, "maximum": 50, "minimum": 1, "description": "Maximum number of nearby cafés to return, for example 10." }, "open_now_only": { "type": "boolean", "default": false, "description": "Only show cafés that are open now, for example false." } } } ``` ## Output schema ```json { "type": "object", "required": [ "stores" ], "properties": { "stores": { "type": "array", "items": { "type": "object", "required": [ "store_name", "address", "distance_miles", "phone_number", "today_hours", "open_now", "amenities", "store_page_link", "store_number", "latitude", "longitude" ], "properties": { "address": { "type": "string", "description": "Full street address." }, "latitude": { "type": [ "number", "null" ], "description": "Café latitude.", "x-fous-developer": true }, "open_now": { "type": "boolean", "description": "Whether the café is currently open." }, "amenities": { "type": "array", "items": { "type": "string" }, "description": "Café amenities." }, "longitude": { "type": [ "number", "null" ], "description": "Café longitude.", "x-fous-developer": true }, "store_name": { "type": "string", "description": "Name of the café." }, "today_hours": { "type": [ "string", "null" ], "description": "Today’s local opening hours as text, or null when unavailable." }, "phone_number": { "type": [ "string", "null" ], "description": "Phone number." }, "store_number": { "type": [ "string", "null" ], "description": "Starbucks store number.", "x-fous-developer": true }, "distance_miles": { "type": [ "number", "null" ], "description": "Distance from the searched place in miles." }, "store_page_link": { "type": "string", "description": "Link to the Starbucks listing for the café." } }, "additionalProperties": false } } }, "additionalProperties": false } ``` ## See more - [Starbucks API: Get menu item](https://fous.com/methods/starbucks.com/get-menu-item.md): Looks up a Starbucks menu item by name. Returns its description, standard recipe, size-specific nutrition, ingredients, allergens and photo. - [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. - [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. - [Costco API: Find nearby warehouses](https://fous.com/methods/costco.com/search-warehouses.md): 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. - [OpenStreetMap API: Search places](https://fous.com/methods/openstreetmap.org/search-places.md): Finds named places or kinds of places in a city or area, in search order, using OpenStreetMap Nominatim. Results may be fewer than requested. Data © OpenStreetMap contributors (ODbL). - [Chipotle API: Get nearest menu](https://fous.com/methods/chipotle.com/get-menu.md): Finds the nearest open Chipotle that takes online orders for a city, address, or ZIP code and returns its address, distance, today's hours and the pickup menu with prices, calories and photos. - [Google API: Get place](https://fous.com/methods/google.com/get-place.md): Looks up a public Google Maps place by name and location and returns its profile: address, rating, hours, phone, website and photos. - [Google API: Search places](https://fous.com/methods/google.com/search-places.md): Finds businesses and places near a location on Google Maps, in Google Maps order, with rating, hours, contact details and links when shown. - [All Starbucks methods](https://fous.com/methods/starbucks.com.md)