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
ApiKeyAuthx-api-key<token>Your API key. Include it in the x-api-key header for every request.
query?stringStore-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?numberLatitude. Send it with lng. If both are set, they replace any coordinates found in query.
lng?numberLongitude. Send it with lat.
place?stringOptional place label sent with the coordinates, for example New York, NY. Coordinates are still required.
features?stringOptional amenity filter. Separate codes with commas. ON keeps cafés that offer mobile order.
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
falseSuccessful response
application/json- response
results?array<>pagination?curl -X GET 'https://api.piloterr.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 }}