France World News API

Get the live top world 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 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);
}

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"  => "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=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": 342348,
    "articles": [
        {
            "id": "8e69aef3f08355c923ddfa6dd542821f",
            "title": "EN DIRECT, guerre en Ukraine : au moins 33 morts au lendemain d’une attaque russe contre un centre de distribution d’aide humanitaire dans la région de Zaporijia",
            "description": "Le président ukrainien, Volodymyr Zelensky, a estimé que plus de 50 personnes pourraient encore se trouver sous les décombres. La mission d’observation des droits humains de l’ONU en Ukraine a estimé que cette attaque « semblait avoir violé les principes les plus fondamentaux du droit international humanitaire ».",
            "content": "Le premier ministre canadien refuse la sélection russe pour le Mondial juniors de hockey\nLe premier ministre canadien, Mark Carney, a assuré qu’il ne permettrait pas à la Russie de participer au Mondial juniors de hockey sur glace qui débutera au Can... [15202 chars]",
            "url": "https://www.lemonde.fr/international/live/2026/11/03/en-direct-guerre-en-ukraine-au-moins-33-morts-au-lendemain-d-une-attaque-russe-contre-un-centre-de-distribution-d-aide-humanitaire-dans-la-region-de-zaporijia_6803934_3210.html",
            "image": "https://img.lemde.fr/2026/11/03/0/0/5808/2904/1440/720/60/0/ae45251_ftp-1-4niwhdn14zid-c46e4adee61e4f3f9efabb0aa1728079-1-147cc7eb9ada47fea80579dbecd04e1e.jpg",
            "publishedAt": "2026-11-04T00:40:55Z",
            "lang": "fr",
            "source": {
                "id": "f8bceab28da05bf9ed8678be4690bf64",
                "name": "Le Monde.fr",
                "url": "https://www.lemonde.fr"
            }
        },
        {
            "id": "4cbcd7e437ed5a279d243d363b8557df",
            "title": "EN DIRECT, midterms 2026 : de la Floride à la Californie, suivez les résultats des élections de mi-mandat en direct",
            "description": "Les bureaux de vote ferment aux Etats-Unis, et les résultats commencent à tomber. Plus de 58 millions d’Américains ont déjà voté par anticipation – un record pour des élections de mi-mandat, qui pourraient cette fois-ci voir les démocrates prendre le contrôle de la Chambre des représentants, voire du Sénat, et compromettre la fin du mandat de Donald Trump.",
            "content": "Ce live a également été animé par Pierre Bouvier, Grégor Brandy et Luc Vinogradoff ainsi que par et Ramzy Bensaadi et Emile Drousie (service Photo).\nLe Monde tient un direct consacré aux midterms, les élections de mi-mandat aux Etats-Unis, alors que ... [931 chars]",
            "url": "https://www.lemonde.fr/international/live/2026/11/04/en-direct-midterms-2026-de-la-floride-a-la-californie-suivez-les-resultats-des-elections-de-mi-mandat-en-direct_6805528_3210.html",
            "image": "https://img.lemde.fr/2026/11/03/416/0/4995/2497/1440/720/60/0/2ca41c4_ftp-1-7c3akull4jer-2303393421.jpg",
            "publishedAt": "2026-11-04T00:38:05Z",
            "lang": "fr",
            "source": {
                "id": "f8bceab28da05bf9ed8678be4690bf64",
                "name": "Le Monde.fr",
                "url": "https://www.lemonde.fr"
            }
        },
        {
            "id": "e6beadad1cd70f597cbee05c75aff8f3",
            "title": "Arrêté avec 14 000 £ de drogue, il roulait avec Pablo, un agneau qui grignotait des frites",
            "description": "Arrêté avec 14 000 £ de drogue, il voyageait avec Pablo, un agneau qui mangeait des frites sur la banquette. Il échappe à la prison. Récit d'un contrô...",
            "content": "TDN >\nFaits divers\nArrêté avec 14 000 £ de drogue, il roulait avec Pablo, un agneau qui grignotait des frites\nImaginez la scène. Un contrôle de police, de nuit, sur une route britannique. Les agents s’approchent de la voiture, et là, surprise : un ag... [3865 chars]",
            "url": "https://www.letribunaldunet.fr/faits-divers/agneau-pablo-frites-drogue-echappe-prison.html",
            "image": "https://www.letribunaldunet.fr/wp-content/uploads/2026/11/arrete-avec-14-000-de-drogue-il-roulait-avec-pablo-un-ag-1.jpg",
            "publishedAt": "2026-11-03T23:17:00Z",
            "lang": "fr",
            "source": {
                "id": "a6668d249ae8f6568db83fac04955043",
                "name": "Le Tribunal du Net",
                "url": "https://www.letribunaldunet.fr"
            }
        }
    ]
}

Missing a source from France? Suggest a source.

France World News API

Categories

Request and live response