France News API

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

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=general" \
  --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": "general", "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: "general",
    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" => "general",
    "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=general&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": 589358,
    "articles": [
        {
            "id": "e6294a9cfc148683ee3125db445b3352",
            "title": "Humilié par Côme, le RC Lens encaisse la plus large défaite d'un club français en Ligue des champions",
            "description": "Les Lensois ont concédé leur troisième revers de rang en Ligue des champions, mercredi, face à Côme.",
            "content": "Un naufrage historique. Après deux défaites de rang en Ligue des champions, le RC Lens voulait redresser le cap à l'occasion de la réception de Côme, mercredi 4 novembre, au stade Félix Bollaert-Delelis. Mais les Artésiens ont sombré sur leur pelouse... [3600 chars]",
            "url": "https://www.franceinfo.fr/sports/foot/ligue-des-champions/humilie-par-come-le-rc-lens-encaisse-la-plus-large-defaite-d-un-club-francais-en-ligue-des-champions_8268452.html",
            "image": "https://www.franceinfo.fr/pictures/nl5R32zfNsYSLEArnt-gZ6gkuLw/0x311:5298x3291/1500x843/2026/11/04/6aebad4725a0f116452608.jpg",
            "publishedAt": "2026-11-04T21:56:47Z",
            "lang": "fr",
            "source": {
                "id": "091056d666beb02c3011a24a96e70859",
                "name": "franceinfo",
                "url": "https://www.franceinfo.fr"
            }
        },
        {
            "id": "c2e1bc4a615a065fb0b2d112315d70ee",
            "title": "Les Bourses mondiales en hausse après la victoire démocrate aux \"midterms\", le pétrole plonge",
            "description": "Les marchés mondiaux ont salué mercredi la victoire sans appel des démocrates aux élections américaines de mi-mandat, pariant notamment sur moins de dépenses publiques aux États-Unis et l'espoir d'une désescalade au Moyen-Orient.",
            "content": "Les marchés mondiaux ont salué mercredi la victoire sans appel des démocrates aux élections américaines de mi-mandat, pariant notamment sur moins de dépenses publiques aux États-Unis et l'espoir d'une désescalade au Moyen-Orient.\n\"La victoire des dém... [3883 chars]",
            "url": "https://actu.orange.fr/economie/les-bourses-mondiales-en-hausse-apres-la-victoire-democrate-aux-quot-midterms-quot-le-petrole-plonge-CNT000002txUvF.html",
            "image": "https://proxymedia.woopic.com/api/v1/images/2275%2Factu%2Fafp-news%2Fd6de3316-19e7-4487-9b0c-25da738be984.jpg?format=1200x630&facedetect=1&quality=85",
            "publishedAt": "2026-11-04T21:46:00Z",
            "lang": "fr",
            "source": {
                "id": "a844c57a6c625180fcdc838e834677d1",
                "name": "Orange Actualités",
                "url": "https://actu.orange.fr"
            }
        },
        {
            "id": "cae0476744db5ead0f1abc3da3f1c6dc",
            "title": "Le RN refoule \" Mediapart \" et \" StreetPress \" à la soirée de lancement du livre de Jordan Bardella, les autres journalistes quittent les lieux",
            "description": "La quasi-totalité des journalistes présents au Pavillon Wagram a quitté l’événement en signe de protestation.",
            "content": "KENZO TRIBOUILLARD / AFP\nLa soirée devait célébrer la sortie du nouveau livre de Jordan Bardella. Elle s’est transformée en incident avec la presse. Mercredi 4 novembre, à Paris, la quasi-totalité des journalistes invités au Pavillon Wagram ont quitt... [1893 chars]",
            "url": "https://www.huffingtonpost.fr/politique/article/le-rn-refoule-mediapart-et-streetpress-a-la-soiree-de-lancement-du-livre-de-jordan-bardella-les-autres-journalistes-quittent-les-lieux_352211.html",
            "image": "https://focus.huffingtonpost.fr/2026/10/04/596/0/6958/3913/1820/1023/75/0/49c32a3_upload-1-q2qrgut3efmv-afp-20260918-c8p62ck-v1-highres-francepoliticsdiplomacywarparties.jpg",
            "publishedAt": "2026-11-04T21:41:14Z",
            "lang": "fr",
            "source": {
                "id": "9580cb93e29cb50362bf7cb344f7c161",
                "name": "Le HuffPost",
                "url": "https://www.huffingtonpost.fr"
            }
        }
    ]
}

Missing a source from France? Suggest a source.

France News API

Categories

Request and live response