Datasets API endpoint
Returns one stored Starbucks store by its store number (e.g. `101-54`) from dataset id `starbucks-stores`. `country` is the store's true country while `market` is crawl provenance. Hours (`schedule`) and `amenities` may be empty for stores outside the US, Canada, Europe, and the Gulf; an empty schedule means "not published for this market", not "closed".
/datasets/starbucks-stores/items/{store_number}Dataset id enum:
starbucks-storesPath parameters:
store_number: the Starbucks store number, e.g. 101-54.| Field | In the sample | Value in the sample |
|---|---|---|
| id | Has a value | |
| store_number | Has a value | |
| store_id | Has a value | |
| name | Has a value | |
| phone | Has a value | |
| address | Has a value | |
| city | Has a value | |
| state | Has a value | |
| postal_code | Has a value | |
| country | Has a value | |
| location.lat | Has a value | |
| location.lon | Has a value | |
| latitude | Has a value | |
| longitude | Has a value | |
| time_zone | Has a value | |
| ownership_type_code | Has a value | |
| mobile_ordering_availability | Has a value | |
| amenities | Has a value | 7 entries |
| amenity_names | Has a value | 7 entries |
| pick_up_options | Has a value | 1 entry |
| first_seen_at | Has a value | 2026-08-31 |
| last_seen_at | Has a value | 2026-10-03 |
| crawled_at | Has a value | 2026-10-03 |
| schema_version | Has a value |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| store_number (path) | string | Yes | Starbucks store number, e.g. 101-54 | 101-54 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/datasets/starbucks-stores/items/101-54" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"store_number": "101-54",
"name": "Columbia Center - 4th & Cherry",
"phone": "+1 206-447-9934",
"address": "701 Fifth Ave",
"city": "Seattle",
"state": "WA",
"postal_code": "98104",
"country": "US",
"latitude": 47.60422,
"longitude": -122.33078,
"amenities": [
"16",
"XO",
"DT"
],
"market": "us"
}
}Request schema
No body schema
Response schema
#/definitions/datasets.starbucksStoreResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | es.StarbucksStoreRecord | No | ||||
| data.address | string | No | ||||
| data.amenities | array | No | ||||
| data.amenity_names | array | No | ||||
| data.city | string | No | ||||
| data.country | string | No | ||||
| data.crawled_at | string | No | ||||
| data.first_seen_at | string | No | ||||
| data.id | string | No | ||||
| data.last_seen_at | string | No | ||||
| data.latitude | number | No | ||||
| data.location | object | No | Location is a geo_point ([lon, lat] order in the GeoPoint helper). | |||
| data.location.lat | number | No | Latitude in decimal degrees. | |||
| data.location.lon | number | No | Longitude in decimal degrees. | |||
| data.longitude | number | No | ||||
| data.market | string | No | Market is crawl provenance (us/ca), not geography -- see the type doc. | |||
| data.mobile_ordering_availability | string | No | ||||
| data.name | string | No | ||||
| data.ownership_type_code | string | No | ||||
| data.phone | string | No | ||||
| data.pick_up_options | array | No | ||||
| data.postal_code | string | No | ||||
| data.run_id | string | No | ||||
| data.schema_version | integer | No | ||||
| data.state | string | No | ||||
| data.store_id | string | No | ||||
| data.store_number | string | No | ||||
| data.time_zone | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/datasets/starbucks-stores/items/101-54" \
-H "x-api-key: $CRAWLORA_API_KEY"