France News API

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

<?php

$apiKey = "YOUR_API_KEY";

$query = http_build_query([
    "category" => "general",
    "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=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": 590522,
    "articles": [
        {
            "id": "1da087edb26b873467b59457678c2a61",
            "title": "L'adolescent de 14 ans qui a blessé par balles un principal et une enseignante à Aubagne mis en examen et placé en détention provisoire",
            "description": "Plus tôt dans la journée, le collégien a admis \"avoir été influencé\" par une mouvance fascinée par les tueries de masse, a assuré le parquet national antiterroriste (Pnat)",
            "content": "Le collégien de 14 ans qui a blessé par balles un principal et une enseignante à Aubagne (Bouches-du-Rhône) a été placé en détention provisoire, mercredi 14 octobre, à l'issue de sa mise en examen, conformément aux réquisitions du parquet. Il est acc... [591 chars]",
            "url": "https://www.franceinfo.fr/societe/justice/l-adolescent-de-14-ans-qui-a-blesse-par-balles-un-principal-et-une-enseignante-a-aubagne-place-en-detention-provisoire_8237785.html",
            "image": "https://www.franceinfo.fr/pictures/XzIqaxqGMegZqN57pXiO2vxbkDM/0x8:1024x584/1500x843/2026/10/14/6acfe5118c63e569747435.jpg",
            "publishedAt": "2026-10-14T20:38:27Z",
            "lang": "fr",
            "source": {
                "id": "091056d666beb02c3011a24a96e70859",
                "name": "franceinfo",
                "url": "https://www.franceinfo.fr"
            }
        },
        {
            "id": "444e26ecc4b7fa070291c4ae2f96e693",
            "title": "Colère des lycéens : \" C’est nos mômes \"… L’acteur Omar Sy juge la réponse des autorités \" lamentable \"",
            "description": "Invité sur France Inter mercredi, l’acteur Omar Sy a dénoncé la gestion des manifestations lycéennes par les autorités et appelé à écouter les revendications des jeunes avant de les sanctionner",
            "content": "Alors que les lycéens manifestent depuis la mi-septembre pour réclamer davantage de moyens dans l’éducation, plusieurs personnalités françaises ont pris publiquement position en leur faveur. Mercredi, Omar Sy a vivement critiqué sur France Inter la g... [1313 chars]",
            "url": "https://www.20minutes.fr/societe/4254407-20261014-colere-lyceens-momes-acteur-omar-sy-juge-reponse-autorites-lamentable",
            "image": "https://img.20mn.fr/Vb-EXUVjRJyZjhXbkWDugCk/1444x920_credit-obligatoire-photo-de-john-angelillo-upi-shutterstock-15285381gg-omar-sy-arrive-sur-le-tapis-rouge-lors-du-gala-du-met-2025-celebrant-l-ouverture-de-superfine-tailoring-black-style-au-metropolitan-museum-of-art-le-lundi-5-mai-2025-a-new-york-gala-du-met-2025-new-york-etats-unis-05-mai-2025-shutterstock-editorial-2025-met-gala-new-york-united-15285381gg-2505060405",
            "publishedAt": "2026-10-14T20:18:00Z",
            "lang": "fr",
            "source": {
                "id": "92e7e89f421accb3d56cecfb428a7d20",
                "name": "20 Minutes",
                "url": "https://www.20minutes.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"
            }
        }
    ]
}

Missing a publisher from France? Suggest a source.

France News API

Categories

Request and live response