7NOW API endpoint
Use Crawlora's 7NOW Stores API to extract supported public 7NOW data as structured JSON. This page includes request parameters, cURL examples, response schema, error behavior, credit cost, and a Playground link for testing before integration.
/7now/storesResolves 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. Developers commonly use this endpoint for data enrichment, monitoring, research dashboards, internal automation, and agent-native workflows that need repeatable structured public web data. Authentication uses the documented Crawlora headers, and usage is metered with the credit cost shown on this page.
Request parameters are generated from the active endpoint catalog. Required values must be sent before Crawlora can call the upstream public web data source.
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| address | string | Yes | Free-text delivery address, street, city and state, or postal code. | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/7now/stores" \ -H "x-api-key: $CRAWLORA_API_KEY"
Send your scraping API key in the x-api-key header. Use the console API Keys page to rotate or select the active key.
Endpoint usage is metered in credits. The plan prices, included credits, limits, and overage rates below match the active backend billing configuration.
| Plan | Price | Included credits | Daily cap | Rate limit | Overage |
|---|---|---|---|---|---|
| Free | $0/mo | 2,000 | 500 daily credits | 5/min | No overage |
| Starter | $9/mo | 20,000 | 5,000 daily credits | 15/min | $0.75/1,000 overage credits when enabled |
| Growth | $29/mo | 100,000 | 25,000 daily credits | 45/min | $0.45/1,000 overage credits when enabled |
| Pro | $79/mo | 400,000 | No daily cap | 120/min | $0.30/1,000 overage credits |
| Business | $199/mo | 1,200,000 | No daily cap | 300/min | $0.20/1,000 overage credits |
| Enterprise | $499/mo | 5,000,000 | No daily cap | 1,000/min | $0.12/1,000 overage credits |
This endpoint is executed through Crawlora's managed scraping infrastructure.
Crawlora does not silently return bad data when the upstream page cannot be used.
| Status | Common failure case |
|---|---|
| 400 | Invalid input or missing required parameter |
| 429 | Plan or endpoint rate limit exceeded |
| 500 | Internal execution error |
| 502 | Upstream platform failed, returned unusable HTML, or served a challenge page that could not be resolved |
When possible, Crawlora returns structured error context so your integration can retry, back off, or inspect the request.
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
{
"code": 200,
"msg": "OK",
"data": {
"query": "350 5th Ave, New York, NY",
"resolved_address": "350 5th Ave, New York, NY 10118, USA",
"latitude": 40.7480997,
"longitude": -73.9849926,
"h3_index": "872a100d2ffffff",
"stores": [
{
"store_id": "39226",
"name": "7-Eleven",
"address": "866 6TH AVE",
"city": "New York",
"state": "NY",
"zip": "10001",
"county": "New York County",
"country": "US",
"latitude": 40.747508,
"longitude": -73.989099,
"distance_miles": 0.22,
"store_category": "7now",
"brand": "7-Eleven",
"brand_logo_url": "https://d1se8uetpsj0rs.cloudfront.net/media/StoreBrands/711_96.png",
"dma": "New York Ny",
"alcohol_sale_hours": [
{
"day": "Sunday",
"windows": [
{
"start_time": "0000",
"end_time": "0200"
},
{
"start_time": "0800",
"end_time": "2359"
}
]
},
{
"day": "Monday",
"windows": [
{
"start_time": "0000",
"end_time": "2359"
}
]
}
]
}
],
"count": 13,
"source_url": "https://www.7now.com/api/bff/location-services/getAddress",
"fetched_at": "2026-09-05T19:25:33Z"
}
}Request schema
No body schema
Response schema
#/definitions/sevennow.storesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | Code is the HTTP status code or a custom code used to indicate the result of the request @example 200 | |||
| data | sevennow.StoresResponse | No | ||||
| data.count | integer | No | 15 | |||
| data.fetched_at | string | No | ||||
| data.h3_index | string | No | 872a100d2ffffff | 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. | ||
| data.latitude | number | No | 40.7480997 | |||
| data.longitude | number | No | -73.9849926 | |||
| data.query | string | No | 350 5th Ave, New York, NY | |||
| data.resolved_address | string | No | 350 5th Ave, New York, NY 10118, USA | |||
| data.source_url | string | No | ||||
| data.stores | array | No | ||||
| data.stores[].address | string | No | 866 6TH AVE | |||
| data.stores[].alcohol_sale_hours | array | No | 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. | |||
| data.stores[].alcohol_sale_hours[].day | string | No | Sunday | |||
| data.stores[].alcohol_sale_hours[].windows | array | No | Windows are that day's permitted selling periods. More than one means the day is split, as New York's Sunday rule does. | |||
| data.stores[].alcohol_sale_hours[].windows[].end_time | string | No | 2359 | |||
| data.stores[].alcohol_sale_hours[].windows[].start_time | string | No | 0800 | |||
| data.stores[].brand | string | No | 7-Eleven | 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. | ||
| data.stores[].brand_logo_url | string | No | ||||
| data.stores[].city | string | No | New York | |||
| data.stores[].country | string | No | US | |||
| data.stores[].county | string | No | New York County | |||
| data.stores[].distance_miles | number | No | 0.22 | |||
| data.stores[].dma | string | No | New York Ny | 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. | ||
| data.stores[].latitude | number | No | 40.747508 | |||
| data.stores[].longitude | number | No | -73.989099 | |||
| data.stores[].name | string | No | 7-Eleven | |||
| data.stores[].state | string | No | NY | |||
| data.stores[].store_category | string | No | 7now | |||
| data.stores[].store_id | string | No | 39226 | |||
| data.stores[].zip | string | No | 10001 | |||
| msg | unknown | No | Msg is the message that describes the result of the request @example "Request successful" |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/7now/stores" \
-H "x-api-key: $CRAWLORA_API_KEY"Crawlora is designed for responsible structured public web data workflows. Customers are responsible for using Crawlora in compliance with applicable laws, third-party rights, target-platform rules, and Crawlora terms.
Read Crawlora terms