Integración de Python con News API usando parámetros dinámicos

Clase 9 de 25 • Curso de Python Intermedio para Entornos virtuales y PEP8

Resumen

Conecta Python a News API de forma segura y clara: usa parámetros dinámicos, construye un query string fiable con las utilidades estándar de Python y procesa la respuesta en json sin perder tiempo en errores típicos. Aquí verás cómo incorporar tu API key, realizar un request robusto con urllib y convertir los bytes en un diccionario listo para usar.

¿Cómo obtener y proteger tu API key de News API?

Obtener la API key es el primer paso. Se solicita en newsapi.org completando un formulario y pulsando submit. Cópiala y úsala por ahora como constante en el código.

No hacerla pública ni subirla al repositorio.
Tratarla como una llave de acceso.
Guardarla temporalmente como constante para fines educativos.

La documentación oficial (Get Started, Searching for news articles) indica la URL base y que la API key se pasa como parámetro. Esa guía define el formato correcto del request.

¿Cómo construir la URL y el query string en Python?

La recomendación es evitar concatenar cadenas a mano. Usa las herramientas de Python: urllib.parse.urlencode para formatear parámetros y urllib.request para abrir la URL con un timeout controlado. Así la URL final es válida y el servidor entiende el GET.

Usar urllib.parse para generar el query string.
Añadir parámetros como la q de búsqueda y la apiKey.
Construir la URL final uniendo base y parámetros.

¿Qué hace urllib.parse.urlencode?

Convierte un diccionario de parámetros en un query string seguro para una URL. Evita errores de encoding y respeta el formato esperado por la API.

import json
from urllib import parse, request

API_KEY = "TU_API_KEY"
BASE_URL = "BASE_URL_DE_NEWS_API"  # URL base indicada en la documentación de búsqueda.

def fetch_news(api_key: str, query: str, timeout: int = 10):
    params = {
        "q": query,
        "apiKey": api_key,
    }
    query_string = parse.urlencode(params)
    url = f"{BASE_URL}?{query_string}"

    # Enviar el request con administrador de contexto.
    with request.urlopen(url, timeout=timeout) as resp:
        data_bytes = resp.read()  # Respuesta cruda en bytes.

    # Decodificar y parsear json.
    data_text = data_bytes.decode("utf-8")
    data = json.loads(data_text)
    return data

¿Cómo enviar el request con urllib.request y with?

Con el administrador de contexto with se maneja el response y se lee el contenido con seguridad. El timeout evita esperas indefinidas.

Abrir la URL con request.urlopen y pasar timeout.
Leer los bytes con .read().
Mantener el código claro y cercano a la función de fetch.

¿Cómo decodificar la respuesta y procesar artículos en json?

La respuesta llega como bytes. Hay que aplicar decode('utf-8') y luego json.loads para obtener un diccionario. Desde ahí, acceder a llaves como status, totalResults y especialmente articles para listar títulos.

Decodificar a texto con UTF-8.
Convertir a diccionario con json.loads.
Inspeccionar llaves con keys() para entender la estructura.
Iterar articles y mostrar title.

# Ejecución de prueba
response_data = fetch_news(API_KEY, "Python")
print(list(response_data.keys()))  # Ver llaves disponibles.

articles = response_data["articles"]  # Acceso a la lista de artículos.
for article in articles:
    print(article["title"])  # Imprimir solo el título.

Consejos prácticos que marcan diferencia:

Imprimir solo los primeros caracteres al inicio para validar el formato.
Mostrar el query string y la URL final para depurar.
Usar herramientas estándar de Python en lugar de armar URLs a mano.
Limpiar prints una vez que el flujo funcione.

¿Quieres profundizar o adaptar filtros de búsqueda? Explora la documentación de la API y comenta qué parámetros te gustaría incorporar a la función.

Samuel Steven Bernal Martínez

student•

De esta clase amplio un poco para que quede claro por si a alguien más le quedo dudas:

urlopen hace una petición HTTP GET a esa URL.
with ... as response: usa un context manager que abre un recurso (la conexión) y lo cierra automáticamente al salir del bloque, aun si hay error. Es la forma segura/limpia de manejar recursos (como cuando abres archivos con with open(...)).
response.read() devuelve bytes. decode("utf-8") convierte esos bytes → str (texto).
Luego json.loads(texto) convierte el JSON en dict/list de Python (estructura nativa). Eso te permite acceder a campos sin hacer parsing manual (por eso podemos hacer lo del final)

Jesús Guaita

student••

"""Esta es una version con la libreria de terceros requests"""

import requests
  
def news_api(query, apiKey, timeout=30, **kwargs):
    parametros = {"q": query, "apiKey": apiKey}
    solicitud = requests.get(BASE_URL, params=parametros, timeout=timeout)
    if solicitud.status_code == 200:
        return solicitud.json()

    return print("Error de conexion")

def fetch_news(api_name, **kwargs):
    base_config = {"timeout": 30}

    config = {**base_config, **kwargs}

    api_clients = {"newsapi": news_api}

    client = api_clients[api_name]

    return client(**config)

Luis Martinez

teacher•

Perfecto, buen caso de uso con funciones claras.

Paola Alapizco

student•

❌ ERROR: [SSL: CERTIFICATE_VERIFY_FAILED] en MacOS!!

⚠️ En entornos MacOS, al instalar Python la configuración del paquete de certificados raíz (CA bundle) se omite, y al intentar hacer peticiones a urls seguras https utilizando la librería urllib obtenemos el error [SSL: CERTIFICATE_VERIFY_FAILED] y la conexión se cierra.

Una forma de solucionarlo es ejecutando el script post-instalación de Python para configurar correctamente los certificados.

Pasos para la configuración:

Abrir Finder.
Ir a la carpeta de instalación de Python (/Applications/Python 3.x).
Buscar y hacer doble clic al script llamado: Install Certificates.command.

Esta solución corrige permanentemente el problema con todas las instalaciones de Python en el sistema, en este caso MacOS.

❓Qué es el paquete de certificados raíz (CA bundle)?

CA bundle → Certificate Authority bundle, es un conjunto de archivos que contiene las copias públicas de los certificados de confianza de las principales Autoridades de Certificación (CAs) a nivel mundial.

Su función principal es la de permitir a Python verificar la autenticidad y seguridad de los sitios web con los que se conecta a través de protocoles cifrados (HTTPS), en el ejemplo preciso del curso NewsAPI.

Proceso al intentar conectarnos a una URL segura ("https://newsapi.org/v2/everything") desde código Python:

El servidor envía su certificado digital.
Python recibe el certificado.
Python usa el CA bundle para buscar la firma digital de la Certificate Authority que emitió el certificado de NewsAPI.
Si encuentra una copia de la CA en el bundle y la firma coincide, Python confía en que el sitio/API es legitimo y permite el acceso, se lo contrario la verificación falla, obtenemos error CERTIFICATE_VERIFY_FAILED y la conexión se detiene.

Espero les sea de utilidad y les ahorre tiempo buscando el por que su código no funciona si es el mismo que el del profesor 😅.

Gabriel Obregón

student•

🧠Conexión Segura de Python + News API

🔑 1. Obtener y Proteger tu API Key

📍 Dónde conseguirla: 👉 Entra a → completa el formulario → clic en Submit.

📎 Cómo usarla (modo educativo):

Guárdala como constante: API_KEY = "TU_API_KEY"
Úsala solo para pruebas.

🧱 Buenas prácticas de seguridad:

🚫 No publiques tu API key ni la subas a repositorios.
🔐 Trátala como una llave de acceso.
🌱 En proyectos reales, guárdala en variables de entorno.
📖 Revisa la documentación oficial → define la URL base y los parámetros del request.

🌐 2. Construcción de la URL y del Query String

🎯 Objetivo: formar una URL limpia y válida sin concatenar cadenas manualmente.

🛠️ Herramientas recomendadas:

urllib.parse.urlencode() → crea el query string.
urllib.request → abre la URL con control de tiempo.

🧩 Pasos esenciales: 1️⃣ Crear un diccionario de parámetros: params = {"q": "Python", "apiKey": API_KEY} 2️⃣ Convertirlo en query string: query_string = parse.urlencode(params) 3️⃣ Unir la URL final: url = f"{BASE_URL}?{query_string}"

💡 Ventajas: ✅ Evita errores de formato.

✅ Codifica caracteres especiales automáticamente.

✅ Compatible con parámetros adicionales.

⚙️ 3. Función práctica en Python

import json

from urllib import parse, request

API_KEY = "TU_API_KEY"

BASE_URL = "https://newsapi.org/v2/everything"

def fetch_news(api_key: str, query: str, timeout: int = 10):

params = {"q": query, "apiKey": api_key}

query_string = parse.urlencode(params)

url = f"{BASE_URL}?{query_string}"

with request.urlopen(url, timeout=timeout) as resp:

data_bytes = resp.read()

data_text = data_bytes.decode("utf-8")

data = json.loads(data_text)

return data

# Ejemplo

response = fetch_news(API_KEY, "Python")

for art in response["articles"]:

print(art["title"])

🧠 Claves:

Usa with para manejar el response con seguridad.
Pasa timeout para evitar bloqueos.
Lee bytes → decodifica → convierte a diccionario.

📦 4. Procesamiento del JSON

📥 Flujo completo:

1️⃣ Recibes bytes del servidor.

2️⃣ Decodificas: decode("utf-8").

3️⃣ Cargas el JSON: json.loads().

4️⃣ Accedes a los campos del diccionario.

🗂️ Estructura típica del resultado:

status → indica éxito del request.
totalResults → número total de artículos.
articles → lista de noticias (cada una con título, autor, fecha, fuente…).

🪄 Ejemplo rápido:

for a in response["articles"]:

print(a["title"])

José Daniel López Castro

student•

Gracias por tu aporte, muy completo.

Jhon Anderson Galeano Santillana

student•

para los mas recientes, en la documentación de news api la URL es un poco distinta, como ejemplo en la documentación se construye así:

y como codigo:

import urllib.request
import urllib.parse

API_KEY = "" # COLOCAR API KEY
BASE_URL = "https://newsdata.io/api/1/latest"


def newsapi_client(api_key, query, timeout=30, retries=3):
    query_string = urllib.parse.urlencode({"q":query, "apiKey":api_key})
    url = f"{BASE_URL}?{query_string}"
    with urllib.request.urlopen(url, timeout=timeout) as response:
        data = response.read()
        print(f"response data: {data[:100]}...")
    return f"news api: {query}, con timeout: {timeout}"

def guardian_client():
    pass

def fetch_news(api_name, *args, **kwargs):
    """
    Docstring for fetch_news
    
    :param api_name: Description
    :param args: Description
    :param kwargs: Description
    """

    base_config = {
        "timeout": 30,
        "retries":3
    }

    config = {
        **base_config,
        **kwargs
    }

    api_clients = {
        "newapi": newsapi_client,
        "guardian": guardian_client
    }
    client = api_clients[api_name]
    return client(*args, **config)


fetch_news("newapi", api_key = API_KEY, query="Python")

Daniel Arturo Dominguez Lopez

student•

ami me paso algo muy curioso que hasta que no agregue estas lineas import sys sys.stdout.reconfigure(encoding='utf-8')

no me funciono me aparecia un error creo que es por la decodificacion

Argenis Daniel Nieves Berroeta

student••

Estuve experimentando un poco y quise agregar la fecha de publicación al artículo. Para una mejor visualización, limité el título a 50 caracteres usando las opciones de formato de los f-strings. Además, tuve que importar datetime y usar strptime para convertir el texto de la fecha que viene en el JSON a un objeto de fecha real, indicándole el formato exacto

response_data = fetch_news("newapi", api_key=API_KEY, query="python")
for article in response_data["articles"]:
    fecha_dt = datetime.strptime(article['publishedAt'], "%Y-%m-%dT%H:%M:%SZ")
    print(f"-&gt; {article['title'][:50]} {fecha_dt:%B %d, %Y}")

Daniel Hernandez

student•

Despues de cambios en la API de NEWS debemos cambiar el argumento api_key en query_string, el nuevo valor es "apikey" (sin el underscore). De lo contrario la url no funcionará

Andres Arevalo

student•

para los que tienen problemas en mac con lo del SSL: Certificate. corran este comando en el terminal. checken que sea la misma version.

/Applications/Python\ 3.14/Install\ Certificates.command

Erick Infante

student•

Me parece más cómodo usar 'requests' que 'urllib.request'

"""Esta es una version con la libreria de terceros requests"""

import requests
  
def news_api(query, apiKey, timeout=30, **kwargs):
    parametros = {"q": query, "apiKey": apiKey}
    solicitud = requests.get(BASE_URL, params=parametros, timeout=timeout)
    if solicitud.status_code == 200:
        return solicitud.json()

    return print("Error de conexion")

def fetch_news(api_name, **kwargs):
    base_config = {"timeout": 30}

    config = {**base_config, **kwargs}

    api_clients = {"newsapi": news_api}

    client = api_clients[api_name]

    return client(**config)

import urllib.request
import urllib.parse

API_KEY = "" # COLOCAR API KEY
BASE_URL = "https://newsdata.io/api/1/latest"


def newsapi_client(api_key, query, timeout=30, retries=3):
    query_string = urllib.parse.urlencode({"q":query, "apiKey":api_key})
    url = f"{BASE_URL}?{query_string}"
    with urllib.request.urlopen(url, timeout=timeout) as response:
        data = response.read()
        print(f"response data: {data[:100]}...")
    return f"news api: {query}, con timeout: {timeout}"

def guardian_client():
    pass

def fetch_news(api_name, *args, **kwargs):
    """
    Docstring for fetch_news
    
    :param api_name: Description
    :param args: Description
    :param kwargs: Description
    """

    base_config = {
        "timeout": 30,
        "retries":3
    }

    config = {
        **base_config,
        **kwargs
    }

    api_clients = {
        "newapi": newsapi_client,
        "guardian": guardian_client
    }
    client = api_clients[api_name]
    return client(*args, **config)


fetch_news("newapi", api_key = API_KEY, query="Python")

response_data = fetch_news("newapi", api_key=API_KEY, query="python")
for article in response_data["articles"]:
    fecha_dt = datetime.strptime(article['publishedAt'], "%Y-%m-%dT%H:%M:%SZ")
    print(f"-&gt; {article['title'][:50]} {fecha_dt:%B %d, %Y}")

Integración de Python con News API usando parámetros dinámicos

Código Pythónico y Funcional

Python intermedio: prácticas profesionales con app de noticias e IA

Configuración de PEP 8 y formateo automático con Ruff en Python

Sintaxis de list, dict y set comprehensions en Python

Comprensiones anidadas para agrupar y filtrar datos en Python

Formateo de strings con f-strings en Python

Modificadores de formato avanzados en FStrings para números y fechas

Calidad y Profesionalismo del Código

Argumentos dinámicos *args en funciones Python

Uso de kwargs para crear un cliente de APIs flexible

Integración de Python con News API usando parámetros dinámicos

Control de errores en Python con try y except

Manejo de Datos y Recursos

Uso del bloque finally para liberar recursos en Python

Creación de excepciones personalizadas en Python

Anotaciones de tipo con type hints en Python

Tipado de funciones y estructuras de datos en Python

Documentación en Python con docstrings y PEP 257

Optimización y Pruebas

Entornos virtuales en Python: qué son y por qué los necesitas

Creación y gestión de entornos virtuales con venv en Python

Creación de entornos virtuales en Windows con Python

Creación de Aplicaciones de Consola

Gestión moderna de dependencias Python con UV y pyproject

Modularización de código Python con responsabilidad única

Paquetes Python: de estructura plana a código modular

Función enumerate en Python para indexar listas automáticamente

Filtrado de listas con filter en Python

Función map para calcular tiempo de lectura en Python

Conexión de OpenAI API con variables de entorno en Python