Docs menu

7NOW API endpoint

7NOW Promotion API

Expands one promotion into every item it applies to in a store, plus the promotion's own offer type, terms, and run dates. GET /7now/deals reads discount-to-item (here is a discounted product, here is why); this reads it the other way round (here is an offer, here is everything it covers) -- e.g. a "2 for $4" tea promotion expands to all five flavours in it. promo_id comes from GET /7now/deals' items[].promos[].id, and store_id from GET /7now/stores. An unknown promo_id returns 404.

GETapiKey1 credit/request7NOWsevennow.promotionResponseDoc/7now/promotion

Endpoint facts

Method: GET
API path: /7now/promotion
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: 7NOW
Response schema: #/definitions/sevennow.promotionResponseDoc

7NOW API Try 7NOW Promotion API in Playground 7NOW API documentation

How this endpoint behaves

Query parameters:

promo_id (required) — promotion id, from GET /7now/deals' items[].promos[].id, e.g. 6a9746d488cc35e1bbff1584.
store_id (required) — 7NOW store id, from GET /7now/stores, e.g. 39640.
skip (optional) — pagination offset. Defaults to 0.
limit (optional) — max items returned, 1-100. Defaults to 20.

Response includes promo_id and store_id (echoed back), promotion, items[], total, count, has_more, skip, limit, source_url, and fetched_at.

promotion carries id, name (upstream's internal campaign name — a stable identifier, not shopper-facing copy), short_description, long_description, offer_type, promo_type, display_priority, start_date, expiration_date, mark_down_slins, terms[], and promo_price_cents (omitted for multi-buy offers with no single-unit price).

items[] uses the same item shape as GET /7now/deals: product_id, name, brand, category, category_id, subcategory, upc, calories, image_url, price_cents, promos[], available, available_quantity, and age_restricted.

Sampled response

Request, 14 Oct 2026: GET /7now/promotion?promo_id=6a7a8828799d2f2e9764f254&store_id=39226&limit=20
Items in items: 1
Fields filled in every checked item: 14

Field	Filled in, of 1 checked	Values in the sample
product_id	1
name	1	“Brisk Sweet Tea w Lemon 1L”
brand	1	“Brisk”
category	1	“Drinks”
category_id	1
subcategory	1	“Tea”
upc	1
calories	1	70
image_url	1	deuktbth81ifn.cloudfront.net
price_cents	1	289
promos	1	median 1 entry
available	1	true in 1 of 1
available_quantity	1	19
age_restricted	1	true in 0 of 1

Request parameters

Parameter	Type	Required	Default	Description	Example
promo_id	string	Yes		Promotion id, from GET /7now/deals' items[].promos[].id.	6a9746d488cc35e1bbff1584
store_id	string	Yes		7NOW store id, from GET /7now/stores.	39640
skip	integer	No	0	Pagination offset. Defaults to 0.	0
limit	integer	No	20	Max items returned, 1-100. Defaults to 20.	20
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/7now/promotion?promo_id=6a9746d488cc35e1bbff1584&store_id=39640&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "promo_id": "6a7a8828799d2f2e9764f254",
    "store_id": "39640",
    "promotion": {
      "id": "6a7a8828799d2f2e9764f254",
      "name": "US_7NOW_Brisk 1L: 2/$4.00 (ALL ST)",
      "short_description": "2 for $4",
      "long_description": "Item must be added to cart for discount to apply. Limit 10 offers per order.",
      "offer_type": "item_discount",
      "promo_type": "item",
      "start_date": "2026-08-26T00:00:00.000Z",
      "expiration_date": "2026-10-27T23:59:59.000Z",
      "mark_down_slins": [
        "644951"
      ]
    },
    "items": [
      {
        "product_id": "240622-0-1",
        "name": "Brisk Sweet Tea w Lemon 1L",
        "brand": "Brisk",
        "category": "Drinks",
        "category_id": "48395",
        "subcategory": "Tea",
        "upc": "00012000724695",
        "calories": "70",
        "image_url": "https://deuktbth81ifn.cloudfront.net/7now/US/240622-0-1/2aee2f10c234b9788e7271ae51695c376f691ecd.jpg",
        "price_cents": 329,
        "promos": [
          {
            "id": "6a7a8828799d2f2e9764f254",
            "short_description": "2 for $4",
            "promo_type": "item",
            "start_date": "08/26/2026",
            "expiration_date": "10/27/2026"
          }
        ],
        "available": true,
        "available_quantity": 25,
        "age_restricted": false
      }
    ],
    "total": 5,
    "count": 1,
    "has_more": true,
    "skip": 0,
    "limit": 20,
    "source_url": "https://www.7now.com/api/bff/unified-catalog/v1/content/promo/items?promo_id=6a7a8828799d2f2e9764f254&store_id=39640&skip=0&limit=20",
    "fetched_at": "2026-09-06T04:10:00Z"
  }
}

Request schema

No body schema

Response schema

#/definitions/sevennow.promotionResponseDoc

Field	Type	Required	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.PromotionResponse	No
data.count	integer	No	14
data.fetched_at	string	No
data.has_more	boolean	No	false
data.items	array	No		DealItem record, 21 fields: age_restricted, available, available_quantity, brand, calories, category, category_id, image_url, name, price_cents, product_id, promos and 2 more. Described under 7NOW Deals API.
data.limit	integer	No	20
data.promo_id	string	No	6a9746d488cc35e1bbff1584
data.promotion	sevennow.PromotionDetail	No
data.promotion.display_priority	integer	No	2
data.promotion.expiration_date	string	No	2026-10-27T23:59:59.000Z
data.promotion.id	string	No	6a9746d488cc35e1bbff1584
data.promotion.long_description	string	No
data.promotion.mark_down_slins	array	No
data.promotion.name	string	No	US_7N_Ben & Jerry's Pints $7_(9/1/2026-10/27/2026) - FOR 7NOW
data.promotion.offer_type	string	No	item_discount
data.promotion.promo_price_cents	integer	No	700
data.promotion.promo_type	string	No	item
data.promotion.short_description	string	No	On Sale $7
data.promotion.start_date	string	No	2026-09-01T00:00:00.000Z
data.promotion.terms	array	No
data.skip	integer	No	0
data.source_url	string	No
data.store_id	string	No	39640
data.total	integer	No	14
msg	unknown	No		Msg is the message that describes the result of the request @example "Request successful"

Failure responses

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 examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/7now/promotion?promo_id=6a9746d488cc35e1bbff1584&store_id=39640&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More 7NOW endpoint docs 7NOW API 7NOW Catalog API documentation 7NOW Categories API documentation 7NOW Category API documentation 7NOW Combo API documentation 7NOW Combos API documentation 7NOW Deals API documentation

Open in Playground Back to group

Docs menu

7NOW API endpoint

7NOW Promotion API

GETapiKey1 credit/request7NOWsevennow.promotionResponseDoc/7now/promotion

Endpoint facts

Method: GET
API path: /7now/promotion
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: 7NOW
Response schema: #/definitions/sevennow.promotionResponseDoc

7NOW API Try 7NOW Promotion API in Playground 7NOW API documentation

How this endpoint behaves

Query parameters:

promo_id (required) — promotion id, from GET /7now/deals' items[].promos[].id, e.g. 6a9746d488cc35e1bbff1584.
store_id (required) — 7NOW store id, from GET /7now/stores, e.g. 39640.
skip (optional) — pagination offset. Defaults to 0.
limit (optional) — max items returned, 1-100. Defaults to 20.

Response includes promo_id and store_id (echoed back), promotion, items[], total, count, has_more, skip, limit, source_url, and fetched_at.

Sampled response

Request, 14 Oct 2026: GET /7now/promotion?promo_id=6a7a8828799d2f2e9764f254&store_id=39226&limit=20
Items in items: 1
Fields filled in every checked item: 14

Field	Filled in, of 1 checked	Values in the sample
product_id	1
name	1	“Brisk Sweet Tea w Lemon 1L”
brand	1	“Brisk”
category	1	“Drinks”
category_id	1
subcategory	1	“Tea”
upc	1
calories	1	70
image_url	1	deuktbth81ifn.cloudfront.net
price_cents	1	289
promos	1	median 1 entry
available	1	true in 1 of 1
available_quantity	1	19
age_restricted	1	true in 0 of 1

Request parameters

Parameter	Type	Required	Default	Description	Example
promo_id	string	Yes		Promotion id, from GET /7now/deals' items[].promos[].id.	6a9746d488cc35e1bbff1584
store_id	string	Yes		7NOW store id, from GET /7now/stores.	39640
skip	integer	No	0	Pagination offset. Defaults to 0.	0
limit	integer	No	20	Max items returned, 1-100. Defaults to 20.	20
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/7now/promotion?promo_id=6a9746d488cc35e1bbff1584&store_id=39640&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "promo_id": "6a7a8828799d2f2e9764f254",
    "store_id": "39640",
    "promotion": {
      "id": "6a7a8828799d2f2e9764f254",
      "name": "US_7NOW_Brisk 1L: 2/$4.00 (ALL ST)",
      "short_description": "2 for $4",
      "long_description": "Item must be added to cart for discount to apply. Limit 10 offers per order.",
      "offer_type": "item_discount",
      "promo_type": "item",
      "start_date": "2026-08-26T00:00:00.000Z",
      "expiration_date": "2026-10-27T23:59:59.000Z",
      "mark_down_slins": [
        "644951"
      ]
    },
    "items": [
      {
        "product_id": "240622-0-1",
        "name": "Brisk Sweet Tea w Lemon 1L",
        "brand": "Brisk",
        "category": "Drinks",
        "category_id": "48395",
        "subcategory": "Tea",
        "upc": "00012000724695",
        "calories": "70",
        "image_url": "https://deuktbth81ifn.cloudfront.net/7now/US/240622-0-1/2aee2f10c234b9788e7271ae51695c376f691ecd.jpg",
        "price_cents": 329,
        "promos": [
          {
            "id": "6a7a8828799d2f2e9764f254",
            "short_description": "2 for $4",
            "promo_type": "item",
            "start_date": "08/26/2026",
            "expiration_date": "10/27/2026"
          }
        ],
        "available": true,
        "available_quantity": 25,
        "age_restricted": false
      }
    ],
    "total": 5,
    "count": 1,
    "has_more": true,
    "skip": 0,
    "limit": 20,
    "source_url": "https://www.7now.com/api/bff/unified-catalog/v1/content/promo/items?promo_id=6a7a8828799d2f2e9764f254&store_id=39640&skip=0&limit=20",
    "fetched_at": "2026-09-06T04:10:00Z"
  }
}

Request schema

No body schema

Response schema

#/definitions/sevennow.promotionResponseDoc

Field	Type	Required	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.PromotionResponse	No
data.count	integer	No	14
data.fetched_at	string	No
data.has_more	boolean	No	false
data.items	array	No		DealItem record, 21 fields: age_restricted, available, available_quantity, brand, calories, category, category_id, image_url, name, price_cents, product_id, promos and 2 more. Described under 7NOW Deals API.
data.limit	integer	No	20
data.promo_id	string	No	6a9746d488cc35e1bbff1584
data.promotion	sevennow.PromotionDetail	No
data.promotion.display_priority	integer	No	2
data.promotion.expiration_date	string	No	2026-10-27T23:59:59.000Z
data.promotion.id	string	No	6a9746d488cc35e1bbff1584
data.promotion.long_description	string	No
data.promotion.mark_down_slins	array	No
data.promotion.name	string	No	US_7N_Ben & Jerry's Pints $7_(9/1/2026-10/27/2026) - FOR 7NOW
data.promotion.offer_type	string	No	item_discount
data.promotion.promo_price_cents	integer	No	700
data.promotion.promo_type	string	No	item
data.promotion.short_description	string	No	On Sale $7
data.promotion.start_date	string	No	2026-09-01T00:00:00.000Z
data.promotion.terms	array	No
data.skip	integer	No	0
data.source_url	string	No
data.store_id	string	No	39640
data.total	integer	No	14
msg	unknown	No		Msg is the message that describes the result of the request @example "Request successful"

Failure responses

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 examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/7now/promotion?promo_id=6a9746d488cc35e1bbff1584&store_id=39640&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

7NOW Promotion API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

7NOW Promotion API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related