Endpoint Playground
Searches the worldwide Starbucks store directory (dataset id `starbucks-stores`), built by grid-tiling the store locator around its 50-result cap. Each store has its store number, name, phone, full address, coordinates, weekly hours, amenity codes, and pick-up options. Store discovery is global, but hours, amenities, and phone numbers are populated per market and are largely absent outside the US, Canada, Europe, and the Gulf; an empty schedule means "not published for this market", not "closed". `country` is the store's true country while `market` is crawl provenance (the US host geocodes worldwide). Supports full-text `q`, `country`/`state`/`city`/`market`/`amenity` filters, `lat`/`lon`/`radius_m` radius filtering, and `sort` (relevance, distance_asc). Billing: this search costs 1 credit per record returned, with a minimum of 2 (an empty result costs 2, a full page of 100 costs 100). Dataset Playground requests query indexed data and do not apply proxy routing.
14 Oct 2026: 20 items; 23 fields had a value in every checked item.
Sample value profiles: first_seen_at: 2026-08-31 to 2026-09-25; amenities: median 9 entries; amenity_names: median 9 entries.
curl 'https://api.crawlora.net/api/v1/datasets/starbucks-stores/search?market=us&sort=relevance' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| q | string | No | Full-text search over store name, city, and address, max 256 characters | |
| country | string | No | ISO-3166-1 alpha-2 country filter, e.g. US, GB, JP | |
| state | string | No | State/region code filter, e.g. WA | |
| city | string | No | Exact city filter | |
| market | string | No | us | Crawl-provenance market filter. One of: us, ca |
| amenity | string | No | Amenity code filter, e.g. DT (Drive-Thru), XO (Mobile Order and Pay) | |
| lat | number | No | Latitude for radius filtering or distance sort, requires lon | |
| lon | number | No | Longitude for radius filtering or distance sort, requires lat | |
| radius_m | integer | No | Radius in meters, 1 through 50000; requires lat and lon | |
| sort | string | No | relevance | Sort enum: relevance, distance_asc |
| page | integer | No | Page number, defaults to 1 | |
| page_size | integer | No | Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000 |
{
"code": 200,
"msg": "OK",
"data": {
"dataset": "starbucks-stores",
"items": [
{
"store_number": "101-54",
"name": "Columbia Center - 4th & Cherry",
"city": "Seattle",
"state": "WA",
"country": "US",
"latitude": 47.60422,
"longitude": -122.33078,
"amenities": [
"16",
"XO",
"DT"
],
"market": "us"
}
],
"page": 1,
"page_size": 20,
"total": 1,
"sort": ""
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.