# Social Fetch API - Kohl's endpoints # Base URL: https://api.socialfetch.dev # Auth: x-api-key header (sfk_...) # Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json # Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json 3 documented Kohl's operations. Do not invent paths - only the routes below (and their linked markdown pages) are supported. ## GET /v1/kohls/product/reviews List Kohl's product reviews Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/kohls/product/reviews/get.mdx SDK: client.kohls.getProductReviews({ productId: "1695762", limit: 30 }) Parameters: - productId (required, string) - 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`). - sort (optional, string, enum: newest | oldest | highest_rating | lowest_rating | most_helpful) - Order of the reviews: `newest` (default), `oldest`, `highest_rating`, `lowest_rating` or `most_helpful`. - rating (optional, integer) - Only reviews with this many stars, 1 to 5. Default: every rating. - limit (optional, integer) - Reviews per page, 1 to 100. Default: 30. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. It only works with the same filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/kohls/product/reviews?productId=1695762" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/kohls/product/questions List Kohl's product questions Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/kohls/product/questions/get.mdx SDK: client.kohls.getProductQuestions({ productId: "1695762" }) Parameters: - productId (required, string) - 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`). - sort (optional, string, enum: newest | oldest | most_answered | recently_answered) - Order of the questions: `newest` (default), `oldest`, `most_answered` or `recently_answered`. - limit (optional, integer) - Questions per page, 1 to 100. Default: 20. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. It only works with the same filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/kohls/product/questions?productId=1695762" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/kohls/search Search Kohl's products Credit cost: 4 credits. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/kohls/search/get.mdx SDK: client.kohls.search({ query: "jeans" }) Parameters: - query (required, string) - Words to search for, up to 200 characters (`jeans`). - sort (optional, string, enum: featured | newest | price_low_to_high | price_high_to_low | top_rated | percent_off) - Order of the products: `featured` (default), `newest`, `price_low_to_high`, `price_high_to_low`, `top_rated` or `percent_off`. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. It only works with the same query and sort. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/kohls/search?query=jeans" \ -H "x-api-key: YOUR_API_KEY"