Peru News API

Get the live top headlines from Peru 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 Peru. 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=pe&apikey=YOUR_API_KEY

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=general" \
  --data-urlencode "country=pe" \
  --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": "pe", "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: "pe",
    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"  => "pe",
    "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=pe&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": 331460,
    "articles": [
        {
            "id": "b9f842ed887f25eb5212793d80767db1",
            "title": "Google bloqueará el acceso a su buscador a estudiantes que desactiven sus herramientas de IA",
            "description": "Por BARBARA ORTUTAY Los estudiantes que utilicen el software de Google en el aula no podrán acceder al motor de búsqueda de la empresa a menos que su sistema escolar también opte por las herramientas de inteligencia artificial, indicó el gigante tecnológico el martes. La empresa, con sede en Mountain View, California, ha enfrentado resistencia […]",
            "content": "Por BARBARA ORTUTAY\nLos estudiantes que utilicen el software de Google en el aula no podrán acceder al motor de búsqueda de la empresa a menos que su sistema escolar también opte por las herramientas de inteligencia artificial, indicó el gigante tecn... [4059 chars]",
            "url": "https://www.mcall.com/2026/11/03/google-bloquear-el-acceso-a-su-buscador-a-estudiantes-que-desactiven-sus-herramientas-de-ia/",
            "image": "https://www.mcall.com/wp-content/uploads/2026/11/GOOGLE-ESCUELAS-IA_48894.jpg?w=2393&h=1521",
            "publishedAt": "2026-11-04T04:59:13Z",
            "lang": "es",
            "source": {
                "id": "03a12b16a876dfb0cfd34726589c4024",
                "name": "The Morning Call",
                "url": "https://www.mcall.com"
            }
        },
        {
            "id": "4c0d3e5de4966c8a62d32833bfcbc9a9",
            "title": "Demócratas arrebatan a los republicanos la Cámara de Representantes, según proyecciones",
            "description": "La victoria demócrata abre el camino para que el líder del partido en ese hemiciclo, Hakeem Jeffries, se convierta en el primer presidente afroamericano de la Cámara de Representantes.",
            "content": "La oposición demócrata arrebató a los republicanos el control de la Cámara de Representantes, según las proyecciones de las cadenas CNN y NBC News, lo que le permitirá ejercer de contrapeso a la agenda del presidente de Estados Unidos, Donald Trump.\n... [1071 chars]",
            "url": "https://rpp.pe/mundo/estados-unidos/elecciones-en-ee-uu-democratas-arrebatan-a-los-republicanos-la-camara-de-representantes-segun-proyecciones-noticia-1715829",
            "image": "https://f.rpp-noticias.io/2026/11/03/533853_1925511.jpg?width=1200&quality=85",
            "publishedAt": "2026-11-04T03:57:20Z",
            "lang": "es",
            "source": {
                "id": "59a2127543ab7a2d3faa202b82a227e5",
                "name": "RPP Noticias",
                "url": "https://rpp.pe"
            }
        },
        {
            "id": "bdfbc134c6814f6c9061f26b7e879237",
            "title": "Alianza Lima venció 1-0 a Cienciano y sigue en la pelea por el Torneo Clausura",
            "description": "Alianza Lima derrotó por la mínima diferencia a Cienciano y sigue en la lucha por el Torneo Clausura de Liga 1",
            "content": "Alianza Lima sufrió más de la cuenta, pero venció 1-0 a Cienciano este martes 3 de noviembre, en el Estadio Alejandro Villanueva de La Victoria, por la jornada 15 del Torneo Clausura de la Liga 1.\nLos blanquiazules buscaron el tanto durante varios pa... [446 chars]",
            "url": "https://www.americatv.com.pe/deportes/futbol-peruano/alianza-lima-vencio-1-0-cienciano-y-sigue-pelea-torneo-clausura-liga-1-eryc-castillo-horacio-melgarejo-aguirre-n456968",
            "image": "https://e-ad.americatv.com.pe/futbol-peruano-alianza-lima-vencio-1-0-cienciano-y-sigue-pelea-torneo-clausura-liga-1-eryc-castillo-horacio-melgarejo-aguirre-n456968-1200x630-1041088.jpg",
            "publishedAt": "2026-11-04T03:08:08Z",
            "lang": "es",
            "source": {
                "id": "32968738d2843810a182f40635f590c4",
                "name": "América TV",
                "url": "https://www.americatv.com.pe"
            }
        }
    ]
}

Missing a source from Peru? Suggest a source.

Peru News API

Categories

Request and live response