Peru World News API

Get the live top world 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 world 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=world&country=pe&apikey=YOUR_API_KEY

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=world" \
  --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": "world", "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: "world",
    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" => "world",
    "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=world&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": 65086,
    "articles": [
        {
            "id": "8ed6be06bfdeeb514ad0e41e126e0362",
            "title": "A sus casi 80 años, un hombre temía no terminar de restaurar su cabaña en las montañas: hoy vive a 1.800 metros en los Alpes para preservar una propiedad heredada de su tatarabuelo",
            "description": "La restauración de su propiedad ancestral, adquirida por su tatarabuelo, buscó reconectar con sus raíces. Utilizó materiales locales para mantener la arquitectura tradicional del lugar.",
            "content": "Franco, un hombre de 77 años, resguarda su legado familiar en una cabaña a 1.800 metros de altitud en los Alpes italianos, dentro del valle Maira del Piamonte, cerca de Elva. La restauración de esta antigua propiedad implicó un reto abrumador que el ... [4190 chars]",
            "url": "https://larepublica.pe/mundo/2026/10/30/a-los-77-anos-temia-no-terminar-de-restaurar-su-cabana-hoy-vive-a-1800-metros-en-los-alpes-para-preservar-su-legado-familiar-1143930",
            "image": "https://imgmedia.larepublica.pe/1200x735/larepublica/original/2026/11/03/6ae4c9692ddd4daada088c2d.jpg",
            "publishedAt": "2026-11-03T16:14:29Z",
            "lang": "es",
            "source": {
                "id": "d86026b37097a601667503d18e841b78",
                "name": "La República",
                "url": "https://larepublica.pe"
            }
        },
        {
            "id": "47c2a856481481c0f91d65608229f1a7",
            "title": "Una pareja construyó un refugio con troncos caídos junto a un río de la Amazonía: Wekain Lodge funciona con energía solar y buscan recuperar el bosque en la selva de América Latina",
            "description": "Los impulsores buscan restaurar la flora ribereña y preservar la biodiversidad local. Con un enfoque en la armonía con la naturaleza, ofrecen una experiencia única para desconectarse del bullicio urbano y disfrutar de la selva.",
            "content": "María José y John erigieron Wekain Lodge junto a un río de la Amazonía ecuatoriana utilizando madera de árboles caídos y paneles solares para su iluminación. Este refugio turístico en Sinaí, a 40 minutos de Macas en Morona Santiago, combina el hosped... [3115 chars]",
            "url": "https://larepublica.pe/mundo/2026/11/02/una-pareja-construyo-un-refugio-con-troncos-caidos-junto-a-un-rio-de-la-amazonia-funciona-con-energia-solar-y-buscan-recuperar-el-bosque-161848",
            "image": "https://imgmedia.larepublica.pe/1200x735/larepublica/original/2026/11/03/6ae8d140db77feb3b101d5e5.jpg",
            "publishedAt": "2026-11-03T16:06:43Z",
            "lang": "es",
            "source": {
                "id": "d86026b37097a601667503d18e841b78",
                "name": "La República",
                "url": "https://larepublica.pe"
            }
        },
        {
            "id": "bb3848047c7d02c2929638646af9accf",
            "title": "Seis vuelos reciben amenazas en Europa y obligan a activar dispositivos de seguridad",
            "description": "Las amenazas generaron un despliegue importante de efectivos tras la activación de protocolos de seguridad.",
            "content": "Cuatro vuelos europeos, dos con dirección a Varsovia (Polonia) procedentes de Londres y Copenhague, otro que cubría la ruta Mánchester (Reino Unido)-Murcia (España) y otro proveniente de Israel que aterrizó en Sofía han registrado amenazas que han ob... [4499 chars]",
            "url": "https://rpp.pe/mundo/europa/cuatro-vuelos-reciben-amenazas-en-europa-y-obligan-a-activar-dispositivos-de-seguridad-noticia-1715708",
            "image": "https://f.rpp-noticias.io/2026/11/03/345834_1925226.jpg?width=1200&quality=85",
            "publishedAt": "2026-11-03T15:53:02Z",
            "lang": "es",
            "source": {
                "id": "59a2127543ab7a2d3faa202b82a227e5",
                "name": "RPP Noticias",
                "url": "https://rpp.pe"
            }
        }
    ]
}

Missing a source from Peru? Suggest a source.

Peru World News API

Categories

Request and live response