---
title: "Find nearby Starbucks stores worldwide"
method: GET
path: "/starbucks/stores"
tags: ["Starbucks"]
---

# Find nearby Starbucks stores worldwide

`GET /starbucks/stores`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/starbucks/stores`
- Auth: API key in header `x-api-key`

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.

## Query parameters

- `place` string
- `lat` number
- `lng` number
- `market` 'us' | 'ca'

## Headers

- `x-api-key` string, required

## Response `200`

OK

- StarbucksStoresResponseDoc
  - `code` integer
  - `data` StarbucksStoreResponse
    - `count` integer
    - `fetched_at` string
    - `lat` number
    - `lng` number
    - `market` string
    - `place` string
    - `place_not_found` boolean: 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.
    - `result_capped` boolean: 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.
    - `source_url` string
    - `stores` StarbucksStore[]
      - `address` string
      - `amenities` StarbucksAmenity[]: Amenities are the store's features, each with Starbucks' own code and its human-readable name.
        - `code` string
        - `name` string
      - `city` string
      - `country` string
      - `distance_miles` number
      - `guest_ordering` boolean
      - `hours_status` string
      - `id` string
      - `is_open_24_hours` boolean
      - `latitude` number
      - `longitude` number
      - `mobile_ordering_availability` string: 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.
      - `name` string
      - `open` boolean
      - `open_status` string
      - `ownership_type_code` string: OwnershipTypeCode distinguishes company-operated ("CO") from licensed stores, which is why an airport or grocery-store kiosk behaves differently from a standalone café.
      - `phone` string
      - `pick_up_options` StarbucksPickUpOption[]: PickUpOptions are the fulfillment modes the store supports, each with its own live availability flag.
        - `available` boolean
        - `code` string
        - `name` string
      - `postal_code` string
      - `schedule` StarbucksStoreDay[]: Schedule is the store's weekly opening hours, Sunday-first as the upstream returns them.
        - `day_of_week` string
        - `holiday` string
        - `hours` string
        - `open` boolean
      - `state` string
      - `store_number` string: StoreNumber is Starbucks' own public store identifier, e.g. "101-54". ID is the locator's separate internal numeric id.
      - `time_zone` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)