# Kohl's Data API (https://www.socialcrawl.dev/platforms/kohls)

> The SocialCrawl Kohl's API returns Kohl's catalogue data as JSON across 5 endpoints. Search returns 12 products per page by default, up to 48, with product id, name, current and original price, images, colours, rating and product URL. Reviews come 8 per page with a verified-purchase flag, questions returns buyer Q&A, and stores and categories cover locations and the site tree.

TL;DR: SocialCrawl's Kohl's API exposes 5 endpoints, 1 to 9 credits per call, all returning one unified JSON schema with computed fields such as engagement rate, language and content category. Single x-api-key auth, 100 free credits on signup.

## Endpoints

| Endpoint | Method | Path | Credits | Description |
| --- | --- | --- | --- | --- |
| Search | GET | `/v1/kohls/search` | 5 | Search Kohl's products by keyword |
| Reviews | GET | `/v1/kohls/reviews` | 5 to 9 | Get Kohl's product reviews |
| Questions | GET | `/v1/kohls/questions` | 5 | Get Kohl's product questions and answers |
| Stores | GET | `/v1/kohls/stores` | 5 | Find Kohl's stores near a coordinate |
| Categories | GET | `/v1/kohls/categories` | 1 | Get the Kohl's category tree |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/kohls/search" \
  --data-urlencode "query=jeans" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

Every response shares one JSON envelope: `{ success, platform, endpoint, data, credits_used, credits_remaining }`.

## FAQ

### What data does the SocialCrawl Kohl's API return?

It returns keyword search results with product id, name, current and original price, images, colours, rating and product URL, plus customer reviews, buyer questions with their answers, stores near a coordinate and the site's category tree. All of it comes back as JSON.

### Is there a Kohl's product detail endpoint?

No. This API has no product-detail endpoint, so the search row is where the product fields live. Take the product id from a search row and pass it to reviews or questions for the rest.

### How do I filter or sort Kohl's search results?

sort_by accepts featured (the default), newest, price_low, price_high, rating or percent_off. filters takes a Kohl's dimension string such as Color:Black or Brand:Nike, with values combined by commas. A query Kohl's cannot match still returns a few unrelated popular products instead of an empty page, so check that the rows fit your keyword.

### How do I get every review for a Kohl's product?

Call reviews with the product id, the digits after prd- in the product URL, or with the URL itself. Each page holds 8 reviews by default, up to 50, with text, star rating, title, nickname, date, helpful votes and a verified-purchase flag. Pass the cursor back until has_more is false.

### Can I read the buyer questions on a Kohl's product?

Yes, questions returns 10 per page by default with the question text, asker nickname, date, answer count and any attached answers. A product id Kohl's does not know returns an empty list and is not billed.

### Can I find Kohl's stores near a location?

Yes, stores takes location_coordinate as lat,lng, for example 40.758,-73.9855, and a radius of 1 to 100 miles (default 25). Each store has an id, name, address, coordinates and store page URL. It searches around one point, so there is no full country list. Credits for failed or empty calls are refunded automatically.

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How do I get Kohl's product reviews with the SocialCrawl API?
- Does SocialCrawl have a Kohl's API for product search and store locations?