상품 목록 조회#

스토어 상품을 페이지 단위로 반환합니다. 비활성 및 품절 상품도 목록에 유지됩니다. 논리적으로 삭제한 상품을 포함하여 status: invalid인 상품은 제외됩니다.

http

GET https://sdkapi.ideal.house/product-import/products?shopId=<SHOP_ID>&page=1&pageSize=20

쿼리 매개변수#

필드	유형	필수 여부	제약 조건	설명
`shopId`	string	예	최대 64자	Ideal House에서 제공하는 Shop ID.
`page`	number	아니요	1 이상의 정수	페이지 번호. 기본값 `1`.
`pageSize`	number	아니요	1~100의 정수	페이지당 상품 수. 기본값 `20`.

cURL 예제#

bash

curl --request GET \
  'https://sdkapi.ideal.house/product-import/products?shopId=shop_123&page=1&pageSize=20' \
  --header 'X-Client-Id: <YOUR_CLIENT_ID>' \
  --header 'X-Client-Secret: <YOUR_CLIENT_SECRET>'

응답#

json

{
  "items": [
    {
      "id": "product_123",
      "shopId": "shop_123",
      "sku": "SKU-10001",
      "productCode": "SKU-10001",
      "externalProductId": "SKU-10001",
      "groupId": "mirror-series-01",
      "collectionId": null,
      "name": "Gold Wall Mirror",
      "title": "Gold Wall Mirror",
      "brand": "Example Brand",
      "productType": "Wall Art",
      "normalizedProductType": "wall_decors",
      "category": "Mirror",
      "style": null,
      "color": "Gold",
      "availability": "active",
      "imageUrl": "https://cdn.ideal.house/products/product_123.png",
      "previewImageUrl": "https://cdn.ideal.house/products/product_123-preview.png",
      "productUrl": "https://www.example.com/products/SKU-10001",
      "attributes": {
        "size": {
          "width": "24.0 in",
          "height": "36.0 in",
          "thickness": "2.0 in"
        }
      },
      "status": "active",
      "createdAt": "2026-07-21T06:30:00.000Z",
      "updatedAt": "2026-07-21T06:30:08.000Z"
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 20
}

모든 상품을 조회할 때까지 항상 total, page 및 pageSize를 사용하여 페이지를 순회하세요. 응답 하나에 전체 카탈로그가 포함된다고 가정하지 마세요.