Taiwan News API

Get the live top 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 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=general&country=tw&apikey=YOUR_API_KEY

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=general" \
  --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": "general", "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: "general",
    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" => "general",
    "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=general&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": 128622,
    "articles": [
        {
            "id": "d5e51b281a022745d90015aef58d8528",
            "title": "《GTA 6》11 月 10 日開放預載！最多需 212GB 儲存空…",
            "description": "Rockstar Games 確認將原定於 11 月 12 日開放的《GTA 6》數位版預載提前至 11 月 10 日，讓玩家有更充裕的時間下載遊戲，準備在 11 月 19 日重返罪惡城市。不過，這次遊戲最多需要預留高達 212GB 的儲存空間，看來玩家可能得先替主機好好清理一番了！官方也確認將於遊戲發售當天，在官網提供《GTA 6》封面海報及雷奧奈達州地圖的免費數位下載版本，讓玩家自行列印收藏。",
            "content": "距離《俠盜獵車手 VI》（Grand Theft Auto VI；GTA 6）正式發售只剩下約兩週，Rockstar Games 如今也公布了最新預載安排，確認將原定於 11 月 12 日開放的數位版預載提前至 11 月 10 日，讓玩家有更充裕的時間下載遊戲，準備在 11 月 19 日重返罪惡城市（Vice City）。\n不過，這次遊戲最多需要預留高達 212GB 的儲存空間，看來玩家可能得先替主機好好清理一番了！\n根據 Rockstar Games 於 11 月 3 日發布的 官方公告，PS... [1171 chars]",
            "url": "https://nmiagaming.com/posts/gta-6-preload-begins-november-10-requires-up-to-212gb-physical-map-poster-also-available",
            "image": "https://dn2rwli0e0lll.cloudfront.net/strapi-uploads-cn/gta6preload212gbwithphysicalmaponlaunchfi_941953520f.webp",
            "publishedAt": "2026-11-04T01:53:38Z",
            "lang": "zh",
            "source": {
                "id": "b2c2c523d8fd46d90d04006a363ef041",
                "name": "Nmia Gaming",
                "url": "https://nmiagaming.com"
            }
        },
        {
            "id": "15eab8b78e800ddc407dea834a37436a",
            "title": "《上古卷軸6：Sentinel》副標題揭曉 續作最快 2028 年問世",
            "description": "圖／示意圖商傳媒｜吳承岳／台北報導遊戲開發商貝塞斯達遊戲工作室（Bethesda Game Studios）昨日正式公布其旗下史詩級角色扮演遊戲《上古卷軸6》的完整副標題為「Sentinel」，同時揭露了遊戲標誌。這款備受期待的《上古卷軸V：無界天際》（Skyrim）續作，距離玩家上市預計還需等待數年，最快可能於 2028 年底與全球玩家見面。 自從 2018 年首次公布以來，《上古卷軸6》就吸引了全球玩家的高度關注。遊戲在 2023 年《星空》（Starfield）發售後才正式進入活躍開發階段。執行製作人託德·霍華德（Todd Howard）曾在 2021 年預期，遊戲可能在《上古卷軸V：無界天際》發售後 15 至 17 年才會推出，這意味著最快也要到 2028 年，玩家才能體驗到《上古卷軸6：Sentinel》。 彭博社記者傑森·施賴爾（Jason Schreier）也證實，該遊戲的發布時間預計還需要兩年以上。《Wccftech》報導指出，這款新作可能將成為微軟（Microsoft）旗下 Xbox 次世代遊戲主機於 2028 年假期檔期的首發作品。此外，有傳聞認為，近期 Xbox",
            "content": "商傳媒｜吳承岳／台北報導\n遊戲開發商貝塞斯達遊戲工作室（Bethesda Game Studios）昨日正式公布其旗下史詩級角色扮演遊戲《上古卷軸6》的完整副標題為「Sentinel」，同時揭露了遊戲標誌。這款備受期待的《上古卷軸V：無界天際》（Skyrim）續作，距離玩家上市預計還需等待數年，最快可能於 2028 年底與全球玩家見面。\n自從 2018 年首次公布以來，《上古卷軸6》就吸引了全球玩家的高度關注。遊戲在 2023 年《星空》（Starfield）發售後才正式進入活躍開發階段。執行製... [581 chars]",
            "url": "https://tw.stock.yahoo.com/news/%E4%B8%8A%E5%8F%A4%E5%8D%B7%E8%BB%B86-sentinel-%E5%89%AF%E6%A8%99%E9%A1%8C%E6%8F%AD%E6%9B%89-%E7%BA%8C%E4%BD%9C%E6%9C%80%E5%BF%AB-2028-235914360.html",
            "image": "https://s.yimg.com/lo/mysterio/api/e0e195d692c6af88f288420393ea6ec197f305f90a9cb64a7ad013fbe7083af0/lightyear_networkapi/resizefill_w1200%3Bquality_80%3Bformat_webp/https%3A%2F%2Fmedia.zenfs.com%2Fno%2Fsunmedia_664%2Ff1ce443ad00779424d2ce34c46939aab.jpg",
            "publishedAt": "2026-11-03T23:59:14Z",
            "lang": "zh",
            "source": {
                "id": "c1a5c67e9d9573c2f458f4c3e5cb9ec4",
                "name": "Yahoo股市",
                "url": "https://tw.stock.yahoo.com"
            }
        },
        {
            "id": "78d3cec26320f83679ca70af5aa5c98b",
            "title": "最有好感鄰國？日本網友一面倒選「台灣」 南韓人超崩潰",
            "description": "首次上稿 11-03 22:06更新時間 11-04 06:50一名南韓網友好奇「讓日本人最有好感的鄰近國家」會是誰，近期PO文列出5個日本鄰國，分別有「南韓」、「台灣」、「中國」、「俄羅斯」以及「菲律賓」，文末自信推測超過9成日本人會選南韓，未料該文一出，日本人一面倒選擇「台灣」，還細數台日2國深厚友情，讓原PO當場崩潰！",
            "content": "日本與台灣。（本報合成）\n首次上稿 11-03 22:06\n更新時間 11-04 06:50\n一名南韓網友好奇「讓日本人最有好感的鄰近國家」會是誰，近期PO文列出5個日本鄰國，分別有「南韓」、「台灣」、「中國」、「俄羅斯」以及「菲律賓」，文末自信推測超過9成日本人會選南韓，未料該文一出，日本人一面倒選擇「台灣」，還細數台日2國深厚友情，讓原PO當場崩潰！\n請繼續往下閱讀...\n據了解，社群平台X（前Twitter）名為「Mokiry」的南韓網友，昨（2日）晚間列出5個與日本地理位置相近的國家，並... [1110 chars]",
            "url": "https://news.ltn.com.tw/news/world/breakingnews/5628331",
            "image": "https://img.ltn.com.tw/Upload/news/600/2026/11/03/php4R6kvY.jpg",
            "publishedAt": "2026-11-03T22:50:00Z",
            "lang": "zh",
            "source": {
                "id": "7d59262a61bd6d48d1dd71f70d1efdc7",
                "name": "自由時報",
                "url": "https://news.ltn.com.tw"
            }
        }
    ]
}

Missing a source from Taiwan? Suggest a source.

Taiwan News API

Categories

Request and live response