Convenience and q-commerce price monitoring
Mit 7NOW-Endpunkten verwandelst du convenience and q-commerce price monitoring in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Turn 7-Eleven's 7NOW delivery data into structured JSON — address-to-store resolution, per-store keyword search, a browsable department and aisle catalog with real per-item pricing and live stock, the full discount listing with the promotion behind each price, campaign-level offers with their legal terms, bundle deals expanded into their pick-from groups, and store-independent product reference records with nutrition, ingredients, and allergens. Credential-free.
Resolve an address to nearby 7NOW stores, then search or browse that store's priced, live-availability convenience catalog as JSON.
Endpunkt-Familien
6
Dokumentierte Parameter
53
Beispiele
13
Live-Katalog-Snapshot
Aktive Endpunkte
13
Methoden
GET
Pflichtparameter
29
Schema-Referenzen
13
{
"platform": "7NOW",
"endpoint": "7now-search",
"method": "GET",
"path": "/7now/search",
"auth": "apiKey"
}Use Cases
Resolve an address to nearby 7NOW stores, then search or browse that store's priced, live-availability convenience catalog as JSON.
Mit 7NOW-Endpunkten verwandelst du convenience and q-commerce price monitoring in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Mit 7NOW-Endpunkten verwandelst du promotion and bundle-deal tracking in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Mit 7NOW-Endpunkten verwandelst du local retail assortment and stock research in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Managed Execution
Jede Zahl unten stammt direkt aus dem Live-7NOW-Endpunktkatalog — 13 Endpunkte, 53 dokumentierte Request-Parameter und 13 veröffentlichte Response-Schemas — demselben Katalog, gegen den auch Docs und Playground laufen.
13 documented 7NOW endpoints, grouped into 13 request families — Catalog, Categories and Category, plus 10 more.
53 request parameters are documented across those 7NOW endpoints, 29 of them required — the full input contract is public before you write any integration code.
13 of the 13 7NOW endpoints ship a recorded example response, and 13 carry a documented response schema — you can code against the real JSON before the first request.
7NOW endpoints document their error responses (400, 404, 429 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
13 hosted MCP tools back the 7NOW endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Abdeckungskarte
Diese Karten werden aus dem aktiven Endpunktkatalog generiert, damit die Landingpage dieselbe API-Oberfläche widerspiegelt, die auch Docs und Playground nutzen.
/7now/catalog
/7now/categories
/7now/category
/7now/combo
/7now/combos
/7now/deals
Ausgewählte Endpunkte
/7now/searchReturns one 7NOW store's keyword search results: matching products and combo deals with current pricing (list price, everyday sale price, and any further active promotion), live availability, and a sponsored-brand facet list relevant to the query. store_id comes from GET /7now/stores. A query matching nothing returns a normal 200 with an empty items array, not an error.
MCP-Tool sevennow_search
/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.
MCP-Tool sevennow_stores
/7now/catalogReturns one 7NOW store's browsable category list, a paginated item listing per catalog section (each with real per-item pricing, active promotions, calories, UPC and image), and a live active/out-of-stock inventory count for that store. store_id comes from GET /7now/stores; lat and lon are accepted but inert (store_id alone selects the store). The catalog is genuinely store-scoped, not a national price list. skip/limit page every item section uniformly (limit is capped at 50, defaults to 20).
MCP-Tool sevennow_catalog
/7now/categoriesEnumerates every value GET /7now/category accepts for a store, so callers do not have to pull the full catalog to discover them. 7NOW has two disjoint id spaces behind that one parameter: `departments` are the store's 10 permanent browsable departments (Fresh Food, Drinks, Snacks, Candy, Ice Cream, Beer & Seltzer, Tobacco, Grocery, Household, Personal Care), and `shelves` are the merchandising rows the homepage currently features ("$2 Deals", "What's New", "Only At 7-Eleven", seasonal ones). Both work as category_id. Shelves rotate with promotions and seasons, so re-read them rather than caching ids long-term. store_id comes from GET /7now/stores; lat and lon are accepted but inert (store_id alone selects the store).
MCP-Tool sevennow_categories
/7now/categoryReturns one 7NOW store's top-level category broken into its real subcategory groups (e.g. Fresh Food -> Pizza, Wings & Chicken Bites, Subs & Sandwiches, ...), each with its own paginated, priced item list and live availability, plus a category-wide availability summary. Complements GET /7now/catalog, whose per-category section is a single flat list -- this is the same data organized the way 7now.com's own category page groups it. store_id comes from GET /7now/stores and category_id from GET /7now/categories -- which accepts both the store's permanent departments and the merchandising shelves its homepage features, since 7NOW uses one parameter for two id spaces. An invalid or empty category_id returns a normal 200 with an empty subcategories array, not an error.
MCP-Tool sevennow_category
/7now/productReturns one product's complete reference record: description, the full nutrition panel (serving size, calories, fat, cholesterol, sodium, carbohydrates, protein, vitamins and allergen "contains" list), the declared ingredient list, the allergen statement, size and flavor variants, related products, and any attached promotions. product_id comes from GET /7now/search, /7now/catalog or /7now/category. This record is store-independent and deliberately carries no price, availability or stock -- use those three endpoints for per-store pricing and availability. An unknown product_id returns a 404.
MCP-Tool sevennow_product
Verwandte APIs
Marketplaces & Retail
Collect marketplace product signals from Amazon without building brittle storefront scrapers.
Marketplaces & Retail
Build resale, pricing, and marketplace workflows from structured eBay data.
Marketplaces & Retail
Turn public Shop.app product and merchant pages into structured JSON for e-commerce product intelligence, price research, shop monitoring, and marketplace discovery workflows.
So scrapst du 7NOW
Crawlora's 7NOW endpoints return normalized public 7-Eleven delivery data as JSON with one API key — no 7NOW account required. Almost everything here is store-scoped: pricing, availability, deals, and bundles are all genuinely per-store, so a store id is the first thing to resolve.
Pass a free-text address, street, city and state, or postal code as address to the stores endpoint. It runs 7now.com's own address autocomplete then its nearby-store lookup, returning the resolved address, its coordinates and H3 cell, and the nearest 7NOW-enabled stores with distance, banner, Nielsen DMA, and each store's own alcohol-sale windows. Every other endpoint takes the store_id it returns.
Pass store_id plus a keyword q to the search endpoint for matching products and combo deals with list price, everyday sale price, any further active promotion, and live availability. To walk the whole assortment instead, use the catalog endpoint for a paginated section-by-section listing, or the categories endpoint to enumerate every category id the store accepts before browsing one with the category endpoint, which splits it into its real subcategory groups.
The deals endpoint reads discount-to-item — every currently discounted item in the store with the promotion driving its price, its shopper-facing description such as 2 for $4, and the offer's run dates. The promotion endpoint reads it the other way round: give it one promotion id and it expands to every item that promotion covers. The offers endpoint is the campaign-level view, returning the headline, body copy, legal terms, and artwork behind an advertised offer.
The combos endpoint lists a store's bundle deals — the fixed-price builders where one pick comes from each of several groups. Keyword search only surfaces a bundle when a query happens to match it, so this is the only way to enumerate them. Pass a bundle id to the combo endpoint for its pick-from groups, how many items each group takes, and every eligible item with live pricing.
The product endpoint returns one product's full reference record: description, nutrition panel, declared ingredient list, allergen statement, size and flavor variants, related products, and attached promotions. This record deliberately carries no price or stock — 7NOW does not serve those with the product record, so pair it with a store-scoped search or catalog call for the commercial fields.
FAQ
Resolve a delivery address to nearby stores first, then pass the store_id to the search or catalog endpoints for that store's priced assortment, to deals, offers and promotion for its discounts, and to combos for its bundle builders — all return structured JSON with one API key.
Genuinely per-store. The catalog, search results, deals, offers and combos are all scoped to a store_id, and prices and availability differ between stores. The one deliberately store-independent record is the product reference endpoint, which carries nutrition, ingredients and allergens but no price or stock at all.
Use the combos endpoint. Keyword search surfaces a bundle only when the query happens to match one, so it cannot enumerate them; combos returns the full list, and the combo endpoint then expands one bundle into its pick-from groups and every eligible item with live pricing.
Yes — each store in the stores response carries alcohol_sale_hours[], upstream's own encoding of the local law as one entry per weekday with its permitted windows. An empty array means 7NOW publishes no windows for that store, which is not the same as the store selling no alcohol.
Two disjoint id spaces, both valid: the store's permanent browsable departments, and the promotional/seasonal rails 7NOW rotates through its own app. The categories endpoint enumerates every value one store accepts, so you do not have to pull the entire catalog to discover them.