Saudi Arabia World News API

Get the live top world headlines from Saudi Arabia 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 Saudi Arabia. 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=sa&apikey=YOUR_API_KEY

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=world" \
  --data-urlencode "country=sa" \
  --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": "sa", "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: "sa",
    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"  => "sa",
    "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=sa&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": 36504,
    "articles": [
        {
            "id": "d092339890abbd7f1c98e66953a7c697",
            "title": "فوز الأمريكي من أصول مصرية آدم حموي بمقعد في الكونجرس",
            "description": "أفادت وكالة أسوشيتد برس الأمريكية بفوز الديمقراطي آدم حموي الأمريكي من أصول مصرية بمقعد في مجلس النواب عن الدائرة الثانية عشرة بولاية نيوجيرسي | مصراوي",
            "content": "حقق الديمقراطي آدم حموي، الأمريكي من أصول مصرية، فوزًا بمقعد في مجلس النواب الأمريكي عن الدائرة الثانية عشرة بولاية نيوجيرسي، ليصبح أول مسلم يمثل الولاية في الكونجرس، وفقًا لما أفادت به وكالة «أسوشيتد برس» الأمريكية.\nوفي سياق متصل، أعلنت الوكالة فوز ... [1062 chars]",
            "url": "https://www.masrawy.com/news/news_publicaffairs/details/2026/11/4/3073365/%D9%85%D9%86-%D8%A3%D8%B5%D9%88%D9%84-%D9%85%D8%B5%D8%B1%D9%8A%D8%A9-%D9%81%D9%88%D8%B2-%D8%A7%D9%84%D8%AF%D9%8A%D9%85%D9%82%D8%B1%D8%A7%D8%B7%D9%8A-%D8%A7%D9%84%D9%85%D8%B3%D9%84%D9%85-%D8%A2%D8%AF%D9%85-%D8%AD%D9%85%D9%88%D9%8A-%D9%81%D9%8A-%D8%A7%D9%86%D8%AA%D8%AE%D8%A7%D8%A8%D8%A7%D8%AA-%D8%A7%D9%84%D9%83%D9%88%D9%86%D8%AC%D8%B1%D8%B3",
            "image": "https://media.gemini.media/img/large/2026/11/4/2026_11_4_4_18_19_264.webp",
            "publishedAt": "2026-11-04T02:19:32Z",
            "lang": "ar",
            "source": {
                "id": "6134f72fd899ce5849d630fdbfe8f93f",
                "name": "Masrawy",
                "url": "https://www.masrawy.com"
            }
        },
        {
            "id": "538344548102a31a0406962e7bc899b6",
            "title": "المستشارة القضائية الإسرائيلية تعرقل تحقيق الشاباك مع 3 سياسيين عرب بشأن الانتخابات",
            "description": "اعتبرت المستشارة القضائية الإسرائيلية طلب الشاباك التحقيق مع 3 سياسيين عرب بشبهة التدخل الأجنبي والتلاعب بالانتخابات غير مستند إلى أدلة قانونية.",
            "content": "رفضت المستشارة القضائية للحكومة الإسرائيلية غالي بهاراف ميارا طلب جهاز الأمن العام (الشاباك) إجراء تحقيقات مع 3 سياسيين عرب بشأن شبهات التدخل الأجنبي والتزوير في انتخابات الكنيست، مؤكدة غياب الأدلة التي تبرر اتخاذ هذا الإجراء.\nوأكدت بهاراف ميارا في ب... [2248 chars]",
            "url": "https://www.aljazeera.net/news/2026/11/4/%D8%A7%D9%84%D9%85%D8%B3%D8%AA%D8%B4%D8%A7%D8%B1%D8%A9-%D8%A7%D9%84%D9%82%D8%B6%D8%A7%D8%A6%D9%8A%D8%A9-%D8%A7%D9%84%D8%A5%D8%B3%D8%B1%D8%A7%D8%A6%D9%8A%D9%84%D9%8A%D8%A9-2",
            "image": "https://www.aljazeera.net/wp-content/uploads/2025/12/ap_693eb86f6228a-1765718127.jpg?resize=1200%2C675",
            "publishedAt": "2026-11-04T01:01:10Z",
            "lang": "ar",
            "source": {
                "id": "3f5254cbfa6e223f22fc9069bd51b666",
                "name": "الجزيرة نت",
                "url": "https://www.aljazeera.net"
            }
        },
        {
            "id": "6cf2aa0442cecc41a28ffbbaa6f8c89a",
            "title": "\"الاستبدال العظيم\".. حملة تضليل إسرائيلية تستهدف المسلمين في 30 دولة",
            "description": "كشف تحقيق بحثي عن حملة تضليل إعلامي واسعة استهدفت 30 دولة، بإنفاق تجاوز 8.2 ملايين دولار، وروّجت لخطابات معادية للمسلمين والمهاجرين.",
            "content": "كشف تقرير بحثي أعده الباحثان مارك أوين جونز وسوهان ديسوزا عن حملة تضليل إعلامي استهدفت 30 دولة بإنفاق بلغ 6.12 ملايين جنيه إسترليني (8.2 ملايين دولار).\nوأفاد التقرير المعنون بـ\"صناعة الاستبدال العظيم\" بأن الحملة امتدت من أكتوبر/تشرين الأول 2023 إلى أ... [2790 chars]",
            "url": "https://www.aljazeera.net/news/2026/11/4/%D8%A7%D9%84%D8%A7%D8%B3%D8%AA%D8%A8%D8%AF%D8%A7%D9%84-%D8%A7%D9%84%D8%B9%D8%B8%D9%8A%D9%85-%D8%AD%D9%85%D9%84%D8%A9-%D8%AA%D8%B6%D9%84%D9%8A%D9%84",
            "image": "https://www.aljazeera.net/wp-content/uploads/2018/03/cd541c00-96a2-449d-bef5-b8f276a74d73.jpeg?resize=1200%2C630",
            "publishedAt": "2026-11-03T23:23:28Z",
            "lang": "ar",
            "source": {
                "id": "3f5254cbfa6e223f22fc9069bd51b666",
                "name": "الجزيرة نت",
                "url": "https://www.aljazeera.net"
            }
        }
    ]
}

Missing a source from Saudi Arabia? Suggest a source.

Saudi Arabia World News API

Categories

Request and live response