7NOW

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.

get/7now/promotion

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/7now/promotion
  • Auth: API key in header x-api-key

Query parameters

promo_idstring required

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

store_idstring required

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

skipinteger

Pagination offset. Defaults to 0.

limitinteger

Max items returned, 1-100. Defaults to 20.

Headers

x-api-keystring required

API key required

Response

OK

codeinteger

Code is the HTTP status code or a custom code used to indicate the result of the request @example 200

msgunknown

Example response

{
  "data": {
    "count": 14,
    "items": [
      {
        "available": true,
        "available_quantity": 5,
        "brand": "Ben & Jerry's",
        "calories": "370",
        "category": "Ice Cream",
        "category_id": "48396",
        "name": "Ben & Jerry's Sundae Cookie Vermont-ster 14oz",
        "price_cents": 999,
        "product_id": "191743-0-1",
        "promos": [
          {
            "expiration_date": "10/27/2026",
            "id": "6a9746d488cc35e1bbff1584",
            "promo_price_cents": 700,
            "promo_type": "item",
            "short_description": "On Sale $7",
            "start_date": "09/01/2026"
          }
        ],
        "subcategory": "Ben & Jerry's",
        "upc": "00076840004294"
      }
    ],
    "limit": 20,
    "promo_id": "6a9746d488cc35e1bbff1584",
    "promotion": {
      "display_priority": 2,
      "expiration_date": "2026-10-27T23:59:59.000Z",
      "id": "6a9746d488cc35e1bbff1584",
      "name": "US_7N_Ben & Jerry's Pints $7_(9/1/2026-10/27/2026) - FOR 7NOW",
      "offer_type": "item_discount",
      "promo_price_cents": 700,
      "promo_type": "item",
      "short_description": "On Sale $7",
      "start_date": "2026-09-01T00:00:00.000Z"
    },
    "store_id": "39640",
    "total": 14
  }
}

Changes

No recorded changes to this operation across all 3 revisions of this API.