Taiwan World News API

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

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=world" \
  --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": "world", "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: "world",
    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" => "world",
    "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=world&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": 121600,
    "articles": [
        {
            "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"
            }
        },
        {
            "id": "722550fb56fe47d5c2461a9b8b474995",
            "title": "最有好感的鄰國是誰？日本網友一面倒選「台灣」 南韓人超崩潰",
            "description": "近期一名南韓網友常好奇「讓日本人最有好感的鄰近國家」會是誰，於是PO文詢問並列出5個與鄰近日本的國家，分別有「南韓」、「台灣」、「中國」、「俄羅斯」以及「菲律賓」，另在文末自信推測會有超過9成的日本人選南韓，未料該文一出，日本人一面倒選擇「台灣」，還細數2國深厚友情，讓原PO當場崩潰！據了解，社群平台X（前Twitter）名為「Mokiry」的南韓網友，昨（2日）晚間列出5個與日本地理位置相近的國家，並邀請日本網友留言回答，讓他們最有好感的國家是誰。原PO還在文末強調，從種族、政治、經濟與文化上的距離感來看，南韓都與日本最為接近，大膽預測會有超過9成的日本網友選擇南韓。",
            "content": "日本與台灣。（本報合成）\n近期一名南韓網友常好奇「讓日本人最有好感的鄰近國家」會是誰，於是PO文詢問並列出5個與鄰近日本的國家，分別有「南韓」、「台灣」、「中國」、「俄羅斯」以及「菲律賓」，另在文末自信推測會有超過9成的日本人選南韓，未料該文一出，日本人一面倒選擇「台灣」，還細數2國深厚友情，讓原PO當場崩潰！\n據了解，社群平台X（前Twitter）名為「Mokiry」的南韓網友，昨（2日）晚間列出5個與日本地理位置相近的國家，並邀請日本網友留言回答，讓他們最有好感的國家是誰。原PO還在文末強調... [1088 chars]",
            "url": "https://news.ltn.com.tw/news/novelty/breakingnews/5628331",
            "image": "https://img.ltn.com.tw/Upload/news/600/2026/11/03/php4R6kvY.jpg",
            "publishedAt": "2026-11-03T14:06:19Z",
            "lang": "zh",
            "source": {
                "id": "7d59262a61bd6d48d1dd71f70d1efdc7",
                "name": "自由時報",
                "url": "https://news.ltn.com.tw"
            }
        },
        {
            "id": "c80a65e969a44d15e78e4968319f631a",
            "title": "英國移民政策改革改什麼？BNO港人會受影響嗎？",
            "description": "內政大臣公布改革英國永久居留要求的計劃。",
            "content": "英國移民改革改什麼？BNO港人會受影響嗎？\nAuthor, 貝琪·莫頓（Becky Morton）\nRole, BBC政治記者\nPublished 2026年11月3日\n閱讀時間: 3 分鐘\n英國內政大臣馬曼婷（Shabana Mahmood）公布了全面改革移民規則的計劃。\n有關修改取得英國永久居留資格要求的建議，最初於2025年11月首次詳細提出，當時馬曼婷在施紀賢爵士（Sir Keir Starmer）政府中擔任內政大臣。\n在完成公眾諮詢後，馬曼婷現已公布最終決定，說明哪些改革措施將會付諸實... [1352 chars]",
            "url": "https://www.bbc.com/zhongwen/articles/c63r50z3npr7o/trad",
            "image": "https://ichef.bbci.co.uk/news/1200/branded_zhongwen/7b2f/live/fc3bc9d0-d6fe-11f1-b983-c357054e4d1e.jpg",
            "publishedAt": "2026-11-03T11:57:18Z",
            "lang": "zh",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        }
    ]
}

Missing a source from Taiwan? Suggest a source.

Taiwan World News API

Categories

Request and live response