Starbucks API endpoint
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.
/starbucks/nearest-storemarket is optional, one of us or ca, defaults to us. These are the only two markets available.
Notable response behavior:
/starbucks/stores for full store records, or feed nearest_latitude and nearest_longitude straight into it.found: false, not an error — confirmed at Ushuaia, Argentina.distance_miles is the distance from the searched point.| Field | In the sample | Value in the sample |
|---|---|---|
| market | Has a value | “us” |
| lat | Has a value | |
| lng | Has a value | |
| found | Has a value | true |
| nearest_latitude | Has a value | |
| nearest_longitude | Has a value | |
| distance_miles | Has a value | 0.15 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| lat | number | Yes | Latitude | 47.6062 | |
| lng | number | Yes | Longitude | -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 -X GET "https://api.crawlora.net/api/v1/starbucks/nearest-store?lat=47.6062&lng=-122.3321&market=us" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"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"
}
}Request schema
No body schema
Response schema
#/definitions/starbucks.nearestStoreResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | starbucks.NearestStoreResponse | No | ||||
| data.distance_miles | number | No | ||||
| data.fetched_at | string | No | ||||
| data.found | boolean | No | Found is false when Starbucks reports no nearest store for the point at all. | |||
| data.lat | number | No | ||||
| data.lng | number | No | ||||
| data.market | string | No | ||||
| data.nearest_latitude | number | No | ||||
| data.nearest_longitude | number | No | ||||
| data.source_url | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/starbucks/nearest-store?lat=47.6062&lng=-122.3321&market=us" \
-H "x-api-key: $CRAWLORA_API_KEY"