Kohl's

List Kohl's product reviews

List reviews of a Kohl's product with star ratings, fit and quality ratings, reviewer details, photos and review statistics.

GET/v1/kohls/product/reviews
x-api-keystringheader

API key (`sfk_...`)

Parameters
5
productIdstringrequiredquery

Kohl's product id, the number after `prd-` in the product page URL (`1695762`), or the product page URL (`https://www.kohls.com/product/prd-1695762/gloria-vanderbilt-amanda-tapered-jeans-womens.jsp`).

min 1 chars · max 500 chars

sortstringoptionalquery

Order of the reviews: `newest` (default), `oldest`, `highest_rating`, `lowest_rating` or `most_helpful`.

one of: newest, oldest, highest_rating, lowest_rating, most_helpful

ratingintegeroptionalquery

Only reviews with this many stars, 1 to 5. Default: every rating.

≥ 1 · ≤ 5

limitintegeroptionalquery

Reviews per page, 1 to 100. Default: 30.

≥ 1 · ≤ 100

cursorstringoptionalquery

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

min 1 chars · max 1024 chars

Response fields
87

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when Kohl's has no product with this id; a product with no reviews is `found` with an empty list.

one of: found, not_found

dataproductId
string

The product id asked for.

datatotalResults
integernullable

Reviews matching the filters, across every page.

Review statistics; null when not found.

datastatsaverageRating
numbernullable

Average stars out of 5.

datastatsreviewCount
integernullable

Reviews, every page.

datastatsrecommendedCount
integernullable

Reviewers who recommend it.

datastatsnotRecommendedCount
integernullable

Reviewers who do not.

Reviews per star rating, 5 stars first.

datastatsratingDistribution[]rating
integer

Stars, 1 to 5.

datastatsratingDistribution[]count
integer

Reviews with that many stars.

datastatsphotoCount
integernullable

Photos across every review.

datastatsfirstReviewAt
stringnullable

When the first review was posted. ISO 8601 UTC; null when not shown.

datastatslastReviewAt
stringnullable

When the latest review was posted. ISO 8601 UTC; null when not shown.

The average of each aspect rating, across every review.

datastatssecondaryRatingAverages[]id
string

Aspect, e.g. `Fit_22` or `Quality_1`.

datastatssecondaryRatingAverages[]label
stringnullable

Aspect label as the site shows it; null when unknown.

datastatssecondaryRatingAverages[]displayType
stringnullable

How the site shows the rating: `stars` (more is better) or `slider` (a point between `minLabel` and `maxLabel`); null when unknown.

one of: stars, slider, null

datastatssecondaryRatingAverages[]averageRating
numbernullable

Average across every review that rated this aspect.

datastatssecondaryRatingAverages[]maxValue
integernullable

Highest value possible, usually 5.

datastatssecondaryRatingAverages[]minLabel
stringnullable

A slider's low end; null for stars.

datastatssecondaryRatingAverages[]maxLabel
stringnullable

A slider's high end; null for stars.

Reviews on this page.

datareviews[]id
string

Review id.

datareviews[]productId
stringnullable

Product the review was written for; another colour, size or fit of the same product can differ from `productId`.

datareviews[]productName
stringnullable

Name of the product the review was written for.

datareviews[]rating
integernullable

Stars, 1 to 5.

datareviews[]title
stringnullable

Review title.

datareviews[]text
stringnullable

Review text.

datareviews[]isRatingsOnly
booleannullable

Whether the reviewer left stars without text.

datareviews[]submittedAt
stringnullable

When it was posted. ISO 8601 UTC; null when not shown.

datareviews[]authorNickname
stringnullable

Reviewer's nickname.

datareviews[]authorLocation
stringnullable

Reviewer's location.

datareviews[]isRecommended
booleannullable

Whether the reviewer recommends it.

datareviews[]isIncentivized
booleannullable

Whether the reviewer got the product free or a reward for reviewing it.

datareviews[]isVerifiedPurchaser
booleannullable

Whether the site marks the reviewer a verified buyer.

datareviews[]isStaff
booleannullable

Whether the reviewer is a Kohl's employee.

datareviews[]isSyndicated
booleannullable

Whether the review was first posted on another site.

datareviews[]syndicationSource
stringnullable

The site a syndicated review was first posted on.

datareviews[]helpfulCount
integernullable

Readers who found it helpful.

datareviews[]notHelpfulCount
integernullable

Readers who did not.

datareviews[]locale
stringnullable

Language and country, e.g. `en_US`.

Ratings of single aspects, such as fit, quality and comfort. Fit is a scale from runs small to runs large, so a 5 on `Fit_22` means it runs large, not that the fit is good; see `displayType`, `minLabel`, `maxLabel` and `valueLabel`.

datareviews[]secondaryRatings[]id
string

Aspect, e.g. `Fit_22` or `Quality_1`.

datareviews[]secondaryRatings[]label
stringnullable

Aspect label as the site shows it, e.g. "Fit"; null when unknown.

datareviews[]secondaryRatings[]displayType
stringnullable

How the site shows the rating: `stars` (more is better) or `slider` (a point between `minLabel` and `maxLabel`); null when unknown.

one of: stars, slider, null

datareviews[]secondaryRatings[]value
numbernullable

The rating, 1 to `maxValue`: stars, or for a slider the point from `minLabel` (1) to `maxLabel`.

datareviews[]secondaryRatings[]maxValue
integernullable

Highest value possible, usually 5.

datareviews[]secondaryRatings[]valueLabel
stringnullable

The value as the site words it, e.g. "Runs large" for a 5 on fit; null when the site has no words for it.

datareviews[]secondaryRatings[]minLabel
stringnullable

A slider's low end, e.g. "Runs Small"; null for stars.

datareviews[]secondaryRatings[]maxLabel
stringnullable

A slider's high end, e.g. "Runs Large"; null for stars.

What the reviewer said about themselves, such as age range, body type and how long they have owned it.

datareviews[]attributes[]id
string

Field key, e.g. `BodyType`.

datareviews[]attributes[]label
stringnullable

Field label as the site shows it, e.g. "Body Type"; null when unknown.

datareviews[]attributes[]value
stringnullable

Value id, e.g. `CurvyOnBottom`.

datareviews[]attributes[]valueLabel
stringnullable

The value as the site shows it, e.g. "Curvy on Bottom"; null when unknown or free text.

Tags the reviewer picked as pros; empty when none were offered.

datareviews[]pros[]
stringoptional

Tags the reviewer picked as cons.

datareviews[]cons[]
stringoptional

Badges the site shows beside the review, such as Verified Purchaser.

datareviews[]badges[]id
string

Badge id, e.g. `top1000` or `verifiedPurchaser`.

datareviews[]badges[]label
stringnullable

The badge as the site shows it; null when unknown.

Attached photos.

datareviews[]photos[]id
stringnullable

Photo or video id.

datareviews[]photos[]url
stringnullable

Full-size URL.

datareviews[]photos[]thumbnailUrl
stringnullable

Thumbnail URL.

datareviews[]photos[]caption
stringnullable

Caption, when given.

Attached videos.

datareviews[]videos[]id
stringnullable

Photo or video id.

datareviews[]videos[]url
stringnullable

Full-size URL.

datareviews[]videos[]thumbnailUrl
stringnullable

Thumbnail URL.

datareviews[]videos[]caption
stringnullable

Caption, when given.

Replies from the brand or Kohl's.

datareviews[]brandResponses[]name
stringnullable

Who responded.

datareviews[]brandResponses[]text
stringnullable

Response text.

datareviews[]brandResponses[]respondedAt
stringnullable

When they responded. ISO 8601 UTC; null when not shown.

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.

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/product/reviews?productId=1695762" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Kohl's product reviews.