프로
엔터프라이즈
100회/분

이메일 성과 조회

​

이메일의 오픈율과 클릭율을 여러 건 한 번에 조회합니다.

  • 두 비율의 분모는 발송에 성공한 구독자 수이며, 웹 화면의 오픈율·클릭율과 같은 값입니다.
  • 유니크 기준입니다. 한 구독자가 여러 번 열어도 한 번으로 셉니다.
  • 발송하지 않은 이메일은 두 값이 모두 0입니다. 발송 여부는 GET /emails의 status로 확인하세요.
  • 오픈·클릭 건수가 필요하면 GET /emails/{id}/logs에 actions=O 또는 actions=C를 지정하고 응답의 total을 보세요.

Query Parameters

  • ids
    Type: string
    required

    조회할 이메일 아이디 목록(쉼표로 구분). 예) "1024,1025"

    • 한 번에 최대 10개까지 지정할 수 있습니다.
    • 중복된 아이디는 하나로 처리되며 개수에 포함되지 않습니다.
    • 하나라도 다른 워크스페이스의 이메일이거나 삭제된 이메일이면 요청 전체가 거절됩니다.

Responses

  • application/json
  • application/json
Request Example for get/emails/stats
curl 'https://api.stibee.com/v2/emails/stats?ids=1024%2C1025' \
  --header 'AccessToken: YOUR_SECRET_TOKEN'

{
  "items": [
    {
      "emailId": 1024,
      "openRate": 42.5,
      "clickRate": 8.3
    }
  ]
}

이메일 성과 조회 성공