South Korea News API

Get the live top headlines from South Korea with one request to the Top Headlines endpoint of GNews API. Headlines are based on Google News rankings and returned as JSON.

Get API key

Request and live response

This request returns the current top headlines from South Korea. The response below is live: it was fetched when this page loaded. Every parameter is described in the Top Headlines endpoint documentation.

GET https://gnews.io/api/v4/top-headlines?category=general&country=kr&apikey=YOUR_API_KEY

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=general" \
  --data-urlencode "country=kr" \
  --data-urlencode "apikey=YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"

response = requests.get(
    "https://gnews.io/api/v4/top-headlines",
    params={"category": "general", "country": "kr", "apikey": API_KEY},
    timeout=10,
)
response.raise_for_status()

for article in response.json()["articles"]:
    print(article["title"])

const API_KEY = "YOUR_API_KEY";

const params = new URLSearchParams({
    category: "general",
    country: "kr",
    apikey: API_KEY,
});

const response = await fetch(`https://gnews.io/api/v4/top-headlines?${params}`);
if (!response.ok) {
    throw new Error(`Request failed: ${response.status}`);
}

const { articles } = await response.json();
for (const article of articles) {
    console.log(article.title);
}

On the Free plan, browsers can only call the API from localhost: see Using the API in the FAQ.

<?php

$apiKey = "YOUR_API_KEY";

$params = http_build_query([
    "category" => "general",
    "country"  => "kr",
    "apikey"   => $apiKey,
]);

$response = file_get_contents("https://gnews.io/api/v4/top-headlines?" . $params);
if ($response === false) {
    throw new RuntimeException("Request failed");
}

$data = json_decode($response, true);
foreach ($data["articles"] as $article) {
    echo $article["title"] . PHP_EOL;
}

using System.Net.Http.Json;

const string ApiKey = "YOUR_API_KEY";

using var client = new HttpClient();

var url = $"https://gnews.io/api/v4/top-headlines?category=general&country=kr&apikey={ApiKey}";
var data = await client.GetFromJsonAsync<ApiResponse>(url)
           ?? throw new InvalidOperationException("Empty response");

foreach (var article in data.Articles)
{
    Console.WriteLine(article.Title);
}

record ApiResponse(List<Article> Articles);
record Article(string Title);

200 OK · Live JSON response

{
    "totalArticles": 173068,
    "articles": [
        {
            "id": "86f6897e27e39a9ee046526365489bb3",
            "title": "NASA 스위프트 우주망원경 오늘 저녁 재진입… 우주청 “한반도 추락 가능성 없어”",
            "description": "[천지일보=김정필 기자] 미국 항공우주청(NASA)의 스위프트(SWIFT) 우주망원경이 4일 저녁 지구 대기권에 재진입할 것으로 예상됐다. 다만 위성의 궤도 특성상 한반도에 떨어질 가능성은 없는 것으로 분석됐다.우주항공청은 4일 한국천문연구원의 분석 결과를 토대로 스위프트 우주망원경이",
            "content": "[천지일보=김정필 기자] 미국 항공우주청(NASA)의 스위프트(SWIFT) 우주망원경이 4일 저녁 지구 대기권에 재진입할 것으로 예상됐다. 다만 위성의 궤도 특성상 한반도에 떨어질 가능성은 없는 것으로 분석됐다.\n우주항공청은 4일 한국천문연구원의 분석 결과를 토대로 스위프트 우주망원경이 이날 오후 8시 46분께를 전후해 대기권에 진입할 것으로 예상된다고 밝혔다. 예상 시각의 오차 범위는 ±2시간이다.\n국외 기관들의 전망도 비슷한 시간대에 모이고... [692 chars]",
            "url": "https://www.newscj.com/news/articleView.html?idxno=3445847",
            "image": "https://cdn.newscj.com/news/thumbnail/202611/3445847_3570448_2824_v150.jpg",
            "publishedAt": "2026-11-04T04:29:01Z",
            "lang": "ko",
            "source": {
                "id": "3b4951536756f2812d14496499578500",
                "name": "천지일보",
                "url": "https://www.newscj.com"
            }
        },
        {
            "id": "636d053d9c32de41c26bbdd68e9474fd",
            "title": "질병청, 치매 관련 타우단백질 이동 촉진하는 ‘FAM84B’ 역할 규명",
            "description": "환자 유래 뇌조직·신경세포 분석 및 세포실험으로 확인신경염증 관련 타우 전이 기전 규명…치료 표적 연구 가능성 제시",
            "content": "[한의신문] 질병관리청(청장 임승관) 국립보건연구원(원장 남재환)은 알츠하이머병 등 치매와 관련된 타우단백질이 주변 뇌세포로 이동하는 과정에서 단백질 ‘FAM84B’가 이를 촉진하는 역할을 한다는 사실을 확인했다고 밝혔다.\n타우단백질은 신경세포의 구조를 유지하는 미세소관에 결합하는 단백질로, 비정상적으로 변형돼 축적되면 알츠하이머병 등 신경퇴행성 질환과 관련이 있다.\n특히 타우가 주변 세포로 확산되는 과정은 질병 진행에 영향을 미치는 것으로 알... [957 chars]",
            "url": "https://www.akomnews.com/bbs/board.php?bo_table=news&wr_id=68900",
            "image": "https://www.akomnews.com/data/photo/2611/2039300137_hy1DazFQ_a1a95525d85c029bc02836b3c879e4fc8daba503.png",
            "publishedAt": "2026-11-04T04:19:00Z",
            "lang": "ko",
            "source": {
                "id": "94adede523f90a07500b57fac3412e11",
                "name": "한의신문",
                "url": "https://www.akomnews.com"
            }
        },
        {
            "id": "4028e15fe259a46978f8775c45dc14d0",
            "title": "KBS 뉴스",
            "description": "댄 고(41·한국 이름 고원영) 후보가 현지 시각 3일 실시된 미국 중간선거에서 한국계 민주당 정치인으로 ...",
            "content": "기사 본문 영역\n[중간선거] 한국계 댄 고, 미 하원의원 당선…7번째 한국계 연방의원\n읽어주기 기능은 크롬기반의\n브라우저에서만 사용하실 수 있습니다.\n댄 고(41·한국 이름 고원영) 후보가 현지 시각 3일 실시된 미국 중간선거에서 한국계 민주당 정치인으로 연방 하원의원에 당선됐습니다.\n고 후보는 이번 당선으로 김창준 전 하원의원(공화·캘리포니아), 앤디 김 현 상원의원(민주·뉴저지), 미셸 스틸 전 하원의원(공화·캘리포니아), 영 김(공화·캘리... [2414 chars]",
            "url": "https://news.kbs.co.kr/news/pc/view/view.do?ncd=8703674",
            "image": "http://news.kbs.co.kr/data/news/2026/11/04/20261104_wpdf1f.jpg",
            "publishedAt": "2026-11-04T04:19:00Z",
            "lang": "ko",
            "source": {
                "id": "8f2a6b78f04f67a09991669b4a7413a0",
                "name": "KBS 뉴스",
                "url": "https://news.kbs.co.kr"
            }
        }
    ]
}

Missing a source from South Korea? Suggest a source.

South Korea News API

Categories

Request and live response