Hong Kong News API

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

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=general" \
  --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": "general", "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: "general",
    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" => "general",
    "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=general&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": 48862,
    "articles": [
        {
            "id": "6e59aa579cbc529a913de3b4f23b0405",
            "title": "2026年美国中期选举实时更新结果",
            "description": "美国国会由众议院和参议院组成。众议院全部435个议席都会改选，众议员任期固定为两年。与此同时，参议院100个议席中，有35席亦会进行改选。参议员任期为六年。",
            "content": "Published 2026年11月3日\n最近更新： 3 小时前\n阅读时间: 2 分钟\n美国中期选举在当地时间11月3日举行投票。\n选民将选出国会议员。美国国会由众议院和参议院组成。众议院全部435个议席都会改选，众议员任期固定为两年。与此同时，参议院100个议席中，有35席亦会进行改选。参议员任期为六年。\n国会的一项重要职责是制定及通过联邦法律，也就是适用于全国的法律。法律草案通常会先在众议院提出及辩论，而参议员的职责包括审议众议院提交的法案，决定通过或否决。\n中期选举结果将决定由特朗普所属的... [630 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": "2cedb047fa7f9af7b2613747a228c988",
            "title": "簡尼入球斷纜有助攻 拜仁贈馬體會雙蛋",
            "description": "雖然哈利簡尼在歐聯的連續入球走動告終，但貢獻助攻，協助拜仁慕尼黑周二在歐聯作客以2:0打敗馬德里體育會。拜仁今仗焦點仍是上星期奪得金球獎的哈利簡尼（Harry Kane），他之前連續10場歐聯比賽建功，今仗若再有進帳，便可追平基斯坦奴朗拿度所保持的最長連續入球紀錄。作客的拜仁上半場反客為主，但未有入球。卡爾於換邊後9分鐘奪去路羅賀莫的腳下球後近門左腳射入，替拜仁打破悶局。 74分鐘，簡尼傳交予拉馬勁射，皮球直飛網頂，助拜仁領先2:0。簡尼今仗並非全沒機會，先有一次凌空施射偏離目標，其後一次勁射斜出，未能取得入球。 馬體會全場只有1次中框射門，破蛋乏力。拜仁賽後兩勝兩和得8分排第8，馬體會得4分排22。",
            "content": "係咪癲㗎！PSG殘陣打沉黃潛刷新紀錄\n王者就是王者，明明缺少多名主將，巴黎聖日耳門周二在歐聯作客維拉利爾，以6:0大勝，其中頭17分鐘以迅雷不及掩耳的速度轟4球，刷新賽事紀錄，不止是球迷，就連主帥安歷基也承認始料不及。衛冕的巴黎聖日耳門雖然缺少奧斯文丹比利、基化史基尼亞、馬昆奴斯及紐奴文迪斯等主將，但17分鐘內由祖奧尼維斯、杜爾、馬約路及法比安路爾斯的入球遙遙領先至4:0，是賽事歷來最快攻入4球的紀錄。 教練安歷基賽後說：「我當然沒預計到會這樣，但有時比賽就是有這樣的開局。我們整場表現出色，為此... [7959 chars]",
            "url": "https://hk.sports.yahoo.com/news/%E7%B0%A1%E5%B0%BC%E5%85%A5%E7%90%83%E6%96%B7%E7%BA%9C%E6%9C%89%E5%8A%A9%E6%94%BB-%E6%8B%9C%E4%BB%81%E8%B4%88%E9%A6%AC%E9%AB%94%E6%9C%83%E9%9B%99%E8%9B%8B-220422432.html",
            "image": "https://s.yimg.com/lo/mysterio/api/b6a584ca2e53b8777d0075366d79821ff625e2aed5fc63ff033ccd8a9d7b87e9/lightyear_networkapi/resizefill_w1200%3Bquality_80%3Bformat_webp/https%3A%2F%2Fmedia.zenfs.com%2Fko%2Fnowsports.com%2Fc74d3df03b592b522e5ad88b1356abff.jpg",
            "publishedAt": "2026-11-03T22:04:22Z",
            "lang": "zh",
            "source": {
                "id": "c1c378cc0e8308de79b3fa0e97d79d62",
                "name": "Yahoo體育：新聞",
                "url": "https://hk.sports.yahoo.com"
            }
        },
        {
            "id": "582f56d64f3f496a8ea44013b013984f",
            "title": "黃澤林堅稱10月先識譚旻萱 女方自爆9月搬新屋拍拖時間線有落差",
            "description": "香港網球一哥黃澤林（Coleman）與陳奕迅愛女陳康堤分手後，火速認愛「籃球女神」譚旻萱（Mandy）。昨晚（2日）黃澤林急致電JFFT「床哥」直播解畫，",
            "content": "香港網球一哥黃澤林（Coleman）與陳奕迅愛女陳康堤分手後，火速認愛「籃球女神」譚旻萱（Mandy）。昨晚（2日）黃澤林急致電JFFT「床哥」直播解畫，堅稱是「被飛」與康堤分手後，10月才認識Mandy。不過，隨即有報道及網民踢爆，Mandy早於9月初已在ig story高調爆料「搬新居」，疑入住與黃澤林在西貢別墅築愛巢，令「無縫接軌」時間線嚴重炒車，事件瞬間淪為羅生門！\n上床哥直播解畫 堅稱10月先識Mandy\n昨晚Coleman主動打上JFFT直播，引來逾1.5萬人同時觀看。他強調9月已經... [665 chars]",
            "url": "https://www.hk01.com/%E5%8D%B3%E6%99%82%E5%A8%9B%E6%A8%82/60406685/%E9%BB%83%E6%BE%A4%E6%9E%97%E5%A0%85%E7%A8%B110%E6%9C%88%E5%85%88%E8%AD%98%E8%AD%9A%E6%97%BB%E8%90%B1-%E5%A5%B3%E6%96%B9%E8%87%AA%E7%88%869%E6%9C%88%E6%90%AC%E6%96%B0%E5%B1%8B%E6%8B%8D%E6%8B%96%E6%99%82%E9%96%93%E7%B7%9A%E6%9C%89%E8%90%BD%E5%B7%AE",
            "image": "https://cdn.hk01.com/di/media/images/dw/20261103/1194356914591371264465809.jpeg/K4RyBiWpZs6UuGPOH_ygT8MGeKBOexudJNb5lCTW-ZQ",
            "publishedAt": "2026-11-03T08:43:33Z",
            "lang": "zh",
            "source": {
                "id": "ba8e9ada85358e891813f90db4cb47b8",
                "name": "香港01",
                "url": "https://www.hk01.com"
            }
        }
    ]
}

Missing a source from Hong Kong? Suggest a source.

Hong Kong News API

Categories

Request and live response