---
title: "Find 7NOW delivery stores near an address"
method: GET
path: "/7now/stores"
tags: ["7NOW"]
---

# Find 7NOW delivery stores near an address

`GET /7now/stores`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/7now/stores`
- Auth: API key in header `x-api-key`

Resolves a free-text delivery address, street, city and state, or postal code to the nearest 7NOW-enabled 7-Eleven stores, nearest first. Each store carries its store_id, address, coordinates, straight-line distance in miles from the resolved address, the banner it trades under, its Nielsen DMA, and its per-day alcohol sale windows -- upstream's own encoding of the local law, which is why a day can hold more than one window (a New York store's Sunday runs 0000-0200 and 0800-2359). An empty alcohol_sale_hours means upstream publishes no windows for that store, which is not the same as it selling no alcohol. The response also carries the Uber H3 cell for the resolved address. Use store_id with GET /7now/catalog, /7now/categories, /7now/deals, /7now/offers or /7now/combos to browse that store. An address that cannot be geocoded, or one with no nearby 7NOW coverage, returns a 404.

## Query parameters

- `address` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SevennowStoresResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` SevennowStoresResponse
    - `count` integer
    - `fetched_at` string
    - `h3_index` string: H3Index is the Uber H3 cell (resolution 7) upstream assigns to the resolved address -- a stable geospatial key for grouping or caching lookups by area.
    - `latitude` number
    - `longitude` number
    - `query` string
    - `resolved_address` string
    - `source_url` string
    - `stores` SevennowStore[]
      - `address` string
      - `alcohol_sale_hours` SevennowStoreAlcoholDay[]: AlcoholSaleHours are the windows during which the store may sell alcohol, per day of week -- upstream's own encoding of the local law. A New York store, for instance, reports Sunday as two windows (00:00-02:00 and 08:00-23:59) and every other day as one. An empty list means upstream publishes no windows for this store. That is not the same as "sells no alcohol": Austin, TX stores return an empty list while New York stores return a full week.
        - `day` string
        - `windows` SevennowStoreAlcoholWindow[]: Windows are that day's permitted selling periods. More than one means the day is split, as New York's Sunday rule does.
          - `end_time` string
          - `start_time` string
      - `brand` string: Brand is the banner the store trades under. 7-Eleven operates several (Speedway, Stripes); every store measured so far reports "7-Eleven", so treat a different value as possible rather than impossible.
      - `brand_logo_url` string
      - `city` string
      - `country` string
      - `county` string
      - `distance_miles` number
      - `dma` string: DMA is the Nielsen Designated Market Area the store sits in, e.g. "New York Ny", "Austin Tx". It groups stores by media market rather than by state or county.
      - `latitude` number
      - `longitude` number
      - `name` string
      - `state` string
      - `store_category` string
      - `store_id` string
      - `zip` string
  - `msg` unknown

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[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/0497899e2016?raw)