Taiwan Nation News API

Get the live top nation headlines from Taiwan with one request to the Top Headlines endpoint of GNews API. Stories are selected by Google News rankings and returned as clean JSON.

Get your free API key

Request and live response

This request returns the current top nation headlines from Taiwan. 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=nation&country=tw&apikey=YOUR_API_KEY

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=nation" \
  --data-urlencode "country=tw" \
  --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": "nation", "country": "tw", "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: "nation",
    country: "tw",
    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);
}

<?php

$apiKey = "YOUR_API_KEY";

$query = http_build_query([
    "category" => "nation",
    "country"  => "tw",
    "apikey"   => $apiKey,
]);

$response = file_get_contents("https://gnews.io/api/v4/top-headlines?" . $query);
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=nation&country=tw&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": 104366,
    "articles": [
        {
            "id": "3c88b500e9806dba446677225d005fe4",
            "title": "港媒爆父親公司「改名」續做中國生意 沈伯洋：為何選在這時候爆？",
            "description": "民進黨台北市長參選人沈伯洋遭港媒爆料，父親沈土城名下的「兆億有限公司」在2025年6月被中國制裁後，竟將公司名字更換後，繼續在對岸做生意，指沈伯洋的抗中形象不過是欺騙台灣民眾的幌子。沈伯洋昨天（13日）深夜回應，「為什麼有人這麼關心我家人的生意，這些消息從哪裡來？為什麼選在這個時候出現？」沈伯洋今天則說，他已被通緝且制裁，拭目以待看能端出什麼樣新菜。",
            "content": "民進黨台北市長參選人沈伯洋遭港媒爆料，父親沈土城名下的「兆億有限公司」在2025年6月被中國制裁後，竟將公司名字更換後，繼續在對岸做生意，指沈伯洋的抗中形象不過是欺騙台灣民眾的幌子。沈伯洋昨天（13日）深夜回應，「為什麼有人這麼關心我家人的生意，這些消息從哪裡來？為什麼選在這個時候出現？」沈伯洋今天則說，他已被通緝且制裁，拭目以待看能端出什麼樣新菜。\n中國大陸國台辦發言人陳斌華今天宣布，對沈伯洋父親沈土城的另一家公司VWAY CO.,LTD.（簡稱VWAY）實施懲戒，採取禁止其與中國大陸組織、企... [1808 chars]",
            "url": "https://tw.news.yahoo.com/%E6%B8%AF%E5%AA%92%E7%88%86%E7%88%B6%E8%A6%AA%E5%85%AC%E5%8F%B8%E3%80%8C%E6%94%B9%E5%90%8D%E3%80%8D%E7%BA%8C%E5%81%9A%E4%B8%AD%E5%9C%8B%E7%94%9F%E6%84%8F-%E6%B2%88%E4%BC%AF%E6%B4%8B%EF%BC%9A%E7%82%BA%E4%BD%95%E9%81%B8%E5%9C%A8%E9%80%99%E6%99%82%E5%80%99%E7%88%86%EF%BC%9F-020328391.html",
            "image": "https://s.yimg.com/lo/mysterio/api/9af53dc375656dae77d96d6f13f1568cf4c7d21958345337df0dfe65b8740354/lightyear_networkapi/resizefill_w1200%3Bquality_80%3Bformat_webp/https%3A%2F%2Fmedia.zenfs.com%2Fzh-tw%2Fcna.com.tw%2F11c3d8f728f22e083896a488245adbcb.jpg",
            "publishedAt": "2026-10-14T02:06:35Z",
            "lang": "zh",
            "source": {
                "id": "48111276806f667e38d6ad6673eaf3e8",
                "name": "Yahoo新聞",
                "url": "https://tw.news.yahoo.com"
            }
        },
        {
            "id": "1e102ecc534cceef4744ae63560469c4",
            "title": "政大美女教授是昔日同窗！曝「沈伯洋令人困擾」 以品格證人喊：台北值得你",
            "description": "即時中心／林韋慈報導近日，網紅律師林鄒罵在粉專披露，自己與民進黨台北市長參選人沈伯洋是台大法律系同窗，引發關注。她今（13）日再度發文，轉貼另一位台大同學、政大副教授康庭瑜的貼文，直言康才是與沈伯洋熟識的人。而康庭瑜則表示，沈伯洋是「非常令人困擾」的同學，因為當大家還在煩惱日常生活時，他已開始擔憂台灣的未來，她更以「character witness」（品格證人）的身分，表示台北值得沈伯洋。",
            "content": "即時中心／林韋慈報導\n近日，網紅律師林鄒罵在粉專披露，自己與民進黨台北市長參選人沈伯洋是台大法律系同窗，引發關注。她今（13）日再度發文，轉貼另一位台大同學、政大副教授康庭瑜的貼文，直言康才是與沈伯洋熟識的人。而康庭瑜則表示，沈伯洋是「非常令人困擾」的同學，因為當大家還在煩惱日常生活時，他已開始擔憂台灣的未來，她更以「character witness」（品格證人）的身分，表示台北值得沈伯洋。\n沈伯洋台大法律同學紛紛現身 美女副教授挺：他關心台灣到令人困擾\n今日，林鄒罵律師發文表示，昨天有電視節... [1116 chars]",
            "url": "https://tw.news.yahoo.com/%E6%94%BF%E5%A4%A7%E7%BE%8E%E5%A5%B3%E6%95%99%E6%8E%88%E6%98%AF%E6%98%94%E6%97%A5%E5%90%8C%E7%AA%97-%E6%9B%9D-%E6%B2%88%E4%BC%AF%E6%B4%8B%E4%BB%A4%E4%BA%BA%E5%9B%B0%E6%93%BE-%E4%BB%A5%E5%93%81%E6%A0%BC%E8%A6%8B%E8%AD%89%E4%BA%BA%E5%96%8A-%E5%8F%B0%E5%8C%97%E5%80%BC%E5%BE%97%E4%BD%A0-041540788.html",
            "image": "https://s.yimg.com/lo/mysterio/api/44fbb1cdbdc6d00d9305c22c89ed5c67e354bc5d522cb4050dba03d252ac536e/lightyear_networkapi/resizefill_w1200%3Bquality_80%3Bformat_webp/https%3A%2F%2Fmedia.zenfs.com%2Fvi%2Fftvn.com.tw%2F7cbc0d2961dd0c51841d9a0d5a5e55a3.jpg",
            "publishedAt": "2026-10-13T04:31:59Z",
            "lang": "zh",
            "source": {
                "id": "48111276806f667e38d6ad6673eaf3e8",
                "name": "Yahoo新聞",
                "url": "https://tw.news.yahoo.com"
            }
        },
        {
            "id": "69d31c495584c46136ca7a5ef7143cfd",
            "title": "台北投給她的34萬票如今支持誰？黃珊珊5問蔣萬安、沈伯洋",
            "description": "台北市長選戰激烈，近日外界議論過去投給無黨籍台北市長參選人黃珊珊的選民如今的投票意向，對此，黃珊珊今（13）日在臉書表示，台北市長蔣萬安和民進黨台北市長參選人沈伯洋真正該想的，不是4年前的黃珊珊34萬票會去哪裡，而是你能不能給中間選民一個支持你的理由。你想帶台北走向哪裡？你準備怎麼改善市民的生活？你能不能提出一個讓年輕人看得到希望、讓市民願意相信的未來？除了......",
            "content": "台北市長選戰激烈，近日外界議論過去投給無黨籍台北市長參選人黃珊珊的選民如今的投票意向，對此，黃珊珊今（13）日在臉書表示，台北市長蔣萬安和民進黨台北市長參選人沈伯洋真正該想的，不是4年前的黃珊珊34萬票會去哪裡，而是你能不能給中間選民一個支持你的理由。你想帶台北走向哪裡？你準備怎麼改善市民的生活？你能不能提出一個讓年輕人看得到希望、讓市民願意相信的未來？除了讓大家害怕對手，你還能帶給人民什麼？更重要的是，說出口的承諾，你做不做得到？\n黃珊珊表示，真正的第三勢力，是有選擇權的人民。理性的中間選民、... [1771 chars]",
            "url": "https://www.storm.mg/article/11171857",
            "image": "https://images.storm.mg/cloud/c7fe82793bbe067d5001a1c4c044cc2f25bc35eb.jpg?url=s3%3A%2F%2Fnew-storm-public-resource%2Fgallery%2F2098570%2F0OjOEfrENXazHECbRo6Um9IIblDROm0JnENUpXzo.jpg&g=sm&h=900&resize=fill&w=1600&format=jpg",
            "publishedAt": "2026-10-13T03:24:00Z",
            "lang": "zh",
            "source": {
                "id": "d9590760adbbd51e78bd1e2e7a728081",
                "name": "風傳媒",
                "url": "https://www.storm.mg"
            }
        }
    ]
}

Missing a publisher from Taiwan? Suggest a source.

Taiwan Nation News API

Categories

Request and live response