NewsClip API

Use the NewsClip API to manage news monitoring keyword groups, and retrieve, search, or download collected news articles.

Authentication

All API requests require an API key in the PULITZER-API-KEY header.

Header Setup

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"

List Keyword Groups

Retrieve the list of news monitoring keyword groups.

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

Response

{
  "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"

Create Keyword Group

Create a news monitoring keyword group.

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

Request Body

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

Request Body Parameters

ParameterTypeRequiredDescription
keywordsarray[string]✅Monitoring keyword list (max 10)
group_namestring✅Group name (max 100 chars)
regionstring❌Region (domestic/overseas, default: domestic)

Response

{
  "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", "artificial intelligence", "GPT"],
    "group_name": "AI Trends",
    "region": "domestic"
  }'

Delete Keyword Group

Delete a keyword group.

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

Response

{
  "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"

News Themes

Retrieve available news theme list.

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

Response

{
  "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"

Recent Articles

Retrieve recently collected news articles.

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

Query Parameters

ParameterTypeRequiredDescription
limitinteger❌Number of results (1-100, default: 20)
keyword_group_idinteger❌Filter by keyword group ID

Response

{
  "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"

Daily News

Retrieve daily news grouped by date.

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

Query Parameters

ParameterTypeRequiredDescription
keyword_group_idinteger❌Keyword group ID
start_datestring❌Start date (YYYY-MM-DD)
end_datestring❌End date (YYYY-MM-DD)
page_sizeinteger❌Number of days (1-30, default: 7)

Response

{
  "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"

Search News

Search collected news by keyword.

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

Query Parameters

ParameterTypeRequiredDescription
keywordstring✅Search keyword
pageinteger❌Page number (default: 1)
page_sizeinteger❌Page size (1-100, default: 20)

Response

{
  "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"

Article Detail

Retrieve detailed information of a news article.

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

Response

{
  "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"

Download Excel

Download news articles as an Excel file. Credits are deducted per download.

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

Query Parameters

ParameterTypeRequiredDescription
start_datestring✅Start date (YYYY-MM-DD)
end_datestring✅End date (YYYY-MM-DD)
keyword_group_idinteger❌Keyword group ID

Response

Response is an Excel file binary. 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