Hong Kong World News API

Get the live top world headlines from Hong Kong 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 Hong Kong. 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=hk&apikey=YOUR_API_KEY

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=world" \
  --data-urlencode "country=hk" \
  --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": "hk", "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: "hk",
    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"  => "hk",
    "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=hk&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": 57430,
    "articles": [
        {
            "id": "6e59aa579cbc529a913de3b4f23b0405",
            "title": "2026年美国中期选举实时更新结果",
            "description": "美国国会由众议院和参议院组成。众议院全部435个议席都会改选，众议员任期固定为两年。与此同时，参议院100个议席中，有35席亦会进行改选。参议员任期为六年。",
            "content": "Published 2026年11月3日\n最近更新： 43 分钟前\n阅读时间: 2 分钟\n美国中期选举在当地时间11月3日举行投票。\n选民将选出国会议员。美国国会由众议院和参议院组成。众议院全部435个议席都会改选，众议员任期固定为两年。与此同时，参议院100个议席中，有35席亦会进行改选。参议员任期为六年。\n国会的一项重要职责是制定及通过联邦法律，也就是适用于全国的法律。法律草案通常会先在众议院提出及辩论，而参议员的职责包括审议众议院提交的法案，决定通过或否决。\n中期选举结果将决定由特朗普所属... [631 chars]",
            "url": "https://www.bbc.com/zhongwen/articles/c5rmyrm0n8k8o/simp",
            "image": "https://ichef.bbci.co.uk/news/1200/branded_zhongwen/0722/live/5cb72e20-be3c-11f1-a64c-550be9e3c66b.png",
            "publishedAt": "2026-11-03T23:56:25Z",
            "lang": "zh",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        },
        {
            "id": "ceb753f6bc139a2d830476e4f4290ce3",
            "title": "70年前「蘇伊士運河危機」重演 一條海道搞殘特朗普 歷史奇妙輪迴",
            "description": "美國國會中期選舉今日正式投票，普遍預測民主黨可重奪眾議院控制權，參議院之爭仍勝負難料，要鬥到最後才有分曉。共和黨今次處於劣勢，皆因遇上民怨洪流，燃油價飆升、生活成本急漲，令老百姓叫苦連天，遂把不滿投向",
            "content": "美國國會中期選舉今日正式投票，普遍預測民主黨可重奪眾議院控制權，參議院之爭仍勝負難料，要鬥到最後才有分曉。共和黨今次處於劣勢，皆因遇上民怨洪流，燃油價飆升、生活成本急漲，令老百姓叫苦連天，遂把不滿投向共和黨候選人，而問題的根源，是特朗普發動伊戰，導致霍峽關閉。歷史很奇妙，70年前中東爆發震動世界的「蘇伊士運河危機」，導致英國領導人垮台，大英帝國自此由盛轉衰，這危機於70年後重演，同樣是一條海道，把特朗普搞殘。\n70年前「蘇伊士運河危機」重演，特朗普的魔力失靈，令共和黨在中期選舉陷入困境，歷史輪迴... [2496 chars]",
            "url": "https://www.bastillepost.com/hongkong/article/17108103-70%E5%B9%B4%E5%89%8D%E3%80%8C%E8%98%87%E4%BC%8A%E5%A3%AB%E9%81%8B%E6%B2%B3%E5%8D%B1%E6%A9%9F%E3%80%8D%E9%87%8D%E6%BC%94-%E4%B8%80%E6%A2%9D%E6%B5%B7%E9%81%93%E6%90%9E%E6%AE%98%E7%89%B9%E6%9C%97",
            "image": "https://image.bastillepost.com/640x/wp-content/uploads/hongkong/2026/11/cropped-image-1777468516-2.jpg",
            "publishedAt": "2026-11-03T12:33:05Z",
            "lang": "zh",
            "source": {
                "id": "14ab6f8a91e53fac8ba3832be44971f6",
                "name": "巴士的報",
                "url": "https://www.bastillepost.com"
            }
        },
        {
            "id": "0e834dd8ffb05d3559d19c475bfa498e",
            "title": "不出意外的話，一場小小的台海之戰，很可能成為中國的世紀之戰",
            "description": "81年前的10月25日，台北公會堂門前擠滿了人，鞭炮聲、歡呼聲混在一起，很多人熱淚盈眶。那一天，被日本殖民統治",
            "content": "81年前的10月25日，台北公會堂門前擠滿了人，鞭炮聲、歡呼聲混在一起，很多人熱淚盈眶。那一天，被日本殖民統治了整整50年的台灣，回到了祖國懷抱。\n81年後的同一天，我們迎來了第一個以國家名義設立的台灣光復紀念日。可海峽還橫在那裡，網上的聲音越來越急：就這麼一個島，為什麼還不動手？\n這個問題，值得我們沉下心，好好聊一聊。\n81年前的那一天，和今天的紀念日\n先把記憶拉回那段屈辱與榮光交織的歲月。\n1895年，甲午戰敗，清政府簽下《馬關條約》，台灣被割讓出去，整整50年。那半個世紀裡，台灣同胞的反抗... [1975 chars]",
            "url": "https://beyondnews852.com/20261103/255787/",
            "image": "https://beyondnews852.com/wp-content/uploads/2026/11/6c0b649fc.jpg",
            "publishedAt": "2026-11-03T03:37:29Z",
            "lang": "zh",
            "source": {
                "id": "2921c37511171adab8f570ca0661d8f4",
                "name": "《超越新聞網》",
                "url": "https://beyondnews852.com"
            }
        }
    ]
}

Missing a source from Hong Kong? Suggest a source.

Hong Kong World News API

Categories

Request and live response