7NOW

Find 7NOW delivery stores near an address

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.

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

Query parameters

addressstring required

Free-text delivery address, street, city and state, or postal code.

Headers

x-api-keystring required

API key required

Response

OK

codeinteger

Code is the HTTP status code or a custom code used to indicate the result of the request @example 200

msgunknown

Example response

{
  "data": {
    "count": 15,
    "h3_index": "872a100d2ffffff",
    "latitude": 40.7480997,
    "longitude": -73.9849926,
    "query": "350 5th Ave, New York, NY",
    "resolved_address": "350 5th Ave, New York, NY 10118, USA",
    "stores": [
      {
        "address": "866 6TH AVE",
        "alcohol_sale_hours": [
          {
            "day": "Sunday",
            "windows": [
              {
                "end_time": "2359",
                "start_time": "0800"
              }
            ]
          }
        ],
        "brand": "7-Eleven",
        "city": "New York",
        "country": "US",
        "county": "New York County",
        "distance_miles": 0.22,
        "dma": "New York Ny",
        "latitude": 40.747508,
        "longitude": -73.989099,
        "name": "7-Eleven",
        "state": "NY",
        "store_category": "7now",
        "store_id": "39226",
        "zip": "10001"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.