---
title: "Find nearby stored Starbucks stores"
method: GET
path: "/datasets/starbucks-stores/nearby"
tags: ["Datasets"]
---

# Find nearby stored Starbucks stores

`GET /datasets/starbucks-stores/nearby`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/datasets/starbucks-stores/nearby`
- Auth: API key in header `x-api-key`

Returns stored Starbucks stores within a radius of a point, nearest first, from dataset id `starbucks-stores`. lat, lon, and radius_m are required. Unlike the live /starbucks/stores endpoint (which caps at 50 near a point), this queries the full grid-tiled directory, so it can return every store in the radius. Billing: this endpoint costs 1 credit per record returned, with a minimum of 2 (an empty result costs 2, a full page of 100 costs 100).

## Query parameters

- `lat` number, required
- `lon` number, required
- `radius_m` integer, required
- `country` string
- `amenity` string
- `page` integer
- `page_size` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- DatasetsStarbucksStoresSearchResponseDoc
  - `code` integer
  - `data` DatasetsStarbucksStoreSearchResponse
    - `dataset` string
    - `items` EsStarbucksStoreDatasetItem[]
      - `address` string
      - `amenities` string[]
      - `amenity_names` string[]
      - `city` string
      - `country` string
      - `crawled_at` string
      - `distance_meters` number
      - `first_seen_at` string
      - `id` string
      - `last_seen_at` string
      - `latitude` number
      - `location` EsGeoPoint
        - `lat` number: Latitude in decimal degrees.
        - `lon` number: Longitude in decimal degrees.
      - `longitude` number
      - `market` string: Market is crawl provenance (us/ca), not geography -- see the type doc.
      - `mobile_ordering_availability` string
      - `name` string
      - `ownership_type_code` string
      - `phone` string
      - `pick_up_options` string[]
      - `postal_code` string
      - `run_id` string
      - `schema_version` integer
      - `state` string
      - `store_id` string
      - `store_number` string
      - `time_zone` string
    - `page` integer
    - `page_size` integer
    - `sort` string
    - `total` integer
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)