Endpoint Playground
Test Crawlora's Search the Starbucks store directory API with realistic prefilled filters. Generate a cURL request, inspect stored structured JSON records, and open the full docs or pricing page when you are ready to integrate dataset search. Dataset Playground requests query indexed data and do not apply proxy routing.
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": ""
}
}Public Playground
Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.
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). Dataset endpoints are built for repeatable structured search, facets, geo queries, pagination, and item lookup over indexed records. They do not trigger live scraping or proxy routing.
{
"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": ""
}
}curl "https://api.crawlora.net/api/v1/datasets/starbucks-stores/search" \
-H "x-api-key: $CRAWLORA_API_KEY"