Kohl's

Browse a Kohl's category or curated campaign page

Returns a Kohl's category or curated campaign page's product grid (page 1 only), with products (title, image, colors, pricing, rating, availability) and facets for discovering further category values. category is Kohl's own catalog taxonomy string, e.g. "Room:Dorm" or "Department:Kitchen & Dining" -- combine multiple dimensions with a literal "+", percent-encoded as "%2B" so it survives as "+" rather than being decoded to a space (e.g. "Room%3ADorm%2BDepartment%3ABedding"). Every facets[].options[].category value in a response is a ready-to-use category string for a follow-up call, so a caller can discover the full taxonomy by starting from a known category (e.g. "Room:Dorm") and following facets. A category value Kohl's does not recognize returns a 404 rather than an unfiltered listing; a recognized dimension with no matching products returns a genuine zero-result response instead.

get/kohls/category

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/kohls/category
  • Auth: API key in header x-api-key

Query parameters

categorystring required

Kohl's catalog taxonomy string, e.g. \

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "category": "Room:Dorm",
    "count": 120,
    "facets": [
      {
        "label": "Department",
        "name": "Department",
        "options": [
          {
            "category": "Room:Dorm+Department:Bedding",
            "name": "Bedding",
            "product_count": 479
          }
        ]
      }
    ],
    "limit": 120,
    "product_count": 1317,
    "products": [
      {
        "available_for_ship": true,
        "currency_code": "USD",
        "on_sale": true,
        "rating": 3.9,
        "regular_price": {
          "max_price": 9.99,
          "min_price": 2.99
        },
        "review_count": 27103,
        "sale_price": {
          "max_price": 9.99,
          "min_price": 2.99
        },
        "title": "The Big One® Solid Bath Towel, Bath Sheet, Hand Towel or Washcloth",
        "web_id": "4569328"
      }
    ],
    "title": "Essential Dorm Items for College-Bound Students | Kohl's",
    "total_pages": 11
  },
  "msg": "OK"
}

Changes

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