Endpoint Playground
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.
14 Oct 2026: Single record response; 7 fields had a value in every checked item.
Sample value profiles: distance_miles: 0.15; market: “us”; found: true.
curl 'https://api.crawlora.net/api/v1/starbucks/nearest-store?lat=47.6062&lng=-122.3321&market=us' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| lat | number | Yes | 47.6062 | Latitude |
| lng | number | Yes | -122.3321 | Longitude |
| market | string | No | us | Starbucks country site to read. One of: us, ca. Defaults to us |
{
"code": 200,
"msg": "OK",
"data": {
"lat": 47.6062,
"lng": -122.3321,
"found": true,
"nearest_latitude": 47.60422,
"nearest_longitude": -122.33078,
"distance_miles": 0.15,
"source_url": "https://www.starbucks.com/apiproxy/v1/locations/nearest-location",
"fetched_at": "2026-08-30T10:31:05Z"
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.