Docs menu

Starbucks API endpoint

Nearby Starbucks Stores API

Returns Starbucks store locations near a point: store number, name, phone, full address, coordinates, weekly opening hours, amenities, and pick-up options. Either place, or both lat and lng, is required. place is free-text (city, address, or postal code) and is geocoded by Starbucks itself, so it works worldwide. market selects which Starbucks country site answers, one of us or ca, defaulting to us; this is not cosmetic even for stores, because the same store reports different operational data depending on the host. There is no filter parameter: Starbucks' own API accepts a features amenity filter but silently ignores it, so it is deliberately not offered here; filter on each store's returned amenities instead. A place Starbucks cannot resolve returns a well-formed empty result with place_not_found set to true rather than an error. The upstream returns at most 50 stores per request and supports no pagination; result_capped is true when that ceiling was reached. Store discovery works worldwide, but hours, amenities, and phone numbers are populated per market and may be absent outside the US and UK.

GETapiKey1 credit/requestStarbucksstarbucks.storesResponseDoc/starbucks/stores

Endpoint facts

Method: GET
API path: /starbucks/stores
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: Starbucks
Response schema: #/definitions/starbucks.storesResponseDoc

Starbucks API Try Nearby Starbucks Stores API in Playground Starbucks API documentation

How this endpoint behaves

Searches Starbucks' own store locator. Provide place (free-text city, address, or postal code, geocoded by Starbucks itself), or both lat and lng directly.

place is optional. lat is optional, requires lng. lng is optional, requires lat. Either place, or both lat and lng, is required.

market is optional, one of us or ca, defaults to us. These are the only two markets available.

Because the same store reports different operational data depending on which country host answers — one Toronto store reports its mobile ordering as NOT_ELIGIBLE from the US host and READY from the CA host — pass market=ca when working Canadian geography.

There is no filter parameter. Starbucks' own API accepts a features= amenity filter but silently ignores it — verified against Chicago, where the unfiltered call and features=DT, features=NB, and features=DT,NB all returned the identical 50 results — so it is deliberately not exposed here. Filter on each store's returned amenities instead, remembering that results are capped at 50 before any filtering.

Notable response behavior:

Works worldwide. place is geocoded by Starbucks, so cities outside the US resolve normally — confirmed against Seattle, London, Tokyo, Paris, München, São Paulo, Dubai, and Sydney. Postal codes usually work (98104, 10001, SW1A 1AA), but Starbucks' geocoder does not resolve every one of them (90210 does not); a failure is reported as place_not_found, never as an error.
The upstream returns at most 50 stores per request and supports no pagination. result_capped is true when that ceiling was reached, meaning more stores may exist nearby that cannot be retrieved. Query around different coordinates for wider coverage.
Three distinct outcomes, none of them errors. Stores found (count > 0); a place that could not be geocoded (place_not_found: true, count: 0); and a place that geocoded fine but has no Starbucks nearby (place_not_found: false, count: 0, e.g. Utqiagvik, Alaska). The same distinction applies to a remote lat/lng.
Each store lists its amenities with Starbucks' own codes: 16 (In Store), AS (MOP ASAP + Scheduled Ordering), BE (Blonde Espresso), CC (Scanless Order and Pay), CS (Café Seating), DR (Redeem Rewards), DT (Drive-Thru), EM (Starbucks Evenings), GO (Starbucks Wi-Fi), NB (Nitro Cold Brew), OS (Outdoor Seating), WA (Oven-warmed Food), WF (Wireless Hot-Spot), XO (Mobile Order and Pay).
Field coverage varies by market. Store number, name, address, and coordinates are returned everywhere, but schedule, amenities, and phone are populated per market. Measured across all 50 results per market: United States 50/50 have a weekly schedule, amenities and phone; United Kingdom 49/50; France 47/50 have a schedule but no amenities and no phone; Japan 0/50 have a schedule, amenities, or phone, and every store reports hours_status of "Store hours aren't available". Do not read an empty schedule as a closed store.
store_number is Starbucks' own public store identifier and is what /starbucks/menu and /starbucks/product accept as store_number.
ownership_type_code distinguishes company-operated (CO) stores from licensed ones such as airport and grocery kiosks.
mobile_ordering_availability is a live readiness state (e.g. READY, NOT_READY), not a static capability — a store that supports mobile ordering still reports NOT_READY while closed. Use the XO amenity code for the static capability.
distance_miles is the distance from the searched point.

Live monitoring

Monitored request: GET /starbucks/stores?place=Seattle%2C+WA
Checks passed, 7 days to 14 Oct 2026: 99.1%
Median response time: 2.46 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /starbucks/stores?place=Seattle%2C+WA
Items in stores: 50
Fields filled in every checked item: 21
Fields empty in some or all items: 2

Field	Filled in, of 50 checked	Values in the sample
store_number	50	“101-54” and 49 other values
id	50
name	50	“Columbia Center - 4th & Cherry” and 49 other values
phone	49
distance_miles	50	0.16 to 5.3, median 2.95
address	50
city	50	Seattle (47), Mercer Island (2), SEATTLE (1)
state	50	WA in all 50
postal_code	50
country	50	US in all 50
latitude	50
longitude	50
time_zone	50	GMT-07:00 America/Los_Angeles in all 50
ownership_type_code	50
open	50	true in 50 of 50
is_open_24_hours	50	true in 0 of 50
open_status	50	“Open 5:00 AM-6:00 PM” and 18 other values
hours_status	50	“Open 5:00 AM-6:00 PM” and 18 other values
mobile_ordering_availability	50	READY (44), NOT_ELIGIBLE (4), NOT_READY (2)
guest_ordering	50	true in 25 of 50
amenities	50	median 8 entries
pick_up_options	47	median 1 entry
schedule	50	median 7 entries

Request parameters

Parameter	Type	Required	Default	Description	Example
place	string	No		Free-text city, address, or postal code, geocoded by Starbucks	Seattle, WA
lat	number	No		Latitude, requires lng	47.6062
lng	number	No		Longitude, requires lat	-122.3321
market	string	No	us	Starbucks country site to read. One of: us, ca. Defaults to us Allowed values: us, ca.	us
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/starbucks/stores?market=us" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "place": "Seattle, WA",
    "place_not_found": false,
    "result_capped": true,
    "count": 50,
    "source_url": "https://www.starbucks.com/apiproxy/v1/locations?place=Seattle%2C+WA",
    "fetched_at": "2026-08-30T10:31:02Z",
    "stores": [
      {
        "store_number": "101-54",
        "id": "11311",
        "name": "Columbia Center - 4th & Cherry",
        "phone": "+1 206-447-9934",
        "distance_miles": 0.1639,
        "address": "701 Fifth Ave",
        "city": "Seattle",
        "state": "WA",
        "postal_code": "98104",
        "country": "US",
        "latitude": 47.60422,
        "longitude": -122.33078,
        "time_zone": "GMT-07:00 America/Los_Angeles",
        "ownership_type_code": "CO",
        "open": false,
        "is_open_24_hours": false,
        "hours_status": "Closed today",
        "mobile_ordering_availability": "NOT_READY",
        "guest_ordering": true,
        "amenities": [
          {
            "code": "16",
            "name": "In Store"
          },
          {
            "code": "XO",
            "name": "Mobile Order and Pay"
          }
        ],
        "pick_up_options": [
          {
            "code": "16",
            "name": "In store",
            "available": false
          }
        ],
        "schedule": [
          {
            "day_of_week": "SUNDAY",
            "hours": "Closed",
            "open": false
          },
          {
            "day_of_week": "MONDAY",
            "hours": "5:00 AM to 6:00 PM",
            "open": true
          }
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/starbucks.storesResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	starbucks.StoreResponse	No
data.count	integer	No
data.fetched_at	string	No
data.lat	number	No
data.lng	number	No
data.market	string	No
data.place	string	No
data.place_not_found	boolean	No		PlaceNotFound is true when Starbucks could not geocode Place at all. The upstream signals this with a distinct object shape rather than an empty list, so a genuine no-results answer stays distinguishable from parser drift.
data.result_capped	boolean	No		ResultCapped is true when the upstream returned its hard 50-result ceiling, meaning more stores may exist near this point that the upstream will not return under any pagination parameter.
data.source_url	string	No
data.stores	array	No
data.stores[].address	string	No
data.stores[].amenities	array	No		Amenities are the store's features, each with Starbucks' own code and its human-readable name.
data.stores[].amenities[].code	string	No
data.stores[].amenities[].name	string	No
data.stores[].city	string	No
data.stores[].country	string	No
data.stores[].distance_miles	number	No
data.stores[].guest_ordering	boolean	No
data.stores[].hours_status	string	No
data.stores[].id	string	No
data.stores[].is_open_24_hours	boolean	No
data.stores[].latitude	number	No
data.stores[].longitude	number	No
data.stores[].mobile_ordering_availability	string	No		MobileOrderingAvailability is the upstream's own enum-ish state for Mobile Order & Pay at this store, e.g. "READY" / "NOT_READY". It is a live readiness state, not a static capability -- a store that supports mobile ordering still reports NOT_READY while closed. Use the "XO" amenity code for the static capability.
data.stores[].name	string	No
data.stores[].open	boolean	No
data.stores[].open_status	string	No
data.stores[].ownership_type_code	string	No		OwnershipTypeCode distinguishes company-operated ("CO") from licensed stores, which is why an airport or grocery-store kiosk behaves differently from a standalone café.
data.stores[].phone	string	No
data.stores[].pick_up_options	array	No		PickUpOptions are the fulfillment modes the store supports, each with its own live availability flag.
data.stores[].pick_up_options[].available	boolean	No
data.stores[].pick_up_options[].code	string	No
data.stores[].pick_up_options[].name	string	No
data.stores[].postal_code	string	No
data.stores[].schedule	array	No		Schedule is the store's weekly opening hours, Sunday-first as the upstream returns them.
data.stores[].schedule[].day_of_week	string	No
data.stores[].schedule[].holiday	string	No
data.stores[].schedule[].hours	string	No
data.stores[].schedule[].open	boolean	No
data.stores[].state	string	No
data.stores[].store_number	string	No		StoreNumber is Starbucks' own public store identifier, e.g. "101-54". ID is the locator's separate internal numeric id.
data.stores[].time_zone	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/starbucks/stores?market=us" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Starbucks endpoint docs Starbucks API Browse the full Starbucks menu API documentation Nearest Starbucks Store API documentation Starbucks Product Detail API documentation Starbucks Custom Nutrition API documentation

Open in Playground Back to group

Docs menu

Starbucks API endpoint

Nearby Starbucks Stores API

GETapiKey1 credit/requestStarbucksstarbucks.storesResponseDoc/starbucks/stores

Endpoint facts

Method: GET
API path: /starbucks/stores
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: Starbucks
Response schema: #/definitions/starbucks.storesResponseDoc

Starbucks API Try Nearby Starbucks Stores API in Playground Starbucks API documentation

How this endpoint behaves

Searches Starbucks' own store locator. Provide place (free-text city, address, or postal code, geocoded by Starbucks itself), or both lat and lng directly.

place is optional. lat is optional, requires lng. lng is optional, requires lat. Either place, or both lat and lng, is required.

market is optional, one of us or ca, defaults to us. These are the only two markets available.

Notable response behavior:

Works worldwide. place is geocoded by Starbucks, so cities outside the US resolve normally — confirmed against Seattle, London, Tokyo, Paris, München, São Paulo, Dubai, and Sydney. Postal codes usually work (98104, 10001, SW1A 1AA), but Starbucks' geocoder does not resolve every one of them (90210 does not); a failure is reported as place_not_found, never as an error.
The upstream returns at most 50 stores per request and supports no pagination. result_capped is true when that ceiling was reached, meaning more stores may exist nearby that cannot be retrieved. Query around different coordinates for wider coverage.
Three distinct outcomes, none of them errors. Stores found (count > 0); a place that could not be geocoded (place_not_found: true, count: 0); and a place that geocoded fine but has no Starbucks nearby (place_not_found: false, count: 0, e.g. Utqiagvik, Alaska). The same distinction applies to a remote lat/lng.
Each store lists its amenities with Starbucks' own codes: 16 (In Store), AS (MOP ASAP + Scheduled Ordering), BE (Blonde Espresso), CC (Scanless Order and Pay), CS (Café Seating), DR (Redeem Rewards), DT (Drive-Thru), EM (Starbucks Evenings), GO (Starbucks Wi-Fi), NB (Nitro Cold Brew), OS (Outdoor Seating), WA (Oven-warmed Food), WF (Wireless Hot-Spot), XO (Mobile Order and Pay).
Field coverage varies by market. Store number, name, address, and coordinates are returned everywhere, but schedule, amenities, and phone are populated per market. Measured across all 50 results per market: United States 50/50 have a weekly schedule, amenities and phone; United Kingdom 49/50; France 47/50 have a schedule but no amenities and no phone; Japan 0/50 have a schedule, amenities, or phone, and every store reports hours_status of "Store hours aren't available". Do not read an empty schedule as a closed store.
store_number is Starbucks' own public store identifier and is what /starbucks/menu and /starbucks/product accept as store_number.
ownership_type_code distinguishes company-operated (CO) stores from licensed ones such as airport and grocery kiosks.
mobile_ordering_availability is a live readiness state (e.g. READY, NOT_READY), not a static capability — a store that supports mobile ordering still reports NOT_READY while closed. Use the XO amenity code for the static capability.
distance_miles is the distance from the searched point.

Live monitoring

Monitored request: GET /starbucks/stores?place=Seattle%2C+WA
Checks passed, 7 days to 14 Oct 2026: 99.1%
Median response time: 2.46 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /starbucks/stores?place=Seattle%2C+WA
Items in stores: 50
Fields filled in every checked item: 21
Fields empty in some or all items: 2

Field	Filled in, of 50 checked	Values in the sample
store_number	50	“101-54” and 49 other values
id	50
name	50	“Columbia Center - 4th & Cherry” and 49 other values
phone	49
distance_miles	50	0.16 to 5.3, median 2.95
address	50
city	50	Seattle (47), Mercer Island (2), SEATTLE (1)
state	50	WA in all 50
postal_code	50
country	50	US in all 50
latitude	50
longitude	50
time_zone	50	GMT-07:00 America/Los_Angeles in all 50
ownership_type_code	50
open	50	true in 50 of 50
is_open_24_hours	50	true in 0 of 50
open_status	50	“Open 5:00 AM-6:00 PM” and 18 other values
hours_status	50	“Open 5:00 AM-6:00 PM” and 18 other values
mobile_ordering_availability	50	READY (44), NOT_ELIGIBLE (4), NOT_READY (2)
guest_ordering	50	true in 25 of 50
amenities	50	median 8 entries
pick_up_options	47	median 1 entry
schedule	50	median 7 entries

Request parameters

Parameter	Type	Required	Default	Description	Example
place	string	No		Free-text city, address, or postal code, geocoded by Starbucks	Seattle, WA
lat	number	No		Latitude, requires lng	47.6062
lng	number	No		Longitude, requires lat	-122.3321
market	string	No	us	Starbucks country site to read. One of: us, ca. Defaults to us Allowed values: us, ca.	us
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/starbucks/stores?market=us" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "place": "Seattle, WA",
    "place_not_found": false,
    "result_capped": true,
    "count": 50,
    "source_url": "https://www.starbucks.com/apiproxy/v1/locations?place=Seattle%2C+WA",
    "fetched_at": "2026-08-30T10:31:02Z",
    "stores": [
      {
        "store_number": "101-54",
        "id": "11311",
        "name": "Columbia Center - 4th & Cherry",
        "phone": "+1 206-447-9934",
        "distance_miles": 0.1639,
        "address": "701 Fifth Ave",
        "city": "Seattle",
        "state": "WA",
        "postal_code": "98104",
        "country": "US",
        "latitude": 47.60422,
        "longitude": -122.33078,
        "time_zone": "GMT-07:00 America/Los_Angeles",
        "ownership_type_code": "CO",
        "open": false,
        "is_open_24_hours": false,
        "hours_status": "Closed today",
        "mobile_ordering_availability": "NOT_READY",
        "guest_ordering": true,
        "amenities": [
          {
            "code": "16",
            "name": "In Store"
          },
          {
            "code": "XO",
            "name": "Mobile Order and Pay"
          }
        ],
        "pick_up_options": [
          {
            "code": "16",
            "name": "In store",
            "available": false
          }
        ],
        "schedule": [
          {
            "day_of_week": "SUNDAY",
            "hours": "Closed",
            "open": false
          },
          {
            "day_of_week": "MONDAY",
            "hours": "5:00 AM to 6:00 PM",
            "open": true
          }
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/starbucks.storesResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	starbucks.StoreResponse	No
data.count	integer	No
data.fetched_at	string	No
data.lat	number	No
data.lng	number	No
data.market	string	No
data.place	string	No
data.place_not_found	boolean	No		PlaceNotFound is true when Starbucks could not geocode Place at all. The upstream signals this with a distinct object shape rather than an empty list, so a genuine no-results answer stays distinguishable from parser drift.
data.result_capped	boolean	No		ResultCapped is true when the upstream returned its hard 50-result ceiling, meaning more stores may exist near this point that the upstream will not return under any pagination parameter.
data.source_url	string	No
data.stores	array	No
data.stores[].address	string	No
data.stores[].amenities	array	No		Amenities are the store's features, each with Starbucks' own code and its human-readable name.
data.stores[].amenities[].code	string	No
data.stores[].amenities[].name	string	No
data.stores[].city	string	No
data.stores[].country	string	No
data.stores[].distance_miles	number	No
data.stores[].guest_ordering	boolean	No
data.stores[].hours_status	string	No
data.stores[].id	string	No
data.stores[].is_open_24_hours	boolean	No
data.stores[].latitude	number	No
data.stores[].longitude	number	No
data.stores[].mobile_ordering_availability	string	No		MobileOrderingAvailability is the upstream's own enum-ish state for Mobile Order & Pay at this store, e.g. "READY" / "NOT_READY". It is a live readiness state, not a static capability -- a store that supports mobile ordering still reports NOT_READY while closed. Use the "XO" amenity code for the static capability.
data.stores[].name	string	No
data.stores[].open	boolean	No
data.stores[].open_status	string	No
data.stores[].ownership_type_code	string	No		OwnershipTypeCode distinguishes company-operated ("CO") from licensed stores, which is why an airport or grocery-store kiosk behaves differently from a standalone café.
data.stores[].phone	string	No
data.stores[].pick_up_options	array	No		PickUpOptions are the fulfillment modes the store supports, each with its own live availability flag.
data.stores[].pick_up_options[].available	boolean	No
data.stores[].pick_up_options[].code	string	No
data.stores[].pick_up_options[].name	string	No
data.stores[].postal_code	string	No
data.stores[].schedule	array	No		Schedule is the store's weekly opening hours, Sunday-first as the upstream returns them.
data.stores[].schedule[].day_of_week	string	No
data.stores[].schedule[].holiday	string	No
data.stores[].schedule[].hours	string	No
data.stores[].schedule[].open	boolean	No
data.stores[].state	string	No
data.stores[].store_number	string	No		StoreNumber is Starbucks' own public store identifier, e.g. "101-54". ID is the locator's separate internal numeric id.
data.stores[].time_zone	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/starbucks/stores?market=us" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Nearby Starbucks Stores API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Nearby Starbucks Stores API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related