GET/starbucks/menuapiKey1 credit/request
Returns Starbucks' full menu as a category tree: top-level categories, their child categories, and every product with its product number, form, product type, sizes, default size, availability, and image. Pair a product's product_number and form with /starbucks/product to fetch full detail including nutrition. store_number optionally scopes the menu to one store, using a store number from /starbucks/stores; a store-scoped menu marks items that store does not carry with availability NotAvailableHere, while the unscoped menu reports everything as Available. market selects which country catalog to return, one of us or ca, defaulting to us; the two differ substantially (roughly 282 US products vs 253 CA, with exclusives on both sides). Only these two markets are available.
Optional: store_number, market (2 allowed values: us, ca).
Sampled 14 Oct 2026: 9 items. Filled in every item: name, display_order, children. Not in every item: image_url (1). In the sample: display_order: 1 to 9, median 5; name: “The Latest” and 8 other values; image_url: cloudassets.starbucks.com; children: median 2 entries.
Open in Playground
GET/starbucks/nearest-storeapiKey1 credit/request
Returns the coordinates and distance of the single closest Starbucks store to a point. Both lat and lng are required. This endpoint returns coordinates only, not store details: it is what Starbucks' own store locator uses to centre its map. Use /starbucks/stores for full store records. A point with no nearby store returns a well-formed result with found set to false rather than an error. market selects which Starbucks country site answers, one of us or ca, defaulting to us.
Required: lat, lng. Optional: market (2 allowed values: us, ca).
Sampled 14 Oct 2026: 7 fields returned with a value. In the sample: distance_miles: 0.15; market: “us”; found: true.
Open in Playground
GET/starbucks/product/{product_number}/{form}apiKey1 credit/request
Returns one Starbucks product's full detail: name, description, product type, image, Rewards star cost, customization options, and every size with its own nutrition panel (serving size, calories, calories from fat, and per-fact values for total fat with saturated and trans fat subfacts, cholesterol, sodium, total carbohydrates, protein, and caffeine). product_number is the numeric id from a /starbucks/menu result or a product page URL. form is that product's form; allowed values are hot, iced, single, packaged, whole-bean, and via. store_number optionally scopes availability to one store. Starbucks does not expose dollar pricing on this surface, so no price is returned; star_cost is the Rewards star cost. market selects which country catalog to resolve against, one of us or ca, defaulting to us. Each size also carries its default_recipe, the standard build, which is the required starting point for the /starbucks/product/{product_number}/{form}/nutrition endpoint. An unknown product number, or a form that product is not sold in, returns not found.
Required: product_number, form (6 allowed values: hot, iced, single, packaged, whole-bean, via). Optional: store_number, market (2 allowed values: us, ca).
Sampled 14 Oct 2026: 9 items. Filled in every item: name. In the sample: name: “Milk” and 8 other values.
Open in Playground
POST/starbucks/product/{product_number}/{form}/nutritionapiKey1 credit/request
Recalculates calories, fat, sugars, and protein for a customized build of a Starbucks beverage: swap the milk, change the number of espresso shots or syrup pumps, and get the real figures for that exact drink rather than the standard recipe. Starbucks only offers this for four hot espresso beverages; product_number and form must be one of 406/hot (Caffe Americano), 407/hot (Caffe Latte), 408/hot (Caffe Mocha), or 413/hot (Caramel Macchiato). Any other product returns an invalid-parameter error naming the four that work. size_sku comes from a /starbucks/product result's sizes[].sku. modifiers is the COMPLETE build, not a change-set: start from that size's default_recipe, adjust what you want, and send the whole list back; an empty list is rejected. Each modifier needs a sku, an optional quantity (defaults to 1, and is the dial that matters for countable modifiers like espresso shots), and an optional replaced_sku when substituting a pick-one slot such as the milk. This returns Starbucks' own four-value dynamic-nutrition panel, which is smaller than the full per-size panel /starbucks/product returns for the standard build.
Required: product_number, form (hot), request.
Sampled 14 Oct 2026: 4 items. Filled in every item: key, name, value, unit_of_measure. In the sample: unit_of_measure: g (3), kcal (1); value: 0 to 25, median 0; name: “Calories” and 3 other values.
Open in Playground
GET/starbucks/storesapiKey1 credit/request
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.
Optional: place, lat, lng, market (2 allowed values: us, ca).
Sampled 14 Oct 2026: 50 items. Filled in every item: store_number, id, name, distance_miles, address, city, state, postal_code and 13 more. Not in every item: phone (49), pick_up_options (47). In the sample: city: Seattle (47), Mercer Island (2), SEATTLE (1); distance_miles: 0.16 to 5.3, median 2.95; store_number: “101-54” and 49 other values; open: true in 50 of 50; amenities: median 8 entries; name: “Columbia Center - 4th & Cherry” and 49 other values; is_open_24_hours: true in 0 of 50; open_status: “Open 5:00 AM-6:00 PM” and 18 other values.
Open in Playground