chats

이 API는 별도 제휴를 통해서만 제공되는 제휴 전용 API입니다. 일반 API에 비해 심사 요건이 매우 까다롭습니다. 제휴를 하지 않은 경우 API 키가 있더라도 사용할 수 없습니다.

채팅 수 통계 데이터

GET /chats/summaries/streamers

스트리머 별 채팅수 데이터를 반환합니다. 데이터는 reference_time 시간을 기준으로 duration 만큼 이전 데이터 ~ reference_time 까지의 채팅 수의 합계를 스트리머 별로 반환합니다.

예를 들면 reference_time 를 오후 2시 00으로 지정 후 duration 를 5분을 지정하면 오후 1시 55분~오후 2시까지의 채팅수 합계를 반환하게 됩니다.

Headers

Name	Value
Authorization	Bearer <API 키>

Body

Name	Type	Description
reference_time	string ( ISO 8601 형식)	데이터를 불러올 기준 시간입니다. 예시) 2024-06-01T12:00:00Z 주의) 데이터보관주기가 경과된 데이터는 삭제하므로 제공되지 않습니다.
duration	number	데이터를 불러올 기간입니다. (단위 : 초) 최소 : 30초 최대 : 3600초 (1시간)

Response

성공시

{
    "error": 0,
    "summaries": {
        "soop": {
            "bj_a": 0,
            "bj_a": 500,
            "bj_a": 1240
        ],
        "chzzk": {
            "streamer_a": 0,
            "streamer_a": 500,
            "streamer_a": 1240
        }
    },
    "reference": {
       "IOS8601": {
            "start": "2024-05-22T15:37:00.000Z",
            "end": "2024-05-22T15:42:00.000Z"
        },
        "KST": {
            "start": "2024. 5. 23. 오전 12:37:00",
            "end": "2024. 5. 23. 오전 12:42:00"
        }
    },
    "duration": 300,
    "total": {
        "streamer": 2346,
        "chat": 86904
    }
}

실패시

{
    "error": 400,
    "message": "인증정보가 없습니다. (apikey)",
    "data": {}
}