> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/kohls>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/kohls.mdx>

---

# Kohl's API. Search, reviews and questions as JSON.

Search Kohl's products with their prices and ratings, page through every review of a product with its statistics, and read the questions shoppers ask with the answers they get. Every response uses the same envelope.

- Product search
- Reviews + statistics
- Questions and answers

`GET /v1/kohls/search` searches Kohl's by keyword, 120 products a page: name, link, image, the regular, sale and Your Price ranges with the offer codes and promotions behind them, rating, review count, colours, badges and the filters the site offers with their counts. Each product's `id` passes straight to the two product routes.

`GET /v1/kohls/product/reviews` returns what shoppers wrote about a Kohl's product: the star rating, title and text, the date, the reviewer's nickname and location, whether they recommend it, verified-buyer and incentive flags, ratings for single aspects such as quality and comfort, and fit from runs small to runs large, the reviewer's own age range, body type and how long they have owned it when they gave them, in the site's words, photos and the brand's replies. `data.stats` adds the average rating, the 5-to-1 star distribution and recommendation counts. Pass the product id from the product page URL, such as `1695762` from `prd-1695762`, or the URL itself.

`GET /v1/kohls/product/questions` lists the questions shoppers ask about the same product, each with its answers, including the brand's. Both product routes sort, take up to 100 rows a page and return a cursor that continues the same list. Every answer is JSON in the `{ data, meta }` envelope with `data.lookupStatus`; a product Kohl's doesn't have is `not_found`, not an HTTP error.

## What you can get

- Product search by keyword, 120 products a page, with regular, sale and Your Price, offer codes, promotions, rating, colours, badges and filter counts.
- Product reviews with star ratings, title, text, date, reviewer nickname and location, and recommendation.
- Fit (runs small to runs large), quality and comfort ratings, and what reviewers said about themselves, such as body type and age range, in the site's words.
- Verified-buyer, incentive, staff and syndication flags on every review.
- Review photos, videos and replies from the brand.
- Review statistics: average rating, star distribution, recommendation counts, photo count and the average of each aspect.
- Shopper questions with every answer, the brand's marked.

## Kohl's endpoints

| Endpoint | Request | Credits | Docs |
| --- | --- | --- | --- |
| Product reviews | GET /v1/kohls/product/reviews | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/kohls/product/reviews/get) |
| Product questions | GET /v1/kohls/product/questions | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/kohls/product/questions/get) |
| Search | GET /v1/kohls/search | 4 credits Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/kohls/search/get) |

## How to start

1. **Create an API key.** Sign up at Social Fetch and copy a key (`sfk_…`). New accounts get 100 free credits, enough to try every Kohl's route.
2. **Pick the product.** Search with `GET /v1/kohls/search?query=jeans`, or use the product id from the product page URL (the number after `prd-`) or the URL itself, for example `GET /v1/kohls/product/reviews?productId=1695762`. Send `x-api-key` on every request.
3. **Branch and page.** Check `data.lookupStatus` before you store a row. Keep requesting with `page.nextCursor` while `page.hasMore` is true, and bill from `meta.creditsCharged`.

## Pricing

Each Kohl's route charges a flat credit amount per completed request, shown on every endpoint page. Each page of a list is its own request. Credits never expire on pay-as-you-go packs, and `meta.creditsCharged` on every response is the billing source of truth.

## Compared with the official API

Kohl's offers no public developer API for its catalogue or reviews. Social Fetch gives every route one JSON shape: plain text instead of page markup, ISO 8601 UTC dates, typed `lookupStatus` answers and opaque cursors that continue the same list and filters. You do not need an account or a session.

## FAQ

### What Kohl's data can I get from the API?

Product search results with prices, ratings and filters, every review of a product with its ratings, reviewer details, photos and brand replies, the product's review statistics, and the questions shoppers ask with their answers.

### How do I name a Kohl's product?

Use its product id, the number after prd- in the product page URL such as 1695762, or the URL itself; a search returns it as each product's id. A product Kohl's doesn't have returns data.lookupStatus: not_found.

### How do I get every review of a product?

Call /v1/kohls/product/reviews with limit up to 100 and follow page.nextCursor while page.hasMore is true. Each page is one request. A walk reads the reviews approved by the time it started, so new reviews don't push rows onto the next page; a review moderated again during the walk drops out, and most_helpful can reorder as votes come in.

### Why do some reviews name another product?

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. Each review's productId and productName show which product it was written for.

### Can I tell incentivized or syndicated reviews apart?

Yes. isIncentivized marks reviews written for a free product or a reward, isVerifiedPurchaser marks verified buyers, and isSyndicated with syndicationSource marks reviews first posted on another site, such as the brand's own.

### Can I search Kohl's products?

Yes. /v1/kohls/search takes a keyword and an optional sort, returns 120 products a page with prices, ratings and filter counts, and pages to the end of the results with page.nextCursor. Product details and store lookups are not available yet.

### How much does the Kohl's API cost?

Each Kohl's route charges a flat amount per completed request, shown on each endpoint page, and each page of a list is billed separately. Search costs more than the product routes. A found, empty or not-found answer is a completed request and costs that amount; invalid requests and errors are free. Check meta.creditsCharged on every response. New accounts start with 100 free credits.

## Related

- [Kohl's Product Search API](https://www.socialfetch.dev/platforms/kohls/search): Products with prices, ratings and filters (`GET /v1/kohls/search`).
- [Kohl's Product Reviews API](https://www.socialfetch.dev/platforms/kohls/product-reviews): Reviews with ratings, photos and statistics (`GET /v1/kohls/product/reviews`).
- [Kohl's Product Questions API](https://www.socialfetch.dev/platforms/kohls/product-questions): Shopper questions with their answers (`GET /v1/kohls/product/questions`).
- [Ask in plain English](https://www.socialfetch.dev/ask): Route a natural-language Kohl's question to the matching operation.
- [Hosted MCP](https://www.socialfetch.dev/mcp): Call Kohl's tools from Cursor or Claude with the same credit metering as REST.
