datasets_starbucks_stores_search
Find Starbucks stores worldwide using full-text, city, or location filters. Access details like address, phone, weekly hours, and amenity codes for each store.
Instructions
Search the Starbucks store directory. Searches the worldwide Starbucks store directory (dataset id starbucks-stores), built by grid-tiling the store locator around its 50-result cap. Each store has its store number, name, phone, full address, coordinates, weekly hours, amenity codes, and pick-up options. Store discovery is global, but hours, amenities, and phone numbers are populated per market and are largely absent outside the US, Canada, Europe, and the Gulf; an empty schedule means "not published for this market", not "closed". country is the store's true country while market is crawl provenance (the US host geocodes worldwide). Supports full-text q, country/state/city/market/amenity filters, lat/lon/radius_m radius filtering, and sort (relevance, distance_asc).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Full-text search over store name, city, and address, max 256 characters | |
| lat | No | Latitude for radius filtering or distance sort, requires lon | |
| lon | No | Longitude for radius filtering or distance sort, requires lat | |
| city | No | Exact city filter | |
| page | No | Page number, defaults to 1 | |
| sort | No | Sort enum: relevance, distance_asc | |
| state | No | State/region code filter, e.g. WA | |
| market | No | Crawl-provenance market filter. One of: us, ca | |
| amenity | No | Amenity code filter, e.g. DT (Drive-Thru), XO (Mobile Order and Pay) | |
| country | No | ISO-3166-1 alpha-2 country filter, e.g. US, GB, JP | |
| radius_m | No | Radius in meters, 1 through 50000; requires lat and lon | |
| page_size | No | Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000 |