성과 리포트 API

성과 리포트 API를 사용하여 배포 성과를 분석하고, 기자/매체별 KPI를 확인할 수 있습니다.

인증

모든 API 요청에는 PULITZER-API-KEY 헤더에 API 키가 필요합니다.

헤더 설정

PULITZER-API-KEY: YOUR_API_KEY

curl -X GET "https://api.pulitzer.ai/live/openapi/performance/summary" \
  -H "PULITZER-API-KEY: YOUR_API_KEY"

통합 성과 리포트

배포 성과 통합 리포트를 조회합니다. 배포건별, 기자별, 매체별, 기간별 집계가 가능합니다.

GET https://api.pulitzer.ai/live/openapi/performance/report

Query Parameters

파라미터	타입	필수	설명
`release_ids`	string	No	배포건 ID (콤마 구분, 예: 1,2,3)
`start_date`	string	No	기간 시작 (YYYY-MM-DD)
`end_date`	string	No	기간 종료 (YYYY-MM-DD)
`group_by`	string	No	집계 기준: release(기본) \| reporter \| media \| campaign

응답

{
  "status": "SUCCESS",
  "success": true,
  "message": "성과 리포트 조회 성공",
  "data": {
    "summary": {
      "total_releases": 5,
      "total_sent": 150,
      "total_coverage": 23,
      "avg_coverage_rate": 15.3
    },
    "items": [
      {
        "release_id": 101,
        "press_title": "신제품 출시 보도자료",
        "sent_date": "2026-05-20",
        "total_sent": 30,
        "coverage_count": 5,
        "coverage_rate": 16.7
      }
    ]
  }
}

curl -X GET "https://api.pulitzer.ai/live/openapi/performance/report?release_ids=101,102&group_by=release&start_date=2026-05-01&end_date=2026-05-31" \
  -H "PULITZER-API-KEY: YOUR_API_KEY"

KPI 요약

핵심 KPI 요약 정보만 반환합니다.

GET https://api.pulitzer.ai/live/openapi/performance/summary

Query Parameters

파라미터	타입	설명
`start_date`	string	기간 시작 (YYYY-MM-DD)
`end_date`	string	기간 종료 (YYYY-MM-DD)

응답

{
  "status": "SUCCESS",
  "success": true,
  "message": "KPI 요약 조회 성공",
  "data": {
    "total_releases": 12,
    "total_sent": 450,
    "total_coverage": 67,
    "avg_coverage_rate": 14.9
  }
}

curl -X GET "https://api.pulitzer.ai/live/openapi/performance/summary?start_date=2026-05-01&end_date=2026-05-31" \
  -H "PULITZER-API-KEY: YOUR_API_KEY"

기자별 성과

특정 배포건의 기자별 상세 성과를 조회합니다.

GET https://api.pulitzer.ai/live/openapi/performance/release/{`{release_id}`}/reporters

응답

{
  "status": "SUCCESS",
  "success": true,
  "message": "기자별 성과 조회 성공",
  "data": [
    {
      "reporter_id": 201,
      "reporter_name": "김기자",
      "reporter_email": "ki***",
      "media_name": "한국경제",
      "total_sent": 3,
      "coverage_count": 1,
      "coverage_rate": 33.3
    }
  ]
}

curl -X GET "https://api.pulitzer.ai/live/openapi/performance/release/101/reporters" \
  -H "PULITZER-API-KEY: YOUR_API_KEY"

매체별 성과

특정 배포건의 매체별 상세 성과를 조회합니다.

GET https://api.pulitzer.ai/live/openapi/performance/release/{`{release_id}`}/media

응답

{
  "status": "SUCCESS",
  "success": true,
  "message": "매체별 성과 조회 성공",
  "data": [
    {
      "media_name": "한국경제",
      "total_reporters": 5,
      "total_sent": 15,
      "coverage_count": 3,
      "coverage_rate": 20
    }
  ]
}

curl -X GET "https://api.pulitzer.ai/live/openapi/performance/release/101/media" \
  -H "PULITZER-API-KEY: YOUR_API_KEY"

에러 응답

HTTP Status	설명
404	사용자 또는 배포건을 찾을 수 없음
400	잘못된 파라미터
500	리포트 생성 실패