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). Billing: this search costs 1 credit per record returned, with a minimum of 2 (an empty result costs 2, a full page of 100 costs 100).
Request
- Base URL: https://api.crawlora.net/api/v1
- URL: https://api.crawlora.net/api/v1/datasets/starbucks-stores/search
- Auth: API key in header x-api-key
Query parameters
Full-text search over store name, city, and address, max 256 characters
ISO-3166-1 alpha-2 country filter, e.g. US, GB, JP
State/region code filter, e.g. WA
Exact city filter
Crawl-provenance market filter. One of: us, ca
Amenity code filter, e.g. DT (Drive-Thru), XO (Mobile Order and Pay)
Latitude for radius filtering or distance sort, requires lon
Longitude for radius filtering or distance sort, requires lat
Radius in meters, 1 through 50000; requires lat and lon
Sort enum: relevance, distance_asc
Page number, defaults to 1
Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000
Headers
API key required
Response
OK
Example response
{
"code": 200,
"msg": "OK"
}Changes
No recorded changes to this operation across all 2 revisions of this API.