Docs menu

7NOW API endpoint

7NOW Combo API

Expands one bundle deal into its structure: each pick-from group's name, how many items the shopper picks from it, and every eligible item with live pricing and availability -- e.g. the "$6.99 Pizza" bundle returns one group, "Eligible Whole Pizzas", holding six priced pizzas. Also returns the bundle's shopper-facing headline and full legal terms. promo_id comes from GET /7now/combos' combos[].promo_id, and store_id from GET /7now/stores. The upstream also accepts a plain item-discount promotion id but answers one with unnamed groups -- for those, GET /7now/promotion's flat item list is the right endpoint. An unknown promo_id returns 404.

GETapiKey1 credit/request7NOWsevennow.comboResponseDoc/7now/combo

Endpoint facts

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

7NOW API Try 7NOW Combo API in Playground 7NOW API documentation

How this endpoint behaves

Query parameters:

promo_id (required) — promotion id, from GET /7now/combos' combos[].promo_id, e.g. 6a849a8fa1df2409010c719f.
store_id (required) — 7NOW store id, from GET /7now/stores, e.g. 39640.

Response includes promo_id and store_id (echoed back), terms, groups[], count (number of pick-from groups), source_url, and fetched_at.

terms carries title, description, and legal_terms.

Each entry in groups[] carries name, is_primary, quantity (how many items the shopper picks from that group), and items[]. Items use the same 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/combo?promo_id=6a849a8fa1df2409010c719f&store_id=39226
Items in groups: 1
Fields filled in every checked item: 4

Field	Filled in, of 1 checked	Values in the sample
name	1	“Eligible Whole Pizzas”
is_primary	1	true in 1 of 1
quantity	1	1
items	1	median 4 entries

Request parameters

Parameter	Type	Required	Description	Example
promo_id	string	Yes	Promotion id, from GET /7now/combos' combos[].promo_id.	6a849a8fa1df2409010c719f
store_id	string	Yes	7NOW store id, from GET /7now/stores.	39640
x-api-key (header)	string	Yes	API key required

cURL example

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

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "promo_id": "6a849a8fa1df2409010c719f",
    "store_id": "39640",
    "terms": {
      "title": "$6.99 Pizza",
      "description": "Any Whole Pizza $6.99 each",
      "legal_terms": "Item must be added to cart for discount to apply. Limit 10 offers per order."
    },
    "groups": [
      {
        "name": "Eligible Whole Pizzas",
        "is_primary": true,
        "quantity": 1,
        "items": [
          {
            "product_id": "178322-2-6-2",
            "name": "Large Pizza - Ultimate Pepperoni",
            "brand": "Hot Food Pizza",
            "category": "Fresh Food",
            "category_id": "48423",
            "subcategory": "Pizza",
            "upc": "00052548537524",
            "calories": "360",
            "image_url": "https://deuktbth81ifn.cloudfront.net/7now/US/178322-2-6-2/wghjlebnc3luzvgqmpvz.jpg",
            "price_cents": 1099,
            "promos": [],
            "available": true,
            "available_quantity": 56,
            "age_restricted": false
          }
        ]
      }
    ],
    "count": 1,
    "source_url": "https://www.7now.com/api/bff/unified-catalog/v1/content/promo/combo?promoId=6a849a8fa1df2409010c719f&storeId=39640",
    "fetched_at": "2026-09-06T04:40:00Z"
  }
}

Request schema

No body schema

Response schema

#/definitions/sevennow.comboResponseDoc

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.ComboResponse	No
data.count	integer	No	1
data.fetched_at	string	No
data.groups	array	No
data.groups[].is_primary	boolean	No	true
data.groups[].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.groups[].name	string	No	Eligible Whole Pizzas
data.groups[].quantity	integer	No	1
data.promo_id	string	No	6a849a8fa1df2409010c719f
data.source_url	string	No
data.store_id	string	No	39640
data.terms	sevennow.ComboTerms	No
data.terms.description	string	No	Any Whole Pizza $6.99 each
data.terms.legal_terms	string	No
data.terms.title	string	No	$6.99 Pizza
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/combo?promo_id=6a849a8fa1df2409010c719f&store_id=39640" \
  -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 Combos API documentation 7NOW Deals API documentation 7NOW Offers API documentation

Open in Playground Back to group

Docs menu

7NOW API endpoint

7NOW Combo API

GETapiKey1 credit/request7NOWsevennow.comboResponseDoc/7now/combo

Endpoint facts

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

7NOW API Try 7NOW Combo API in Playground 7NOW API documentation

How this endpoint behaves

Query parameters:

promo_id (required) — promotion id, from GET /7now/combos' combos[].promo_id, e.g. 6a849a8fa1df2409010c719f.
store_id (required) — 7NOW store id, from GET /7now/stores, e.g. 39640.

Response includes promo_id and store_id (echoed back), terms, groups[], count (number of pick-from groups), source_url, and fetched_at.

terms carries title, description, and legal_terms.

Sampled response

Request, 14 Oct 2026: GET /7now/combo?promo_id=6a849a8fa1df2409010c719f&store_id=39226
Items in groups: 1
Fields filled in every checked item: 4

Field	Filled in, of 1 checked	Values in the sample
name	1	“Eligible Whole Pizzas”
is_primary	1	true in 1 of 1
quantity	1	1
items	1	median 4 entries

Request parameters

Parameter	Type	Required	Description	Example
promo_id	string	Yes	Promotion id, from GET /7now/combos' combos[].promo_id.	6a849a8fa1df2409010c719f
store_id	string	Yes	7NOW store id, from GET /7now/stores.	39640
x-api-key (header)	string	Yes	API key required

cURL example

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

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "promo_id": "6a849a8fa1df2409010c719f",
    "store_id": "39640",
    "terms": {
      "title": "$6.99 Pizza",
      "description": "Any Whole Pizza $6.99 each",
      "legal_terms": "Item must be added to cart for discount to apply. Limit 10 offers per order."
    },
    "groups": [
      {
        "name": "Eligible Whole Pizzas",
        "is_primary": true,
        "quantity": 1,
        "items": [
          {
            "product_id": "178322-2-6-2",
            "name": "Large Pizza - Ultimate Pepperoni",
            "brand": "Hot Food Pizza",
            "category": "Fresh Food",
            "category_id": "48423",
            "subcategory": "Pizza",
            "upc": "00052548537524",
            "calories": "360",
            "image_url": "https://deuktbth81ifn.cloudfront.net/7now/US/178322-2-6-2/wghjlebnc3luzvgqmpvz.jpg",
            "price_cents": 1099,
            "promos": [],
            "available": true,
            "available_quantity": 56,
            "age_restricted": false
          }
        ]
      }
    ],
    "count": 1,
    "source_url": "https://www.7now.com/api/bff/unified-catalog/v1/content/promo/combo?promoId=6a849a8fa1df2409010c719f&storeId=39640",
    "fetched_at": "2026-09-06T04:40:00Z"
  }
}

Request schema

No body schema

Response schema

#/definitions/sevennow.comboResponseDoc

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.ComboResponse	No
data.count	integer	No	1
data.fetched_at	string	No
data.groups	array	No
data.groups[].is_primary	boolean	No	true
data.groups[].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.groups[].name	string	No	Eligible Whole Pizzas
data.groups[].quantity	integer	No	1
data.promo_id	string	No	6a849a8fa1df2409010c719f
data.source_url	string	No
data.store_id	string	No	39640
data.terms	sevennow.ComboTerms	No
data.terms.description	string	No	Any Whole Pizza $6.99 each
data.terms.legal_terms	string	No
data.terms.title	string	No	$6.99 Pizza
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/combo?promo_id=6a849a8fa1df2409010c719f&store_id=39640" \
  -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 Combo API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

7NOW Combo API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related