Portugal News API

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

Get API key for the Portugal 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 Portugal.

GET
https://gnews.io/api/v4/top-headlines?country=pt&category=general&apikey=API_KEY
{
    "totalArticles": 238478,
    "articles": [
        {
            "id": "7ac9414c6f302a45cd77eb72ee61cae0",
            "title": "Morreu Carlos Brito, histórico dirigente do PCP",
            "description": "Tinha 93 anos.",
            "content": "O Correio da Manhã incentiva todos os Leitores a interagirem através de comentários às notícias publicadas no seu site, de uma maneira respeitadora com o cumprimento dos princípios legais e constitucionais. Assim são totalmente ilegítimos comentários... [7369 chars]",
            "url": "https://www.cmjornal.pt/politica/detalhe/morreu-carlos-brito-historico-dirigente-do-pcp",
            "image": "https://cdn.cmjornal.pt/images/2026-05/img_1280x721uu2026-05-07-21-00-06-2283645.jpg",
            "publishedAt": "2026-05-07T23:25:29Z",
            "lang": "pt",
            "source": {
                "id": "2008508df4347bc5a804914c0f2c0bf9",
                "name": "cmjornal.pt",
                "url": "https://www.cmjornal.pt"
            }
        },
        {
            "id": "07c733a9b4596b6bb8125acea194f96c",
            "title": "Morreu Carlos Brito, histórico dirigente do PCP, aos 93 anos",
            "description": "Candidato apoiado pelo PCP às presidenciais de 1980 morreu esta quinta-feira em Alcoutim, concelho onde residia. Em 2002, foi suspenso do partido pela direção dos comunistas e fundou ala renovadora.",
            "content": "Carlos Brito, quadro histórico do PCP, morreu esta quinta-feira aos 93 anos, avançou o Público e confirmou o Observador. O candidato apoiado pelos comunistas às eleições presidenciais de 1980 morreu em casa, no concelho de Alcoutim, depois de ter est... [4991 chars]",
            "url": "https://observador.pt/2026/05/07/morreu-o-historico-dirigente-comunista-carlos-brito-aos-93-anos/",
            "image": "https://wm.observador.pt/wm/l/https%3A%2F%2Fbordalo.observador.pt%2Fv2%2Frs%3Afill%3A770%3A403%2Fc%3A2000%3A1124%3Anowe%3A0%3A14%2Fq%3A70%2Ff%3Awebp%2Fplain%2Fhttps%3A%2F%2Fs3.observador.pt%2Fwp-content%2Fuploads%2F2022%2F01%2F31200705%2F11102407-1.jpg?layer=obstop:T",
            "publishedAt": "2026-05-07T23:23:45Z",
            "lang": "pt",
            "source": {
                "id": "06c86b4317c4889570e5214b3ef4da53",
                "name": "Observador",
                "url": "https://observador.pt"
            }
        },
        {
            "id": "b69420b61e4ed8d00987f3794a8c618e",
            "title": "Gritos, lágrimas e acusações fortes a Afonso: Leomarte desiste do Desafio Final e o caos instala-se na casa",
            "description": "Leomarte decidiu abandonar a casa do Secret Story e deixou os colegas em lágrimas. Alguns deles bastante revoltados e a pôr as culpas em Afonso",
            "content": "O Especial do Secret Story - Desafio Final desta quinta-feira, 7 de maio, ficou marcado pela desistência inesperada de Leomarte. O concorrente decidiu abandonar a casa mais vigiada do País, depois de uma acesa discussão com Afonso.\nEm confessionário ... [996 chars]",
            "url": "https://tvi.iol.pt/secretstory/leomarte-freire/desistencia/gritos-lagrimas-e-acusacoes-fortes-a-afonso-leomarte-desiste-do-desafio-final-e-o-caos-instala-se-na-casa",
            "image": "https://img.iol.pt/preset/69fd0935d34e28842c83c7d4/og/tvi",
            "publishedAt": "2026-05-07T22:03:13Z",
            "lang": "pt",
            "source": {
                "id": "8c7889ce4e563c8661b53ee5fa7377b8",
                "name": "TVI",
                "url": "https://tvi.iol.pt"
            }
        }
    ]
}

Categories