---
title: "Browse one 7NOW store's category by subcategory"
method: GET
path: "/7now/category"
tags: ["7NOW"]
---

# Browse one 7NOW store's category by subcategory

`GET /7now/category`

## Request

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

Returns 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.

## Query parameters

- `store_id` string, required
- `category_id` string, required
- `subcategory` string
- `skip` integer
- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SevennowCategoryResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` SevennowCategoryResponse
    - `category_id` string
    - `fetched_at` string
    - `limit` integer
    - `skip` integer
    - `source_url` string
    - `stats` SevennowCategoryStats
      - `available` integer
      - `out_of_stock` integer
      - `percentage_available` integer
      - `total` integer
    - `store_id` string
    - `subcategories` SevennowCategorySubcategory[]
      - `items` SevennowCategoryItem[]
        - `age_restricted` boolean
        - `available` boolean
        - `available_quantity` integer
        - `calories` string
        - `image_url` string
        - `name` string
        - `price_cents` integer
        - `product_id` string
        - `promo_description` string
        - `promo_price_cents` integer
        - `subcategory` string
        - `upc` string
      - `name` string
  - `msg` unknown

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)