Taiwan Nation News API

Get the live top nation headlines from Taiwan 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 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);
}

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" => "nation",
    "country"  => "tw",
    "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=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": 104594,
    "articles": [
        {
            "id": "6f29327a17e22b0720dec4f8b070c9f6",
            "title": "巫妖王要搬家了！台中「阿薩斯」雕像佇立 10 年宣布告別",
            "description": "對於《魔獸世界》（World of Warcraft）玩家而言，位於台中草悟道的「巫妖王阿薩斯」巨型雕像，絕對是台灣最具代表性的遊戲文化地標之一。然而，這位在台中佇立長達 10 年的巫妖王，如今也迎來了告別的時刻。 《魔獸世界》官方 Facebook 粉絲專頁於今日（11 月 2 日）稍早突然發布公告，宣布由於場地租約即將到期，陪伴台灣玩家整整 10 年的阿薩斯雕像，即將正式搬離台中，並預定於 2026 年 12 月 4 日（五）進行搬遷。 巫妖王要搬家了！阿薩斯雕像 12 月 4 日告別台中 《魔獸世界》官方今日在 Facebook 分享了一系列照片，只見原本霸氣十足、手持「霜之哀傷」的阿薩",
            "content": "對於《魔獸世界》（World of Warcraft）玩家而言，位於台中草悟道的「巫妖王阿薩斯」巨型雕像，絕對是台灣最具代表性的遊戲文化地標之一。然而，這位在台中佇立長達 10 年的巫妖王，如今也迎來了告別的時刻。\n《魔獸世界》官方 Facebook 粉絲專頁於今日（11 月 2 日）稍早突然發布公告，宣布由於場地租約即將到期，陪伴台灣玩家整整 10 年的阿薩斯雕像，即將正式搬離台中，並預定於 2026 年 12 月 4 日（五）進行搬遷。\n巫妖王要搬家了！阿薩斯雕像 12 月 4 日告別台中\n... [541 chars]",
            "url": "https://www.cool-style.com.tw/wd2/archives/1359032-%E5%B7%AB%E5%A6%96%E7%8E%8B%E8%A6%81%E6%90%AC%E5%AE%B6%E4%BA%86%EF%BC%81%E5%8F%B0%E4%B8%AD%E3%80%8C%E9%98%BF%E8%96%A9%E6%96%AF%E3%80%8D%E9%9B%95%E5%83%8F%E4%BD%87%E7%AB%8B-10-%E5%B9%B4%E5%AE%A3",
            "image": "https://cdn-origin.cool-style.com.tw/cool/2026/11/00001.png",
            "publishedAt": "2026-11-02T10:34:58Z",
            "lang": "zh",
            "source": {
                "id": "8c02d3c2f9bb06994e0327e49ae1433b",
                "name": "COOL-STYLE 潮流生活網",
                "url": "https://www.cool-style.com.tw"
            }
        },
        {
            "id": "429e9f30ae06568292e5d49270230023",
            "title": "洋流發威了！沈伯洋Threads瀏覽數「30天破1億」 驚人數據曝光",
            "description": "民進黨台北市長候選人沈伯洋網路聲量狂飆，Threads粉絲數達82.5萬，個人頁面瀏覽次數突破1億。萬聖節當天，他更特別Cosplay人氣動畫《葬送的芙莉蓮》勇者欣梅爾參與車隊掃街，成功引發話題。面對緊湊行程，他深夜發文感謝支持者，強調會把握選戰最後27天全力衝刺，爭取選民認同。",
            "content": "其他人也在看\n看完北市長辯論會 陳揮文曝蔣萬安一事：輸得有點離譜\n台北市長電視辯論會落幕，民進黨候選人沈伯洋與現任市長蔣萬安的對決引發熱議。資深媒體人陳揮文指出，雖然選舉輸贏看的是選票而非辯論或民調，但蔣萬安個人頻道的線上收看人數僅4000多人，對比沈伯洋的16萬人，流量輸得有些離譜。根據統計，沈伯洋在YouTube的尖峰在線人數更衝破17萬，展現強大空戰熱度。\n三立新聞網 setn.com ・ 2 小時前 ・ 77則留言\n台北市長辯論大亂鬥！媒體人給「他」打90分：比預期強大\n台北市長候選人首... [4132 chars]",
            "url": "https://tw.news.yahoo.com/%E6%B4%8B%E6%B5%81%E7%99%BC%E5%A8%81%E4%BA%86-%E6%B2%88%E4%BC%AF%E6%B4%8Bthreads%E7%80%8F%E8%A6%BD%E6%95%B8-30%E5%A4%A9%E7%A0%B41%E5%84%84-%E9%A9%9A%E4%BA%BA%E6%95%B8%E6%93%9A%E6%9B%9D%E5%85%89-010900815.html",
            "image": "https://s.yimg.com/lo/mysterio/api/93d8b903207358c748336f6ed5e7a6281e0f93f6375d7a13f0469140af94cd90/lightyear_networkapi/resizefill_w1200%3Bquality_80%3Bformat_webp/https%3A%2F%2Fmedia.zenfs.com%2Fzh-tw%2Fsetn.com.tw%2F355b7e06f82a4c827eebb988f946020a.jpg",
            "publishedAt": "2026-11-01T01:16:07Z",
            "lang": "zh",
            "source": {
                "id": "48111276806f667e38d6ad6673eaf3e8",
                "name": "Yahoo新聞",
                "url": "https://tw.news.yahoo.com"
            }
        },
        {
            "id": "b6dd907e8d81ef067c0d9ca8178ff47c",
            "title": "10/28台北、桃園13縣市停水！台中最長8小時沒供水 影響範圍出爐",
            "description": "記得儲水備用！據台灣自來水公司最新公告，10月28日（週三）在台北市、新北市、桃園市、台中市、台南市、高雄市以及宜蘭縣、彰化縣、雲林縣、屏東縣、花蓮縣、台東縣、...",
            "content": "記得儲水備用！據台灣自來水公司最新公告，10月28日（週三）在台北市、新北市、桃園市、台中市、台南市、高雄市以及宜蘭縣、彰化縣、雲林縣、屏東縣、花蓮縣、台東縣、澎湖縣總共13縣市部分地區將實施停水，原因包含舊管線汰換、漏水調查等，在台中還有長達8小時的停水事件。《NOWNEWS今日新聞》統整全台灣各縣市10月28日停水影響範圍與時間，讓民眾迅速掌握是否影響到自家供水情況。\n我是廣告 請繼續往下閱讀\n◼︎台北市10月28日停水範圍\n🕦影響時間：10月28日11時至15時(共4小時)\n📍停水地區\n中... [3469 chars]",
            "url": "https://www.nownews.com/news/6886941",
            "image": "https://media.nownews.com/nn_media/thumbnail/2026/07/1785134119685-498416d33fcc476b80898deedf804b63-1200x900.webp?unShow=false",
            "publishedAt": "2026-10-27T06:17:58Z",
            "lang": "zh",
            "source": {
                "id": "345a7c06893a4acc264fea63fa3c162a",
                "name": "NOWnews今日新聞",
                "url": "https://www.nownews.com"
            }
        }
    ]
}

Missing a source from Taiwan? Suggest a source.

Taiwan Nation News API

Categories

Request and live response