브랜드 소식 상세 통계

Request

지정된 브랜드의 소식 상세 통계를 조회 합니다.

지정된 브랜드의 소식 상세 통계를 조회 합니다.

get

/brand/{brandId}/feed/stat/feed

Authorizations

Path parameters

brandIdstringrequired

브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.

Query parameters

offsetinteger

시작 offset 번호(default: 0) 입니다.

limitinteger

maxLength: 100 - 조회 최대 건수(default: 10, maxLength: 100) 입니다.

typestring · enum

소식 유형을 지정합니다.

Options: gallery, share, slide

startDatestring

maxLength: 8 - 검색 시작일자(YYYYMMDD)를 지정합니다. 미지정 시 현재일 기준 전일로 부터 30일 이전 일자 기본 설정되며, 검색 시작일과 종료일의 범위는 최대 1개월입니다. 검색 가능 일자 범위는 전일 기준 1년 이내 입니다.

endDatestring

maxLength: 8 - 검색 종료일자(YYYYMMDD)를 지정합니다. 미지정 시 현재일 기준 전일로 기본 설정되며, 검색 시작일과 종료일의 범위는 최대 1개월입니다. 검색 가능 일자 범위는 전일 기준 1년 이내 입니다.

Header parameters

X-RCS-Brandkeystring

maxLength: 36 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다. 대행사가 브랜드 소식 API 연동 시 Header에 반드시 설정하여야 합니다.

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api-qa.rcsbizcenter.com/bfapi/1.0/brand/{brandId}/feed/stat/feed' \
  --header 'Authorization: Bearer JWT'

Response

필드명	타입	길이	필수여부	기본값	설명
result	array<FeedDetailStat>		O		브랜드 소식 상세 통계
code	string	5	O	20000000	리턴코드값
status	integer	3	O	200	상태값
desc	string		O		처리메시지
pagination	Pagination		O		전체건수와 페이징조건
links	Links		O		이전/다음

result - array<FeedDetailStat>

필드명	타입	길이	필수여부	기본값	설명
brandId	string	13			브랜드 ID
feedId	string	10			소식 ID
ymd	integer	8			통계일자
type	string				소식 유형 gallery, share, slide
pvCnt	integer				당일 페이지 뷰수
pvTotCnt	integer				누적 페이지 뷰수
btn1ClCnt	integer				당일 버튼1 클릭수
btn1ClTotCnt	integer				누적 버튼1 클릭수
btn2ClCnt	integer				당일 버튼2 클릭수
btn2ClTotCnt	integer				누적 버튼2 클릭수
slClCnt	integer				당일 슬라이드 클릭수
slClTotCnt	integer				누적 슬라이드 클릭수

❖ response body sample

200

{
    "code": "20000000",
    "desc": null,
    "result": {
        "statList": [
            {
                "brandId": "BR.dM1gH08zPw",
                "feedId": "BR.dM1gH08zPw.6vMcCjG1S4",
                "ymd": "2024-06-09",
                "type": "gallery",
                "pvCnt": 1,
                "pvTotCnt": 30,
                "btn1ClCnt": 0,
                "btn1ClTotCnt": 5,
                "btn2ClCnt": 0,
                "btn2ClTotCnt": 0,
                "slClCnt": 0,
                "slClTotCnt": 0
            }
        ]
    },
    "pagination": {
        "offset": 0,
        "limit": 100,
        "total": 1
    },
    "links": {
        "prev": null,
        "next": null
    },
    "status": 200
}

401

{
  "status": "401",
  "error": {
    "code": "61001",
    "message": "Missing Authorization header"
  }
}

{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 401
}

{
    "error": {
        "code": "64713",
        "message": "No File Permission [BR.Q63creSjku-FDRwSMvksa5P]"
    },
    "status": 401
}

error code는 브랜드소식 - Response body error code 참조