France News API

Get the live top headlines from France with our JSON 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": 7277148,
    "articles": [
        {
            "title": "Real Madrid : le ciseau dingue de Kylian Mbappé face à Dortmund",
            "description": "Ce samedi soir, le Real Madrid a validé son billet pour les demi-finales de la Coupe du Monde des Clubs en s’imposant face à Dortmind (3-2). Dans (...) - Footmercato",
            "content": "Ce samedi soir, le Real Madrid a validé son billet pour les demi-finales de la Coupe du Monde des Clubs en s’imposant face à Dortmind (3-2). Dans un match maitrîsé, les Madrilènes ont offert une fin de match folle qui a notamment permis à Kylian Mbap... [665 chars]",
            "url": "https://www.footmercato.net/a2462944651686152954-real-madrid-le-ciseau-dingue-de-kylian-mbappe-face-a-dortmund",
            "image": "https://assets-fr.imgfoot.com/media/cache/1200x675/design-sans-titre-2025-07-06t001040-028.jpg",
            "publishedAt": "2025-07-05T22:11:27Z",
            "source": {
                "name": "Foot Mercato",
                "url": "https://www.footmercato.net"
            }
        },
        {
            "title": "Au terme d'une fin de match folle, le Real Madrid bat Dortmund et affrontera le PSG en demi-finales de la Coupe du monde des clubs",
            "description": "Le Real Madrid s'est imposé face au Borussia Dortmund au terme d'un match qui s'est emballé sur la fin, où Kylian Mbappé a notamment marqué un magnifique ciseau (3-2). Qualifiée pour le dernier carré, l'équipe espagnole jouera le PSG le mercredi 9 juillet (21h).",
            "content": "Avec Kylian Mbappé sur le banc mais Aurélien Tchouaméni titulaire au milieu de terrain, le Real a rapidement pris les devants, profitant de l'attentisme d'Allemands trop souvent regroupés devant leur but. Et c'est sur une action de ce type que le Rea... [528 chars]",
            "url": "https://www.lequipe.fr/Football/Actualites/Au-terme-d-une-fin-de-match-folle-le-real-madrid-bat-dortmund-et-affrontera-le-psg-en-demi-finales-de-la-coupe-du-monde-des-clubs/1575784",
            "image": "https://medias.lequipe.fr/img-photo-jpg/kylian-mbappe-a-marque-le-troisieme-but-du-real-hannah-mckay-reuters/1500000002232411/0:0,1792:1195-1200-800-75/2c1f8.jpg",
            "publishedAt": "2025-07-05T22:07:50Z",
            "source": {
                "name": "L'Équipe",
                "url": "https://www.lequipe.fr"
            }
        },
        {
            "title": "Ousmane Dembélé rend hommage à Diogo Jota en reprenant sa célébration",
            "description": "L’amour du beau geste. Entré en jeu à 20 minutes du terme face au Bayern Munich, Ousmane…",
            "content": "le Samedi 05 Juillet à 23:30\nL’amour du beau geste.\nEntré en jeu à 20 minutes du terme face au Bayern Munich, Ousmane Dembélé s’est transformé en héros pour le club de la capitale en pliant l’affaire au bout du temps additionnel. Un but qu’il a fêté ... [691 chars]",
            "url": "https://www.sofoot.com/breves/psg-bayern-ousmane-dembele-rend-hommage-a-diogo-jota-en-reprenant-sa-celebration",
            "image": "https://sofoot.s3.eu-central-1.amazonaws.com/wp-content/uploads/2025/07/05231257/ICONSPORT_263636_0201-1400x934.jpg",
            "publishedAt": "2025-07-05T21:30:12Z",
            "source": {
                "name": "SO FOOT.com",
                "url": "https://www.sofoot.com"
            }
        }
    ]
}
France News API

API Demonstration

Categories
