France World News API

Get the live top world headlines from France with one request to the Top Headlines endpoint of GNews API. Stories are selected by Google News rankings and returned as clean JSON.

Get your free API key

Request and live response

This request returns the current top world 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=world&country=fr&apikey=YOUR_API_KEY

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=world" \
  --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": "world", "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: "world",
    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);
}

<?php

$apiKey = "YOUR_API_KEY";

$query = http_build_query([
    "category" => "world",
    "country"  => "fr",
    "apikey"   => $apiKey,
]);

$response = file_get_contents("https://gnews.io/api/v4/top-headlines?" . $query);
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=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": 347068,
    "articles": [
        {
            "id": "e1590499dc1c015e822e566f0d8851f9",
            "title": "EN DIRECT, guerre en Ukraine : des frappes russes font trois morts dans l’oblast de Kirovohrad, selon l’administration militaire régionale",
            "description": "L’offensive, survenue dans cette région centrale du pays, a également fait six blessés, a annoncé dans la nuit de mercredi à jeudi Andriy Raikovych, le chef de l’administration militaire de l’oblast.",
            "content": "Sergueï Lavrov et Wang Yi ont discuté de coopération, de l’Ukraine et de l’Iran\nLes chefs ‌de la diplomatie russe et chinois ont discuté de l’état de la coopération bilatérale entre Moscou et Pékin, ‌ainsi que des crises en Ukraine et en Iran, a fai... [20376 chars]",
            "url": "https://www.lemonde.fr/international/live/2026/10/15/en-direct-guerre-en-ukraine-des-frappes-russes-font-trois-morts-dans-l-oblast-de-kirovohrad-selon-l-administration-militaire-regionale_6791198_3210.html",
            "image": "https://img.lemde.fr/2026/10/14/501/0/4000/2000/1440/720/60/0/829a89e_upload-1-e03wel0jfy5t-raf-ukr-kyivstrike-013.JPG",
            "publishedAt": "2026-10-14T23:07:23Z",
            "lang": "fr",
            "source": {
                "id": "f8bceab28da05bf9ed8678be4690bf64",
                "name": "Le Monde.fr",
                "url": "https://www.lemonde.fr"
            }
        },
        {
            "id": "184898bbb6133dcbf4c71f02b8979b45",
            "title": "Guerre en Ukraine : Elon Musk suggère que les États-Unis sont responsables du ralentissement du réseau Starshield",
            "description": "Elon Musk a remis, mercredi 14 octobre, la responsabilité du ralentissement du réseau militaire Starshield en Ukraine sur le gouvernement américain. Volodymyr Zelenksy l’avait appelé à restaurer le réseau, utilisé par l’armée ukrainienne pour faire face aux frappes russes.",
            "content": "Elon Musk a déclaré, ce mercredi 14 octobre 2026, que tout ralentissement du réseau militaire Starshield en Ukraine est dû au gouvernement américain, et non à son entreprise SpaceX.\n« Les systèmes Starshield sont détenus et contrôlés par le gouvernem... [1733 chars]",
            "url": "https://www.ouest-france.fr/europe/ukraine/guerre-en-ukraine-elon-musk-suggere-que-les-etats-unis-sont-responsables-du-ralentissement-du-reseau-starshield-868a2c12-c809-11f1-b3f5-183597cb1094",
            "image": "https://media.ouest-france.fr/v1/pictures/MjAyNjEwZTFlNGMyOTkzZTNjNzY2MTY0YjgyMjZhZGQxNTg0ZjA?width=1260&height=708&focuspoint=50%2C25&cropresize=1&client_id=bpeditorial&sign=e12c8b6a9fbb9583706c12f46cc9bc16be2c706f265f6245c3d1f1897a4e48d8",
            "publishedAt": "2026-10-14T20:13:55Z",
            "lang": "fr",
            "source": {
                "id": "bfa6f9ca5ba536983551f9087fc2ffd9",
                "name": "Ouest-France",
                "url": "https://www.ouest-france.fr"
            }
        },
        {
            "id": "28588aed6f85e4fb32dcdc3557b0ffd8",
            "title": "Une surprise démocrate dans le Kansas? A trois semaines des \"midterms\", des Etats conservateurs de plus en plus susceptibles de basculer",
            "description": "Plombé par le bilan de Donald Trump, le sénateur républicain qui se bat pour conserver son siège dans le Kansas est mis en difficulté par son adversaire démocrate. Un glissement inattendu dans cet Etat du Midwest qui n’a pas élu de démocrate à ce poste depuis 1932",
            "content": "Même pour certains vétérans de la politique américaine, c’est une surprise. «Il y a actuellement des Etats en jeu que je n’aurais jamais imaginé», a ainsi déclaré l’ancien président Barack Obama, cité par le Washington Post, lors d’un événement mercr... [1225 chars]",
            "url": "https://www.letemps.ch/monde/ameriques/une-surprise-democrate-dans-le-kansas-a-trois-semaines-des-midterms-des-etats-conservateurs-de-plus-en-plus-susceptibles-de-basculer",
            "image": "https://letemps-17455.kxcdn.com/photos/43184ba0-82d5-463b-83e7-914977cc3a72/medium",
            "publishedAt": "2026-10-14T19:03:34Z",
            "lang": "fr",
            "source": {
                "id": "683bdbce3b69fc036fcfebc15b34c439",
                "name": "Le Temps",
                "url": "https://www.letemps.ch"
            }
        }
    ]
}

Missing a publisher from France? Suggest a source.

France World News API

Categories

Request and live response