France News API

Get the live top headlines from France with our JSON API.

Get API key for the France News API

API Demonstration

This example demonstrates the HTTP request to make and the JSON response you will receive when you use the news api to get the top headlines from France.

GET
https://gnews.io/api/v4/top-headlines?country=fr&category=general&apikey=API_KEY
{
    "totalArticles": 481056,
    "articles": [
        {
            "id": "bdaf84e301c175ef28f16369bc402604",
            "title": "Le PS se déchire encore une fois et coule la primaire",
            "description": "Le courant de Boris Vallaud a annoncé quitter la direction du Parti socialiste. Un coup dur pour le premier secrétaire Olivier Faure, qui perd la majorité, mais aussi pour la primaire de la gauche, q…",
            "content": "Les cookies et technologies similaires que nous utilisons sur Mediapart sont de différentes natures et nous permettent de poursuivre différentes finalités.\nCertains sont nécessaires au fonctionnement du site et de l’application mobile (vous ne pouvez... [447 chars]",
            "url": "https://www.mediapart.fr/journal/politique/080526/le-ps-se-dechire-encore-une-fois-et-coule-la-primaire",
            "image": "https://static.mediapart.fr/etmagine/og/journal/files/2026/05/08/260508-img-boris-vallaud-direction-ps.jpg",
            "publishedAt": "2026-05-09T08:48:28Z",
            "lang": "fr",
            "source": {
                "id": "787bdc484a6b8dc1c1340a05b6b0cafe",
                "name": "Mediapart",
                "url": "https://www.mediapart.fr"
            }
        },
        {
            "id": "894ecfb7e113995bb49d0d0f85d008ee",
            "title": "Les codes promo les plus utilisés de la semaine",
            "description": "Chaque samedi, retrouvez notre sélection des codes promo qui ont le plus séduit les lecteurs des Numériques, ainsi que les enseignes les plus populaires des 7 derniers jours. Une veille efficace pour ne rien rater des meilleures promotions en cours.",
            "content": "Les codes promo les plus populaires de la semaine\nQuelles offres ont fait craquer les internautes cette semaine ? Entre réductions immédiates, bons de réduction exclusifs et codes cumulables sur une large sélection de produits, certains coupons ont p... [3113 chars]",
            "url": "https://www.lesnumeriques.com/societe-numerique/les-codes-promo-les-plus-utilises-de-la-semaine-n255703.html",
            "image": "https://cdn.lesnumeriques.com/optim/news/12/123249/eb6d3e58-codes-promo__1200_678__3-4-659-348.jpg",
            "publishedAt": "2026-05-09T08:00:00Z",
            "lang": "fr",
            "source": {
                "id": "aa2fe5eaa5da248da7e27775cfa55b7d",
                "name": "Les Numériques",
                "url": "https://www.lesnumeriques.com"
            }
        },
        {
            "id": "7e8f4d9bda219642574514a60c48dbd8",
            "title": "EN DIRECT, guerre en Ukraine : Vladimir Poutine s’en prend à l’OTAN lors du défilé sur la place Rouge pour les commémorations de la fin de la seconde guerre mondiale ; plusieurs attaques ont eu lieu d",
            "description": "Donald Trump a annoncé vendredi un cessez-le-feu de trois jours à partir de samedi entre l’Ukraine et la Russie, alors que Moscou avait déjà décrété de son côté une trêve unilatérale avant les commémorations en Russie du 9-Mai. L’Ukraine s’est engagée à respecter cette pause dans les combats.",
            "content": "Vladimir Poutine a affirmé samedi que l’armée russe affrontait en Ukraine des forces « agressives » soutenues par l’OTAN, lors de son discours sur la place Rouge pour les commémorations de la victoire contre l’Allemagne nazie.\n« Le grand exploit de l... [9572 chars]",
            "url": "https://www.lemonde.fr/international/live/2026/05/09/en-direct-guerre-en-ukraine-vladimir-poutine-s-en-prend-a-l-otan-lors-du-defile-sur-la-place-rouge-pour-les-commemorations-de-la-fin-de-la-seconde-guerre-mondiale-plusieurs-attaques-ont-eu-lieu-dans-la-nuit-en-ukraine_6684995_3210.html",
            "image": "https://img.lemde.fr/2026/05/09/52/0/2560/1280/1440/720/60/0/77595c7_ftp-1-cqxrb82cykqy-2026-05-09t072633z-1278418579-rc2j5la5tbhu-rtrmadp-3-ww2-anniversary-russia-parade.JPG",
            "publishedAt": "2026-05-09T07:52:41Z",
            "lang": "fr",
            "source": {
                "id": "f8bceab28da05bf9ed8678be4690bf64",
                "name": "Le Monde.fr",
                "url": "https://www.lemonde.fr"
            }
        }
    ]
}

Categories