NewsClip API

NewsClip API를 사용하여 뉴스 모니터링 키워드 그룹을 관리하고, 수집된 뉴스 기사를 조회/검색/다운로드할 수 있습니다.

인증

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

헤더 설정

PULITZER-API-KEY: YOUR_API_KEY
curl -X GET "https://api.pulitzer.ai/live/openapi/newsclip/v2/keyword-group" \
  -H "PULITZER-API-KEY: YOUR_API_KEY"

키워드 그룹 목록 조회

사용자의 뉴스 모니터링 키워드 그룹 목록을 조회합니다.

GET https://api.pulitzer.ai/live/openapi/newsclip/v2/keyword-group

응답

{
  "status": "SUCCESS",
  "success": true,
  "message": "키워드 그룹 목록 조회 성공",
  "data": [
    {
      "id": 1,
      "group_name": "AI 동향",
      "keywords": [
        "AI",
        "인공지능",
        "GPT"
      ],
      "region": "국내",
      "created_kst": "2026-05-20T10:00:00"
    }
  ]
}
curl -X GET "https://api.pulitzer.ai/live/openapi/newsclip/v2/keyword-group" \
  -H "PULITZER-API-KEY: YOUR_API_KEY"

키워드 그룹 생성

뉴스 모니터링 키워드 그룹을 생성합니다.

POST https://api.pulitzer.ai/live/openapi/newsclip/v2/keyword-group

요청 본문

{
  "keywords": [
    "AI",
    "인공지능",
    "GPT"
  ],
  "group_name": "AI 동향",
  "region": "국내"
}

Request Body Parameters

파라미터타입필수설명
keywordsarray[string]✅모니터링 키워드 목록 (최대 10개)
group_namestring✅그룹 이름 (최대 100자)
regionstring❌지역 (국내/해외, 기본: 국내)

응답

{
  "status": "SUCCESS",
  "success": true,
  "message": "키워드 그룹 생성 성공",
  "data": {
    "id": 1,
    "group_name": "AI 동향",
    "keywords": [
      "AI",
      "인공지능",
      "GPT"
    ],
    "region": "국내",
    "created_kst": "2026-05-26T10:00:00"
  }
}
curl -X POST "https://api.pulitzer.ai/live/openapi/newsclip/v2/keyword-group" \
  -H "PULITZER-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keywords": ["AI", "인공지능", "GPT"],
    "group_name": "AI 동향",
    "region": "국내"
  }'

키워드 그룹 삭제

키워드 그룹을 삭제합니다.

DELETE https://api.pulitzer.ai/live/openapi/newsclip/v2/keyword-group/{`{group_id}`}

응답

{
  "status": "SUCCESS",
  "success": true,
  "message": "키워드 그룹 삭제 성공"
}
curl -X DELETE "https://api.pulitzer.ai/live/openapi/newsclip/v2/keyword-group/1" \
  -H "PULITZER-API-KEY: YOUR_API_KEY"

뉴스 테마 목록

사용 가능한 뉴스 테마 목록을 조회합니다.

GET https://api.pulitzer.ai/live/openapi/newsclip/v2/theme

응답

{
  "status": "SUCCESS",
  "success": true,
  "message": "테마 목록 조회 성공",
  "data": [
    {
      "name": "AI/테크",
      "keywords": [
        "AI",
        "인공지능",
        "머신러닝",
        "딥러닝"
      ]
    },
    {
      "name": "금융/경제",
      "keywords": [
        "주식",
        "코스피",
        "환율",
        "금리"
      ]
    }
  ]
}
curl -X GET "https://api.pulitzer.ai/live/openapi/newsclip/v2/theme" \
  -H "PULITZER-API-KEY: YOUR_API_KEY"

최근 기사 조회

최근 수집된 뉴스 기사를 조회합니다.

GET https://api.pulitzer.ai/live/openapi/newsclip/v2/recent-articles

Query Parameters

파라미터타입필수설명
limitinteger❌조회 개수 (1-100, 기본: 20)
keyword_group_idinteger❌특정 키워드 그룹의 기사만 조회

응답

{
  "status": "SUCCESS",
  "success": true,
  "message": "최근 기사 조회 성공",
  "data": [
    {
      "id": 12345,
      "title": "OpenAI Announces GPT-5",
      "title_ko": "OpenAI, GPT-5 발표",
      "summary_ko": "OpenAI가 차세대 언어 모델 GPT-5를 공개했습니다...",
      "url": "https://example.com/article",
      "source": "TechCrunch",
      "published_kst": "2026-05-26T09:00:00",
      "img_url": "https://example.com/image.jpg"
    }
  ]
}
curl -X GET "https://api.pulitzer.ai/live/openapi/newsclip/v2/recent-articles?limit=20&keyword_group_id=1" \
  -H "PULITZER-API-KEY: YOUR_API_KEY"

일별 뉴스 조회

키워드 그룹별 일별 뉴스를 조회합니다.

GET https://api.pulitzer.ai/live/openapi/newsclip/v2/daily

Query Parameters

파라미터타입필수설명
keyword_group_idinteger❌키워드 그룹 ID
start_datestring❌시작일 (YYYY-MM-DD)
end_datestring❌종료일 (YYYY-MM-DD)
page_sizeinteger❌조회할 일수 (1-30, 기본: 7)

응답

{
  "status": "SUCCESS",
  "success": true,
  "message": "일별 뉴스 조회 성공",
  "data": [
    {
      "date": "2026-05-26",
      "articles": [
        {
          "id": 12345,
          "title": "OpenAI Announces GPT-5",
          "title_ko": "OpenAI, GPT-5 발표",
          "summary_ko": "OpenAI가 차세대 언어 모델...",
          "url": "https://example.com/article",
          "source": "TechCrunch",
          "published_kst": "2026-05-26T09:00:00"
        }
      ]
    }
  ],
  "page_count": 1
}
curl -X GET "https://api.pulitzer.ai/live/openapi/newsclip/v2/daily?keyword_group_id=1&start_date=2026-05-19&end_date=2026-05-26" \
  -H "PULITZER-API-KEY: YOUR_API_KEY"

뉴스 검색

수집된 뉴스에서 키워드로 검색합니다.

GET https://api.pulitzer.ai/live/openapi/newsclip/v2/search

Query Parameters

파라미터타입필수설명
keywordstring✅검색 키워드
pageinteger❌페이지 번호 (기본: 1)
page_sizeinteger❌페이지 크기 (1-100, 기본: 20)

응답

{
  "status": "SUCCESS",
  "success": true,
  "message": "검색 완료",
  "data": [
    {
      "id": 12345,
      "title": "AI Revolution in Media",
      "title_ko": "미디어 AI 혁명",
      "summary_ko": "인공지능이 미디어 산업을 변화시키고 있습니다...",
      "url": "https://example.com/article",
      "source": "The Guardian",
      "published_kst": "2026-05-25T14:30:00"
    }
  ]
}
curl -X GET "https://api.pulitzer.ai/live/openapi/newsclip/v2/search?keyword=AI&page=1&page_size=20" \
  -H "PULITZER-API-KEY: YOUR_API_KEY"

기사 상세 조회

뉴스 기사의 상세 정보를 조회합니다.

GET https://api.pulitzer.ai/live/openapi/newsclip/v2/{`{article_id}`}

응답

{
  "status": "SUCCESS",
  "success": true,
  "message": "기사 조회 성공",
  "data": {
    "id": 12345,
    "title": "OpenAI Announces GPT-5",
    "title_ko": "OpenAI, GPT-5 발표",
    "summary_ko": "OpenAI가 차세대 언어 모델 GPT-5를 공개했습니다...",
    "url": "https://example.com/article",
    "source": "TechCrunch",
    "published_kst": "2026-05-26T09:00:00",
    "img_url": "https://example.com/image.jpg"
  }
}
curl -X GET "https://api.pulitzer.ai/live/openapi/newsclip/v2/123" \
  -H "PULITZER-API-KEY: YOUR_API_KEY"

엑셀 다운로드

뉴스 기사를 엑셀 파일로 다운로드합니다. 다운로드당 크레딧이 차감됩니다.

GET https://api.pulitzer.ai/live/openapi/newsclip/v2/download/excel

Query Parameters

파라미터타입필수설명
start_datestring✅시작일 (YYYY-MM-DD)
end_datestring✅종료일 (YYYY-MM-DD)
keyword_group_idinteger❌키워드 그룹 ID

응답

응답은 Excel 파일 바이너리입니다. Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

curl -X GET "https://api.pulitzer.ai/live/openapi/newsclip/v2/download/excel?start_date=2026-05-19&end_date=2026-05-26&keyword_group_id=1" \
  -H "PULITZER-API-KEY: YOUR_API_KEY" \
  -o news_articles.xlsx