Kohl's

Search Kohl's products

Search Kohl's products by keyword with prices, ratings, colours and filters.

GET/v1/kohls/search
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
querystringrequiredquery

Words to search for, up to 200 characters (`jeans`).

min 1 chars · max 200 chars

sortstringoptionalquery

Order of the products: `featured` (default), `newest`, `price_low_to_high`, `price_high_to_low`, `top_rated` or `percent_off`.

one of: featured, newest, price_low_to_high, price_high_to_low, top_rated, percent_off

cursorstringoptionalquery

Pass `page.nextCursor` from the previous response to get the next page. It only works with the same query and sort.

min 1 chars · max 2048 chars

Response fields
71

Endpoint-specific response payload.

datalookupStatus
string

Always `found`: no match is an empty list.

one of: found, not_found

dataquery
string

The words searched for.

datacorrectedQuery
stringnullable

The words the site searched instead, when it corrected them.

Set when the site sends this search to a category or brand page instead (`sephora`, `gift card`): `products` is then that page's first page, in its own order.

dataredirectname
stringnullable

The category or brand, e.g. `Sephora`.

dataredirecturl
string

The category page URL.

datatotalResults
integernullable

Products matching, across every page, as the site counts them.

Products on this page, in the site's order. Kohl's sponsored cards load in the browser after the page, from its ad service, and are not included.

dataproducts[]id
string

Kohl's product id, e.g. `2982007`. Pass it as `productId` to the product reviews and questions endpoints.

dataproducts[]name
stringnullable

Product name.

dataproducts[]url
stringnullable

Product page URL.

dataproducts[]imageUrl
stringnullable

Product image URL.

dataproducts[]alternateImageUrl
stringnullable

The second image the site shows on hover, when any.

Prices.

dataproducts[]pricecurrency
string

Always `USD`.

one of: USD

The regular price; null when the site hides it.

dataproducts[]priceregularmin
numbernullable

Lowest price, in US dollars.

dataproducts[]priceregularmax
numbernullable

Highest price, in US dollars; null when the product has one price.

The sale or clearance price; null without one.

dataproducts[]pricesalemin
numbernullable

Lowest price, in US dollars.

dataproducts[]pricesalemax
numbernullable

Highest price, in US dollars; null when the product has one price.

The price after the offer codes the site applies at checkout (`offerCodes`); null without one.

dataproducts[]priceyourPricemin
numbernullable

Lowest price, in US dollars.

dataproducts[]priceyourPricemax
numbernullable

Highest price, in US dollars; null when the product has one price.

dataproducts[]priceregularText
stringnullable

The regular price as the site writes it, e.g. `$40.00`.

dataproducts[]priceregularLabel
stringnullable

The label before the regular price, `Reg.` or `Orig.`.

dataproducts[]pricesaleText
stringnullable

The sale price as the site writes it, e.g. `$24.00 - $40.00`.

dataproducts[]pricesaleLabel
stringnullable

The label of the sale price, e.g. `Sale` or `Select Styles on Clearance`.

dataproducts[]priceyourPriceText
stringnullable

Your Price as the site writes it, when it shows one.

dataproducts[]pricepriceType
stringnullable

Which prices apply, as the site tags them, e.g. `sale` or `clearance+regular`.

Offer codes behind Your Price, e.g. `LOVE2SAVE`.

dataproducts[]priceofferCodes[]
stringoptional

Promotions on the product, e.g. `BUY 1 GET 1 50%`.

dataproducts[]pricepromotions[]
stringoptional
dataproducts[]priceisHidden
booleannullable

True when the site shows the price only in the cart (`hiddenText`).

dataproducts[]pricehiddenText
stringnullable

What the site shows instead of a hidden price, e.g. `FOR PRICE,ADD TO CART`.

dataproducts[]rating
numbernullable

Average star rating out of 5; null with no reviews.

dataproducts[]reviewCount
integernullable

Number of reviews.

Colours the product comes in.

dataproducts[]colors[]
stringoptional

Colour swatches, as the site shows them under the image.

dataproducts[]swatches[]color
stringnullable

Colour name.

dataproducts[]swatches[]imageUrl
stringnullable

Swatch image URL.

dataproducts[]variations
stringnullable

What a shopper chooses on the product page: `SizeAndColor`, `Size`, `Color` or `None`.

Badges on the card, e.g. `best_seller` or `top_rated`.

dataproducts[]badges[]
stringoptional
dataproducts[]seller
stringnullable

Who sells it when not Kohl's itself: `Marketplace` or `Sephora`; null for Kohl's.

SKU ids of the variants the card stands for.

dataproducts[]skuIds[]
stringoptional
dataproducts[]isAvailableForShipping
booleannullable

Whether it can be shipped.

dataproducts[]isAvailableForPickup
booleannullable

Whether it can be picked up in a store.

dataproducts[]isCouponEligible
booleannullable

Whether Kohl's coupons apply to it.

Filters the site offers on these results, with counts.

datafacets[]id
string

Filter id, e.g. `Gender` or `Brand`.

datafacets[]label
stringnullable

Filter name as the site shows it.

Values, in the site's order.

datafacets[]values[]name
string

Value, e.g. `Womens`.

datafacets[]values[]count
integernullable

Products with this value.

Related searches the site suggests.

datarelatedSearches[]
stringoptional

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor for the next page; null on the last page.

datapagetruncated
boolean

True when the list stops here before its end: more rows exist (see `totalResults`) but no further page can be read.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

curl "https://api.socialfetch.dev/v1/kohls/search?query=jeans" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Kohl's product search results.