France Nation News API

Get the live top nation headlines from France 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 nation headlines from France. 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=nation&country=fr&apikey=YOUR_API_KEY

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=nation" \
  --data-urlencode "country=fr" \
  --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": "nation", "country": "fr", "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: "nation",
    country: "fr",
    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" => "nation",
    "country"  => "fr",
    "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=nation&country=fr&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": 476984,
    "articles": [
        {
            "id": "ef314ada716ce0911fb936635314897b",
            "title": "Entre blocages et manifestations, des étudiants affichent leur détermination à \" ne pas abandonner \"",
            "description": "Entre un tiers et la moitié des établissements de l’enseignement supérieur ont été perturbés mardi. Les étudiants mobilisés veulent maintenir la pression, notamment en défilant dans les centres-villes. Une inconnue demeure sur la validation de leur premier semestre d’études.",
            "content": "Six poubelles empilées entravent l’ouverture des deux immenses portes en fonte des facultés des sciences et des humanités de l’université Paris Cité, au petit matin du mardi 3 novembre. Parmi la quinzaine de bloqueurs, Charlotte et Mona (elles n’ont ... [937 chars]",
            "url": "https://www.lemonde.fr/societe/article/2026/11/03/entre-blocages-et-manifestations-des-etudiants-affichent-leur-determination-a-ne-pas-abandonner_6805658_3224.html",
            "image": "https://img.lemde.fr/2026/11/03/0/0/5753/3835/1440/960/60/0/e499d31_ftp-1-2s0x8ke1hujo-afp-d6at4c9.jpg",
            "publishedAt": "2026-11-03T22:38:48Z",
            "lang": "fr",
            "source": {
                "id": "f8bceab28da05bf9ed8678be4690bf64",
                "name": "Le Monde.fr",
                "url": "https://www.lemonde.fr"
            }
        },
        {
            "id": "a564f40a4e63b8f5c2d8cd72b30891a3",
            "title": "Des syndicats et associations de sept pays européens appellent à manifester contre la vie chère fin novembre",
            "description": "Les représentants des organisations françaises, espagnoles, italiennes, britanniques, portugaises, grecques et belges espèrent rassembler « des millions » de personnes dans les rues les 20, 21 et 22 novembre.",
            "content": "Des syndicats et associations de défense du droit au logement de sept pays européens, réunis à Paris, ont appelé mardi 3 novembre à des « manifestations coordonnées » contre la vie chère les 20, 21 et 22 novembre. Les représentants des organisations ... [3453 chars]",
            "url": "https://www.lemonde.fr/international/article/2026/11/03/des-syndicats-et-associations-de-sept-pays-europeens-appellent-a-manifester-contre-la-vie-chere-fin-novembre_6805665_3210.html",
            "image": "https://img.lemde.fr/2026/10/30/0/0/8256/5504/1440/960/60/0/da61012_ftp-1-tii7u4yu6ot1-afp-d4xa43p.jpg",
            "publishedAt": "2026-11-03T20:48:27Z",
            "lang": "fr",
            "source": {
                "id": "f8bceab28da05bf9ed8678be4690bf64",
                "name": "Le Monde.fr",
                "url": "https://www.lemonde.fr"
            }
        },
        {
            "id": "df872cd982832181d011a87ef664c5eb",
            "title": "INFO BFMTV. Attentat raciste de Trappes: le suspect, Kévin Tessier, a fait une tentative de suicide en détention",
            "description": "Le suspect de l'attentat raciste commis dans les Yvelines a tenté de se suicider en détention. Ses jours ne sont pas en danger après une brève hospitalisation.",
            "content": "Le suspect de l'attentat raciste commis dans les Yvelines a tenté de se suicider en détention. Ses jours ne sont pas en danger après une brève hospitalisation.\nKévin Tessier, le suspect de l'attentat raciste de Trappes et La Verrière, dans les Yvelin... [830 chars]",
            "url": "https://www.bfmtv.com/police-justice/info-bfmtv-attentat-raciste-de-trappes-le-suspect-kevin-tessier-a-fait-une-tentative-de-suicide-en-detention_AN-202611030920.html",
            "image": "https://io-fsly-bfmtv.cdn.nextradiotv.com/9XlVBqxyUSdZV2eKZNRakNIXaMk=/0x0:1920x1080/1920x0/images/Des-policiers-procedent-a-des-actes-d-investigation-dans-une-station-service-apres-l-attentat-raciste-a-Trappes-qui-fait-un-mort-et-plusieurs-blesses-le-23-octobre-2372228.jpg",
            "publishedAt": "2026-11-03T20:33:48Z",
            "lang": "fr",
            "source": {
                "id": "a9a14c2a6effa584c49d0d1fb84b0db0",
                "name": "BFM",
                "url": "https://www.bfmtv.com"
            }
        }
    ]
}

Missing a source from France? Suggest a source.

France Nation News API

Categories

Request and live response