Taiwan News API

Get the live top 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 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);
}

<?php

$apiKey = "YOUR_API_KEY";

$query = http_build_query([
    "category" => "general",
    "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=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": 127218,
    "articles": [
        {
            "id": "3d0bd3504ff7f2ef4a4f6f7841a51ef9",
            "title": "鍵盤、滑鼠、耳機再搭配上滑鼠墊，MSI 40 週年 Draco Epic Edition 週邊產品開箱",
            "description": "MSI 的週邊裝置搭配上天龍座，也讓他們更有看頭。 MSI 40 週年系列產品，我們已經見過 MSI […]",
            "content": "MSI 的週邊裝置搭配上天龍座，也讓他們更有看頭。\nMSI 40 週年系列產品，我們已經見過 MSI GeForce RTX 5080 16G Suprim Draco Epic Edition 顯示卡，現在輪到系列週邊產品，包含了 Strike Wireless 8K HE Draco Epic Edition 三模無線鍵盤、Versa Wireless 8K Draco Epic Edition 三模無線滑鼠、Agility Draco Epic Edition 滑鼠墊與 Maestro W... [2817 chars]",
            "url": "https://benchlife.info/msi-striker-keyboard-versa-mouse-agility-maestro-headset-draco-epic-edition-unbox/",
            "image": "https://benchlife.info/wp-content/uploads/2026/10/gaming-gear-draco-epic_8.jpg",
            "publishedAt": "2026-10-14T05:20:07Z",
            "lang": "zh",
            "source": {
                "id": "a8b728dfd7beefe876fe6e4151dfc827",
                "name": "BenchLife.info",
                "url": "https://benchlife.info"
            }
        },
        {
            "id": "67c893ddee736a07284ca0da7f73a94c",
            "title": "美國果然釜底抽薪",
            "description": "之前還是猜測，馬上得到證實，美國果然一言不合，釜底抽薪。 看了一下時間，已經是北京時間10月14日凌晨，烏克蘭",
            "content": "之前還是猜測，馬上得到證實，美國果然一言不合，釜底抽薪。\n看了一下時間，已經是北京時間10月14日凌晨，烏克蘭總統澤連斯基兀自在社交媒體上吐槽：「俄羅斯對基輔的彈道導彈襲擊。我們的夥伴再次沒有提供早期預警……我們的系統只能在導彈幾乎逼近基輔時才探測到它們。」\n結果，基輔損失慘重。\n澤連斯基接著哀嘆：「這絕對不公：當他們摧毀我們的能源基礎設施時，烏克蘭甚至沒有收到關於彈道導彈發射的早期預警。」\n什麼意思？\n澤連斯基沒有明確說，哪個夥伴沒有向烏克蘭提供導彈來襲預警。\n但全世界都清楚，他說的就是美國，... [1678 chars]",
            "url": "https://beyondnews852.com/20261014/254449/",
            "image": "https://cdn.beyondnews852.com/wp-content/uploads/2026/10/cccab1bbe0.jpg",
            "publishedAt": "2026-10-14T03:12:05Z",
            "lang": "zh",
            "source": {
                "id": "2921c37511171adab8f570ca0661d8f4",
                "name": "《超越新聞網》",
                "url": "https://beyondnews852.com"
            }
        },
        {
            "id": "3bff13d41a375b13808b23084332160f",
            "title": "黃奇帆：薄熙來前搭檔遭中共中央紀委調查",
            "description": "黃奇帆擔任重慶市長期間，上級薄熙來與同僚王立軍系列醜聞爆發。離任後，他仍以經濟學家身分周遊演說。",
            "content": "中共中央紀委：薄熙來前搭檔黃奇帆接受調查\nPublished 2026年10月13日中午11時45分\n最近更新： 2 小時前\n閱讀時間: 4 分鐘\n中共反貪腐機關宣佈，已離任多時的前重慶市市長黃奇帆被立案調查。\n中共中央紀律檢查委員會星期二（10月13日）宣佈，74歲的黃奇帆「涉嫌嚴重違紀違法」，正接受紀律審查和監察調查。通報一如慣例未說明其具體罪嫌，但一般意味著是貪污腐敗。\n黃奇帆2001年起於重慶任職，2010年起出任市長兼中共市委副書記，不久後便爆發市委書記薄熙來與副市長兼公安局長王立軍系... [2108 chars]",
            "url": "https://www.bbc.com/zhongwen/articles/c63r584g9xwpo/trad",
            "image": "https://ichef.bbci.co.uk/news/1200/branded_zhongwen/0c99/live/5d77d1d0-c70a-11f1-bc2e-018d645d8d21.jpg",
            "publishedAt": "2026-10-13T13:48:39Z",
            "lang": "zh",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        }
    ]
}

Missing a publisher from Taiwan? Suggest a source.

Taiwan News API

Categories

Request and live response