For the complete documentation index, see llms.txt. This page is also available as Markdown.

베스트 상품 조회

카테고리 구분 없이 지금 많이 팔리는 상품 목록을 조회합니다.

카테고리를 나누지 않는 통합 인기 상품 영역을 구성하실 때 사용하시면 됩니다. 카테고리 베스트와는 집계 방식이 다릅니다.

GET /openapi/products/best-selling

필요 스코프: sharelink:read


요청

파라미터
필수
기본값
설명

cursor

선택

—

다음 페이지 커서. 첫 요청에는 넣지 않습니다

size

선택

30

한 번에 받을 개수. 1~100 (범위를 벗어나면 자동 보정)

curl -H "Authorization: Bearer {액세스 토큰}" \
  "https://sharelink.toss.im/openapi/products/best-selling?size=30"

응답

partnerMallType의 값과 처리 규칙은 상품 카드 공통 필드의 제휴몰 유형을 확인해 주세요.

{
  "resultType": "SUCCESS",
  "success": {
    "items": [
      {
        "rank": 1,
        "tacaItemId": 12345,
        "displayName": "상품명",
        "partnerMallType": "NONE",
        "thumbnailUrl": "https://.../thumb.jpg",
        "productUrl": "https://toss.shopping/t/9876",
        "displayPrice": 19900,
        "originalPrice": 29900,
        "discountRate": 33,
        "isSoldOut": false,
        "reviewScore": 4.8,
        "reviewCount": 1523,
        "categoryIds": [100, 101, 10125]
      }
    ],
    "nextCursor": "eyJ...",
    "hasNext": true
  }
}

필드

필드
타입
설명

items

array

상품 목록. 인기 순으로 정렬되어 있으니 받으신 순서 그대로 노출하시면 됩니다

items[].partnerMallType

string

판매자 제휴몰 유형. 일반 셀러는 NONE, 오아시스는 OASIS. 모르는 값은 일반 셀러처럼 처리합니다

nextCursor

string | null

다음 페이지 커서. 다음 페이지가 없으면 null

hasNext

boolean

다음 페이지 존재 여부

items의 각 항목은 상품 카드 공통 필드와 같습니다.

페이징 방법은 커서 페이징을 참고해 주세요.


사용 팁

랭킹은 1시간 단위 배치 결과로 갱신됩니다. 실시간 순위가 아니므로, 응답을 저장해 두고 1시간 단위 이상으로 다시 조회하시는 것을 권장드립니다.

노출하실 상품이 정해지면, 각 상품의 tacaItemId로 쉐어링크를 발급받아 게시글에 넣어 주세요. 응답의 productUrl은 추적이 되지 않아 수익으로 집계되지 않습니다.

Was this helpful?