Starbucks Search
Nearest Starbucks cafés from coordinates or a store-locator URL. Returns address, hours, amenities, and the store number used by Menu and Product.
Credit cost: 3 credits per call
Autorización
ApiKeyAuth x-api-key<token>
Your API key. Include it in the x-api-key header for every request.
In: header
Parámetros de consulta
query?string
Store-locator URL, or a lat,lng pair. Required when lat and lng are empty.
Example:
https://www.starbucks.com/store-locator?map=40.71391,-74.01121,12zlat?number
Latitude. Send it with lng. If both are set, they replace any coordinates found in query.
lng?number
Longitude. Send it with lat.
place?string
Optional place label sent with the coordinates, for example New York, NY. Coordinates are still required.
features?string
Optional amenity filter. Separate codes with commas. ON keeps cafés that offer mobile order.
Cuerpo de la respuesta
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v2/starbucks/search"{ "results": [ { "name": "DTLA Grand Park", "open": false, "phone": "+1 213-625-2205", "address": { "city": "Los Angeles", "line1": "217 N. Hill Street", "region": "CA", "country": "US", "formatted": "217 N. Hill Street, Los Angeles", "postal_code": "90012" }, "distance": 0.262, "schedule": [ { "day": "thursday", "open": true, "hours": "4:30 AM to 9:00 PM" }, { "day": "friday", "open": true, "hours": "4:30 AM to 9:00 PM" }, { "day": "saturday", "open": true, "hours": "5:00 AM to 5:00 PM" }, { "day": "sunday", "open": true, "hours": "5:00 AM to 5:00 PM" }, { "day": "monday", "open": true, "hours": "4:30 AM to 9:00 PM" }, { "day": "tuesday", "open": true, "hours": "4:30 AM to 9:00 PM" }, { "day": "wednesday", "open": true, "hours": "4:30 AM to 9:00 PM" } ], "store_id": "69543", "amenities": [ "In café", "Mobile Order and Pay", "MOP ASAP + Scheduled Ordering", "Nitro Cold Brew", "Oven-warmed Food", "Redeem Rewards", "Starbucks Wi-Fi" ], "time_zone": "GMT-07:00 America/Los_Angeles", "coordinates": { "latitude": 34.05612, "longitude": -118.24698 }, "open_status": "Opens Thursday at 4:30 AM", "hours_status": "Open 4:30 AM-9:00 PM", "store_number": "9230-154245", "ownership_type_code": "co", "recommendation_reason": "nearby" } ], "pagination": { "next": null, "page": 1, "per_page": 50, "total_pages": null, "total_results": null }}{ "error": "Bad Request"}{ "error": "Invalid API Key"}{ "error": "Payment required"}{ "error": "Rate limit exceeded for the API key: quota monthly"}{ "error": "Internal Error"}