Mexico World News API

Get the live top world headlines from Mexico 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 Mexico. 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=mx&apikey=YOUR_API_KEY

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=world" \
  --data-urlencode "country=mx" \
  --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": "mx", "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: "mx",
    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"  => "mx",
    "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=mx&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": 40356,
    "articles": [
        {
            "id": "1f7ad1633a3fba404259210536be1768",
            "title": "Cierran primeros centros de votación en Indiana y Kentucky",
            "description": "Las elecciones que definirán la segunda parte del mandato de Donald Trump son también relevantes para el resto del planeta. Acá les contamos todos los detalles de esta jornada.",
            "content": "En vivo\nPolíticaEstados Unidos\nCierran primeros centros de votación en Indiana y Kentucky\nPublicado 03/11/2026Publicado 3 de noviembre de 2026\nLas elecciones que definirán la segunda parte del mandato de Donald Trump son también relevantes para el re... [17927 chars]",
            "url": "https://www.dw.com/es/cierran-primeros-centros-de-votaci%C3%B3n-en-indiana-y-kentucky/live-79845739",
            "image": "https://static.dw.com/image/79848228_6.jpg",
            "publishedAt": "2026-11-03T23:37:05Z",
            "lang": "es",
            "source": {
                "id": "67e0c40c5e24b3fec372ab75763abad9",
                "name": "DW.com",
                "url": "https://www.dw.com"
            }
        },
        {
            "id": "eb52e414ef7248ccc2c4c5068e8e8e69",
            "title": "Elecciones en EE. UU. en vivo: ¿quién ganará el control del Congreso?",
            "description": "El resultado será un veredicto al desempeño de un presidente impopular que ha pedido el voto como si él estuviera en la papeleta.",
            "content": "Aunque los resultados no se conocerán hasta bien entrada la noche —y quizá tampoco en días o más, en particular si muchas de las contiendas son reñidas—, está claro que los votantes estaban ansiosos por emitir sus votos después de una campaña áspera ... [29359 chars]",
            "url": "https://www.nytimes.com/live/2026/espanol/eeuu-elecciones-intermedias-resultados",
            "image": "https://static01.nyt.com/images/2026/11/03/multimedia/03midterms-turnout-ghqf/03midterms-turnout-ghqf-facebookJumbo.jpg",
            "publishedAt": "2026-11-03T23:23:35Z",
            "lang": "es",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "c355b6ad545c057ece09bba1d04e8747",
            "title": "Amenazas de bomba obligan a interrumpir vuelos en Europa; no se encontraron artefactos explosivos",
            "description": "Al menos siete vuelos y un crucero en Europa recibieron amenazas de bomba, lo que provocó desvíos, inspecciones y cierres temporales en varios aeropuertos. Las autoridades no encontraron explosivos y señalaron que las alertas resultaron ser falsas.",
            "content": "Al menos siete vuelos y un crucero en Europa recibieron amenazas de bomba el martes, lo que provocó interrupciones en varios aeropuertos, aunque no se encontraron artefactos explosivos.\nAl menos dos vuelos con destino a Varsovia, dos a Sofía, dos a R... [4926 chars]",
            "url": "https://cnnespanol.cnn.com/2026/11/03/mundo/amenazas-bomba-vuelos-europa-reux",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/ryanair.JPEG?c=16x9&q=w_800,c_fill",
            "publishedAt": "2026-11-03T23:21:00Z",
            "lang": "es",
            "source": {
                "id": "3c9d862fa32f79b035b88873a5d21ccb",
                "name": "CNN en Español",
                "url": "https://cnnespanol.cnn.com"
            }
        }
    ]
}

Missing a source from Mexico? Suggest a source.

Mexico World News API

Categories

Request and live response