Kohl’s Questions - SocialQuery

Kohls Questions

curl --request GET \
  --url https://socialquery.dev/v1/kohls/questions \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://socialquery.dev/v1/kohls/questions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "data": {
    "product": {
      "id": "<string>",
      "name": "<string>",
      "url": "<string>",
      "family_ids": [
        "<string>"
      ]
    },
    "items": [
      {
        "question": {
          "id": "<string>",
          "published_at": "2023-11-07T05:31:56Z",
          "author_name": "<string>",
          "locale": "<string>",
          "is_syndicated": true,
          "source_client": "<string>",
          "product": {
            "id": "<string>",
            "name": "<string>",
            "url": "<string>",
            "family_ids": [
              "<string>"
            ]
          },
          "title": "<string>",
          "text": "<string>",
          "total_answer_count": 1,
          "answers": [
            {
              "id": "<string>",
              "published_at": "2023-11-07T05:31:56Z",
              "author_name": "<string>",
              "locale": "<string>",
              "is_syndicated": true,
              "source_client": "<string>",
              "text": "<string>",
              "is_best_answer": true,
              "is_brand_answer": true
            }
          ],
          "returned_answer_count": 1,
          "answers_complete": true,
          "answer_limit": 1
        }
      }
    ],
    "returned_count": 1,
    "source_returned_count": 1,
    "filtered_out": 1,
    "total": 1,
    "total_scope": "native_product_family_locale_candidates",
    "page": 2,
    "limit": 25,
    "offset": 1,
    "locale": "<string>",
    "next_cursor": "<string>",
    "pagination_capped": true,
    "source": "<string>",
    "coverage_note": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

GET

kohls

questions

Kohls Questions

curl --request GET \
  --url https://socialquery.dev/v1/kohls/questions \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://socialquery.dev/v1/kohls/questions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "data": {
    "product": {
      "id": "<string>",
      "name": "<string>",
      "url": "<string>",
      "family_ids": [
        "<string>"
      ]
    },
    "items": [
      {
        "question": {
          "id": "<string>",
          "published_at": "2023-11-07T05:31:56Z",
          "author_name": "<string>",
          "locale": "<string>",
          "is_syndicated": true,
          "source_client": "<string>",
          "product": {
            "id": "<string>",
            "name": "<string>",
            "url": "<string>",
            "family_ids": [
              "<string>"
            ]
          },
          "title": "<string>",
          "text": "<string>",
          "total_answer_count": 1,
          "answers": [
            {
              "id": "<string>",
              "published_at": "2023-11-07T05:31:56Z",
              "author_name": "<string>",
              "locale": "<string>",
              "is_syndicated": true,
              "source_client": "<string>",
              "text": "<string>",
              "is_best_answer": true,
              "is_brand_answer": true
            }
          ],
          "returned_answer_count": 1,
          "answers_complete": true,
          "answer_limit": 1
        }
      }
    ],
    "returned_count": 1,
    "source_returned_count": 1,
    "filtered_out": 1,
    "total": 1,
    "total_scope": "native_product_family_locale_candidates",
    "page": 2,
    "limit": 25,
    "offset": 1,
    "locale": "<string>",
    "next_cursor": "<string>",
    "pagination_capped": true,
    "source": "<string>",
    "coverage_note": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

Returns approved public English-US feedback from the review widget published by Kohl’s. Supply product_id, a matching regional product URL, or a continuation cursor. A separate product display lookup confirms identity; a source-confirmed missing product returns 404. The source groups related variants into native product families. Results are not necessarily for the exact requested variant. Every row retains its actual product ID, name, URL when available, and family_ids. Related IDs must have a source-corroborated family relationship to the requested product. A retired related product can have a null URL; no replacement URL is invented. Tracking parameters are stripped from returned product links. Each question retains its native ID, title/details, public nickname, timestamp, actual product ID and syndication metadata. answers contains up to ten English-US answers included by the source, preserving each answer’s ID, text, public nickname, timestamp and native best/brand-answer flags. Answer parent IDs are checked against the question. total_answer_count is the source count; returned_answer_count counts included answers. answers_complete is true only when those counts match. Fewer answers can reflect the ten-answer window or locale filtering. This endpoint does not provide a separate answer cursor or claim that a source best-answer flag establishes correctness. page is one-based and limit is 1–50, default 10. Results use native newest-first order. total is the source’s family/locale candidate count, identified by total_scope; it is not an exact-SKU or all-locale count. Cursors bind product, limit and filters for one hour and corroborate the preceding record. Source changes can require restarting. Offsets stop at 10,000, with pagination_capped identifying a local ceiling. The response selects public feedback fields only. It excludes IP addresses, internal author/submission IDs, contact details and raw provider objects. No customer account access or feedback submission is used. The source URL omits the public display configuration parameter. A fresh nonempty page costs 5 credits. Empty pages, failures, cache hits and successful idempotent replays cost zero. Use X-Max-Credits: 5. Each request uses two anonymous display reads, or three with a cursor. A shared 20-source-request/minute limit, 25-second total timeout and 2 MiB limit per response apply. Public-source availability has no contractual SLA.

Authorizations

x-api-key

string

header

required

Headers

Cache-Control

string

Idempotency-Key

string

X-Max-Credits

integer

Optional nonnegative integer cap on the maximum request hold. A live request whose hold exceeds this cap returns 422 CREDIT_BUDGET_EXCEEDED before spending. Metered holds use the requested limit; cache hits and successful idempotent replays cost zero.

Required range: x >= 0

Query Parameters

product_id

string

Native product ID. Supply product_id, a matching product URL, or a continuation cursor.

Pattern: ^[1-9][0-9]{0,17}$

url

string

Canonical HTTPS www.kohls.com/product/prd-ID/product.jsp URL, or its ID path. Parsed only; never followed. Must match any supplied product_id.

page

integer

default:1

One-based page. (page-1)*limit must not exceed 10,000. A supplied page must match the cursor offset.

Required range: x >= 1

limit

integer

default:10

Native feedback page size, 1–50; default 10.

Required range: 1 <= x <= 50

cursor

string

One-hour cursor retaining product, limit and date filters. Rechecks the preceding native record. May be supplied without product_id/url.

Response

Approved public English-US feedback from the retailer’s published display source. Independently verifies product identity, retains actual related-variant IDs through native product-family relationships, and supports bounded pagination with empty-result refunds.

success

boolean

required

platform

string

required

endpoint

string

required

credits_used

integer

required

Required range: x >= 0

credits_remaining

integer | null

required

request_id

string

required

cached

boolean

required

data

object

required

The selected operation determines the resource fields in this object. Source data can omit a metric or report it as null.

Show child attributes