Kohl's Product Reviews API
Page through every review of a Kohl's product, newest first or by rating, with the product's review statistics.
GET /v1/kohls/product/reviews1 credit Failed requests are free Found, empty and not-found answers are all charged
About this endpoint
GET /v1/kohls/product/reviews?productId=1695762 returns data.reviews and data.stats. Each review has id, productId, productName, rating, title, text, isRatingsOnly, submittedAt, authorNickname, authorLocation, isRecommended, isIncentivized, isVerifiedPurchaser, isStaff, isSyndicated, syndicationSource, helpfulCount, notHelpfulCount, secondaryRatings (fit, quality, comfort and other aspects, each with its label, whether it is stars or a slider, and the words for its value), the reviewer's self-described attributes with the words the site shows for them, pros, cons, badges, photos, videos and brandResponses. stats carries the average rating, recommendation counts, the 5-to-1 star distribution, photo count and the average of each aspect.
Sort with sort (newest, oldest, highest_rating, lowest_rating, most_helpful), filter with rating, and set limit up to 100. Keep requesting with page.nextCursor while page.hasMore is true. A product Kohl's doesn't have is lookupStatus: not_found; a product nobody has reviewed is found with no reviews.
Price
From $1.35 per 1,000 requests
1 credit per request. Failed requests are free.
- Scale pack
- $1.64 / 1,000
- Growth pack
- $2.36 / 1,000
The lowest rate is on annual plans; packs are pay as you go.
Example request
Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
Kohl's Product Reviews API FAQ
How do I page through all reviews?
Request with limit up to 100, then pass page.nextCursor as cursor with the same productId, sort and rating until page.hasMore is false. Each page is its own request. A walk reads the reviews approved by the time it started, so reviews posted while you page don't push rows onto the next page. A review the site moderates again during the walk drops out of it, and most_helpful can reorder as votes come in, so with that sort a row can repeat or be missed.
Can I get only one-star or five-star reviews?
Yes. Add rating=1 to rating=5. totalResults then counts only the matching reviews, while stats describes every review of the product.
Why can a review's productId differ from the one I asked for?
Kohl's shares reviews across related versions of one product, such as its petite or plus sizes, so a review written for one of them can appear. Its own productId and productName show which one.
What are secondaryRatings?
Ratings the reviewer gave single aspects of the product, such as fit, quality or comfort, each with its label and maximum. Most are stars, where more is better. Fit is a slider from Runs Small to Runs Large: a 5 on Fit_22 means it runs large, not that it fits well. displayType tells them apart, and valueLabel gives the site's words for the value, such as True to size.
How many credits does a request cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.