> **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/search>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/kohls/search.mdx>

---

# Kohl's Product Search API

Search Kohl's by keyword and read prices, ratings and colours for every result, 120 products a page.

`GET /v1/kohls/search?query=jeans` returns `products`, 120 a page, each with `id`, `name`, `url`, `imageUrl`, `rating`, `reviewCount`, `colors`, `swatches`, `badges`, `seller` and `price`: the regular, sale and Your Price ranges, the text and labels the site shows beside them, offer codes and promotions such as `BUY 1 GET 1 50%`. `totalResults` counts every match and `facets` lists the filters the site offers with their counts. Pass a product's `id` to the product reviews and questions endpoints.

Order with `sort` (`featured`, `newest`, `price_low_to_high`, `price_high_to_low`, `top_rated`, `percent_off`) and follow `page.nextCursor` while `page.hasMore` is true. A search with no match is `found` with an empty list.

## Request

- **Endpoint:** `GET /v1/kohls/search`
- **Credits:** 4 credits
Failed requests are free
Found, empty and not-found answers are all charged
- **Input:** by keyword
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/kohls/search/get)
- **Platform page:** [/platforms/kohls](https://www.socialfetch.dev/platforms/kohls)

## FAQ

### How deep can I page?

To the end of the results: every page of a search is served, 120 products at a time. A search for bedding has about 170 pages.

### What happens when Kohl's sends a search to a category page?

Some searches, such as sephora or gift card, open a category or brand page instead. The answer names it in redirect, returns that page's first 120 products, and sets page.truncated when the category holds more.

### What is Your Price?

The price Kohl's shows after the offer codes it applies at checkout. price.yourPrice holds it, and price.offerCodes names the codes, when the site shows one.

### Why can a product be missed while I walk a search?

Kohl's counts and ranks every request afresh, so a product can move between pages while you walk. The cursor leaves out a product the previous page already returned; one that moves up onto a page you already read can be missed.

### 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. Each paginated page is a separate billed request.
