Browse one 7NOW store's category by subcategory
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.
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
Query parameters
7NOW store id, from GET /7now/stores.
Category id, from GET /7now/categories -- either a department or a merchandising shelf.
Restrict to one subcategory group by exact name (from a prior call's subcategories[].name).
Pagination offset, applied uniformly to every subcategory group. Defaults to 0.
Max items returned per subcategory group, 1-50. Defaults to 20.
Headers
API key required
Response
OK
Example response
{
"data": {
"category_id": "48423",
"limit": 20,
"stats": {
"available": 99,
"out_of_stock": 22,
"percentage_available": 82,
"total": 121
},
"store_id": "39226",
"subcategories": [
{
"items": [
{
"available": true,
"available_quantity": 100,
"calories": "360",
"name": "Large Pizza - Ultimate Pepperoni",
"price_cents": 1299,
"product_id": "178322-2-6-2",
"promo_description": "On Sale $6.99",
"promo_price_cents": 699,
"subcategory": "Pizza",
"upc": "00052548537524"
}
],
"name": "Pizza"
}
]
}
}Changes
No recorded changes to this operation across all 2 revisions of this API.