베스트 상품 조회
카테고리 구분 없이 지금 많이 팔리는 상품 목록을 조회합니다.
카테고리를 나누지 않는 통합 인기 상품 영역을 구성하실 때 사용하시면 됩니다. 카테고리 베스트와는 집계 방식이 다릅니다.
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?