Endpoint Playground

Try the 7NOW Promotion API

Test Crawlora's 7NOW Promotion API with realistic prefilled parameters. Generate a cURL request, inspect the expected structured JSON response, and open the full docs or pricing page when you are ready to integrate this public web data extraction endpoint into your application.

Endpoint facts

Method: GET
API path: /7now/promotion
Platform: 7NOW
Auth: apiKey
Credits: 1 credit/request
Required params: promo_id, store_id
Common optional params: skip, limit

7NOW Promotion API documentation 7NOW platform page Crawlora API pricing Try 7NOW Catalog API Try 7NOW Categories API Try 7NOW Category API Try 7NOW Combo API Try 7NOW Combos API

Prefilled cURL

curl "https://api.crawlora.net/api/v1/7now/promotion?promo_id=<promo_id>&store_id=<store_id>" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Description
promo_id	string	Yes	Promotion id, from GET /7now/deals' items[].promos[].id.
store_id	string	Yes	7NOW store id, from GET /7now/stores.
skip	integer	No	Pagination offset. Defaults to 0.
limit	integer	No	Max items returned, 1-100. Defaults to 20.

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"
  }
}

Public Playground

Preview the endpoint before sending a live request

Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestsevennow.promotionResponseDoc7NOW

GET /7now/promotion

List every item one 7NOW promotion covers

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.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

promo_id

requiredstring

Promotion id, from GET /7now/deals' items[].promos[].id.store_id

requiredstring

7NOW store id, from GET /7now/stores.

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "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"
  }
}

Endpoint details

Method: GET
Path: /7now/promotion
Authentication: apiKey
Credit cost: 1 credit/request
Platform: 7NOW
Parameters: 5 documented fields

Request parameters

promo_id:querystore_id:queryskip:querylimit:queryx-api-key:header

Response schema fields

codedatadata.countdata.fetched_atdata.has_moredata.itemsdata.items[].age_restricteddata.items[].availabledata.items[].available_quantitydata.items[].branddata.items[].caloriesdata.items[].category

Sample response summary

{
  "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"
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/7now/promotion?promo_id=<promo_id>&store_id=<store_id>" \
  -H "x-api-key: $CRAWLORA_API_KEY"

View endpoint docs Open platform page Browse all endpoints Pricing Get one 7NOW store's live product catalog List every category id one 7NOW store accepts Browse one 7NOW store's category by subcategory Get one 7NOW bundle deal's pick-from groups List a 7NOW store's bundle deals

Try the 7NOW Promotion API

Endpoint facts

Method: GET
API path: /7now/promotion
Platform: 7NOW
Auth: apiKey
Credits: 1 credit/request
Required params: promo_id, store_id
Common optional params: skip, limit

7NOW Promotion API documentation 7NOW platform page Crawlora API pricing Try 7NOW Catalog API Try 7NOW Categories API Try 7NOW Category API Try 7NOW Combo API Try 7NOW Combos API

Prefilled cURL

curl "https://api.crawlora.net/api/v1/7now/promotion?promo_id=<promo_id>&store_id=<store_id>" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Description
promo_id	string	Yes	Promotion id, from GET /7now/deals' items[].promos[].id.
store_id	string	Yes	7NOW store id, from GET /7now/stores.
skip	integer	No	Pagination offset. Defaults to 0.
limit	integer	No	Max items returned, 1-100. Defaults to 20.

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"
  }
}

List every item one 7NOW promotion covers

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

{ "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" } }

Endpoint details

Method: GET
Path: /7now/promotion
Authentication: apiKey
Credit cost: 1 credit/request
Platform: 7NOW
Parameters: 5 documented fields

Request parameters

promo_id:querystore_id:queryskip:querylimit:queryx-api-key:header

Response schema fields

codedatadata.countdata.fetched_atdata.has_moredata.itemsdata.items[].age_restricteddata.items[].availabledata.items[].available_quantitydata.items[].branddata.items[].caloriesdata.items[].category

Sample response summary

{
  "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"
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/7now/promotion?promo_id=<promo_id>&store_id=<store_id>" \
  -H "x-api-key: $CRAWLORA_API_KEY"