Contenido del curso
Conectar Python a NewsAPI con parámetros reales
Conectar Python a NewsAPI es el paso donde tu código deja de ser teoría y empieza a traer noticias reales desde un servidor externo. Si ya entiendes los parámetros dinámicos, aquí aprenderás a crear una API key, armar una URL válida y transformar la respuesta en datos que puedas leer. Es una guía práctica para quien aprende integraciones con APIs en Python.
La idea es sencilla pero poderosa: escribes una consulta como Python, la envías a NewsAPI y recibes de vuelta una lista de artículos de noticias reales. Vamos paso a paso.
Cómo obtener una API key de NewsAPI
Antes de escribir una sola línea de código, necesitas tu llave de acceso. En newsapi.org hay un botón para registrarte, llenas un formulario, le das submit y obtienes tu API key de inmediato [00:38].
Aquí viene lo importante: esta API key es una llave privada y no debe ser pública. No la compartas ni la subas al repositorio. En clases futuras verás el manejo adecuado, pero por ahora, para facilitar el aprendizaje, la colocas en el código como una constante [01:00].
¿Qué es una API key? Es una credencial única que identifica quién hace la petición a un servicio. Funciona como una contraseña que autoriza tu acceso a la API, por eso nunca debe hacerse pública.
Después de la llave, necesitas la URL base. La encuentras en la sección Get Started Guide de la documentación, específicamente en Searching for news articles, que es justo lo que quieres hacer [01:36]. Esa URL la guardas en otra variable constante.
Qué paquetes de Python necesitas para hacer el request
Python ya incluye lo que necesitas dentro del paquete urllib. De ahí usas dos módulos clave:
El primer paso es construir el query string. Usas urllib.parse.urlencode para que Python renderice tus parámetros en el formato adecuado para URLs [02:50]. Esos parámetros son la query (tu búsqueda) y la API key.
Cuando imprimes el query string ves cómo Python lo arma: separa la consulta con una q, agrega un ampersand y suma la API key [05:00]. Así es como los servidores se comunican pasando parámetros tipo get.
¿Por qué usar urlencode en vez de armar la URL a mano? Porque escribir el formato desde cero es propenso a errores. urlencode aplica la misma estrategia que la documentación oficial y garantiza que la URL sea válida.
Luego concatenas la URL base con el query string usando un literal string, y al imprimirla ves la URL completa: la base más todos los parámetros que le pasas al request [05:40].
Cómo leer y convertir la respuesta del servidor
Para hacer la petición usas un context manager con with, que abre la URL y define un response. Le pasas la URL creada y una configuración extra como el timeout, que llega de forma dinámica [03:40].
Al principio, cuando haces read(), el servidor te devuelve la información en bytes con un status OK y formato JSON, pero difícil de leer [04:20]. Aquí entra el proceso de limpieza en dos movimientos:
json.loads para cargar ese texto en un diccionario, que defines como data y retornas [06:40].Recuerda que los imports siempre van en la parte de arriba del archivo. En esta etapa se hace todo en un mismo archivo, pero más adelante se arma una arquitectura correcta [07:04].
¿Qué hace json.loads en Python? Convierte una cadena de texto en formato JSON válido en un diccionario de Python. Así puedes acceder a los datos con claves en vez de leer texto plano.
Cómo recorrer los artículos que devuelve NewsAPI
Cuando guardas la respuesta en una variable response data y la imprimes completa, ves un diccionario grande con claves como status, totalResults y articles [07:50].
Un truco útil: puedes usar keys() para ver qué llaves llegan del servidor antes de acceder a ellas. Al confirmar que existe la clave articles, la accedes y recibes una lista de objetos, donde cada uno tiene su title y otros datos [08:20].
Para mostrarlos de forma limpia, cierras con un for:
article de la lista.title para no saturar la consola.Al ejecutar, aparece la lista completa de noticias relacionadas con tu búsqueda [08:50]. Con eso ya tienes una integración real funcionando: pasas Python como consulta y recibes titulares reales.
Si te quedaste con dudas sobre cómo funcionan los requests y los responses, vale la pena volver al curso de fundamentos de ingeniería de software. Y si quieres experimentar más, revisa la documentación de NewsAPI para descubrir qué otros parámetros puedes agregar a tu consulta.
¿Ya probaste tu integración con otra palabra clave? Cuéntame qué noticias te devolvió.
Samuel Steven Bernal Martínez
Estudiante
Andres Herney Salcedo Lopez
Estudiante
Leonardo Palomino
Estudiante
Paola Alapizco
Estudiante
Victor Hugo Rodríguez López
Estudiante
Diego Ignacio Concha de la Fuente
Estudiante
Daniel Hernandez
Estudiante
Diego Galvis
Estudiante
Jesús Guaita
Estudiante
Luis Martinez
Estudiante
Juan Pablo Orozco
Estudiante
Erick Infante
Estudiante
Gabriel Obregón
Estudiante
José Daniel López Castro
Estudiante
Jeferson Andrés Cruz Herrera
EstudianteJhon Anderson Galeano Santillana
Estudiante
Daniel Arturo Dominguez Lopez
Estudiante
Miguel Angel Moreno C.
EstudianteMiguel Angel Moreno C.
EstudianteLeonardo Damián Paillamilla
Estudiante
Ulises Rodríguez Candela
Estudiante
Jarod Fernando Fernandez Morales
Estudiante
Argenis Daniel Nieves Berroeta
EstudianteDe 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).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)vuelvo a lo mismo, se sigue sin explicar muchas cosas, para que se usan varias cosas e iniciando es como dificil entender muchos conceptos a los cuales no se tiene conocimiento y se aborda la clase como si ya se debieran saber esas cosas
Esta clase me hizo dudar si queria continuar aprendiendo python... incluso pense que me habia saltado un curso completo. Acudi a gemini para que me explicara de que se trataba esta clase. Me desanime al ver que el siguiente curso es con el mismo profe. Esta clase me parecio terrible.
❌ 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:
/Applications/Python 3.x).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:
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 😅.
Logré implementar con éxito el uso de NewsAPI gracias al apoyo de Gemini. Noté que el desarrollo del curso avanza de forma muy general y rápida, omitiendo detalles técnicos que considero esenciales para alguien que busca dominar Python desde cero. Utilizar la IA como mentor me permitió cubrir esos vacíos de información y aterrizar los conceptos de manera más efectiva que el material proporcionado.
Clase de no muy buena calidad sinceramente. Como se puede apreciar en la mayoría de comentarios, se usa mucho autocompletado con ia en el código sin explicar el por qué de muchas cosas. Se salta muchas explicaciones y temas previos por acelerar el video. Espero no volver a tener estas sensaciones y experiencias en Platzi.
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á
Gracias!!! Pequeños detalles que nos hacen una pesadilla practicar y obtener los mismos resultados de la clase.
"""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)
Perfecto, buen caso de uso con funciones claras.
Quiero amablemente dejar una sugerencia a la plataforma.
Les aseguro que la información que aquí se da se puede conseguir en línea o usando alguna IA pero el hecho de una persona acceda a este curso va a mas allá de tener la información.
Lo que la mayoría busca con cursos como estos, es la manera de asimilar esa información, de aprenderla, de entenderla. Si priorizan dar el contenido de un curso mas que la manera en que lo hacen, estarían cometiendo el mismo error que se comete en muchas universidades. Cuando la gente queda con vacíos, empieza a divagar y de cierta manera a perder el gusto por eso que se quiere aprender o por lo menos a sentir que el camino se hace mas largo cuando no necesariamente debe ser así.
Platzi es una plataforma muy poderosa, y creo que deberían explicar con mas detalles ciertos conceptos, o decir que conocimientos previos se deben tener para entender todo lo que aquí se habla o indicar si esta dirigido a cierto público con experiencia e iniciar el curso en el momento indicado. Ojalá lo puedan tomar como sugerencia y no quede en el aire. Se agradece por el tiempo y las formas en que lo hacen.
Me parece más cómodo usar 'requests' que 'urllib.request'
🧠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):
🧱 Buenas prácticas de seguridad:
🌐 2. Construcción de la URL y del Query String
🎯 Objetivo: formar una URL limpia y válida sin concatenar cadenas manualmente.
🛠️ Herramientas recomendadas:
🧩 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:
📦 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:
🪄 Ejemplo rápido:
for a in response["articles"]:
print(a["title"])
Gracias por tu aporte, muy completo.
Yo también me siento un poco frustrado (a veces quiero rendirme); el profesor asume que muchos conceptos "ya los sabemos", y eso hace que se salten las explicaciones del caso. Pero no nos desanimemos: si el profesor no explica, usemos Gemini, Claude, etc., para ayudarnos a entender. Sí, considero que debemos dejar este tipo de comentarios aquí para que, en algún momento, Platzi los lea y estos vacíos sean corregidos. ¡Pero nada, muchachos, animémonos; no nos dejemos vencer por estos obstáculos!
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")
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
me parece que debería explicar mejor la funciones de las librerías utilizadas por que no entendí bien que es lo que hacían y me toco acudir a la ia además me ocurrió un error, por que por alguna razón en esta linea la llave no puede ser "api_key" sino que tiene que llamarse "apiKey" (eso el profe debería explicarlo) y de paso les dejo la función explicada y documentada según lo que entendí
def newsapi_client(api_key, query, timeout=30, retries=3): """ le decimos que comvierta la consulta (query) a un formato valido para la ulr y pues la api_key es para que al mandar la consulta la api nos reconosca luego juntamos todo para que la URL este lista para hacer la consulta a la api """ 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 is : {data[:100]}") return f"NewsAPI: {query} con timeout:{timeout}"
yo viendo la api_key del profe
Comparto mi codigo
Honestamente, esta clase me fue complicada. En esta clase estamos realizando el reto de la clase anterior por lo que ya inicie esta clase con mi codigo. El codigo que tengo es diferente al del profe por lo que saber que cambiar, borrar o agregar llevo bastante tiempo para entender como funciona el enseñado en la clase.
import json import urllib.parse import urllib.request API_KEY = "mi_api_key" API_ENDPOINT = "https://newsapi.org/v2/everything" API_TIMEOUT = 30 def newsapi_client(query, api_key=API_KEY, timeout=API_TIMEOUT, **kwargs): query_string = urllib.parse.urlencode({"q": query, "apiKey": api_key, **kwargs}) url = f"{API_ENDPOINT}?{query_string}" with urllib.request.urlopen(url, timeout=timeout) as response: data = response.read().decode("utf-8") return json.loads(data) # Verificar que la respuesta es un JSON válido return f"NewsApi: {query}, API Key: {api_key}, Timeout: {timeout}, Additional Params: {kwargs}" def guardian_client(api_key, section, from_date, timeout=30, retries=3): return f"Guardian: API Key: {api_key}, Section: {section}, From Date: {from_date}, Timeout: {timeout}, Retries: {retries}" def fetch_news(api_name, *args, **kwargs): """ Funcion flexible para conectar con la API """ base_config = { "timeout": 30, "retries": 3, } config = { **base_config, **kwargs } api_clients = { "news_api": newsapi_client, "guardian": guardian_client, } client = api_clients[api_name] return client(*args, **config) # Llamada limpia usando 'from_date' para evitar el conflicto de sintaxis response_data = fetch_news("news_api", "Python", API_KEY, language="en", sortBy="relevancy", from_date="2026-06-03") for article in response_data["articles"]: print(f"Title: {article['title']}")
Se logró pero en mi caso me marcaba qu eme faltaban certificados para poder correr urllib.request
GUIA PARA ESTA CLASE
# Integración de Python con News API usando parámetros dinámicos
"""API Real con parametros dinamicos"""
import json
import time
# este url parse sirve para poder configurar que la url baseurl tenga formato
# Adecuado para el momento de hacer el requests para que sea valido
import urllib.parse
# Este url request nos permite hacer los ajustes/
# configuraciones que queramos de request como si fuera navegador web
import urllib.request
# Configuración inicial
API_KEY = "pongan su LLAVE DE API"
BASE_URL = "pongan el hhtps de su URL"
# --- CLIENTES DE API ---
# --- 1. DEFINIR PRIMERO LAS FUNCIONES DE LOS CLIENTES ---
def news_api_client(api_key, query, timeout=30, retries=3):
"""Realiza la petición a NewsAPI, maneja reintentos y retorna un JSON."""
query_string = urllib.parse.urlencode({"q": query, "apiKey": api_key})
url = f"{BASE_URL}?{query_string}"
for intento in range(retries):
try:
with urllib.request.urlopen(url, timeout=timeout) as response:
# Leemos los datos y los decodificamos a string
raw_data = response.read().decode("utf-8")
# Convertimos el string a un diccionario/lista de Python (JSON)
return json.loads(raw_data)
except Exception as e:
print(f"Intento {intento + 1} falló: {e}")
if intento < retries - 1:
time.sleep(2)
else:
# Si falla del todo, retornamos un dict con el error para no romper el flujo
return {"status": "error", "message": str(e), "articles": []}
def guardian_client(api_key, section, from_date, timeout=30, retries=3):
"""Simulación para la API (retorna formato similar)."""
return {
"status": "ok",
"articles": [{"title": f"Noticia de Guardian en {section} desde {from_date}"}],
}
# --- FUNCIÓN PUENTE (DYNAMIC FETCH) ---
# --- 2. DEFINIR LA FUNCIÓN PUENTE ---
def fetch_news(api_name, *args, **kwargs):
"""Gestiona la configuración base y selecciona el cliente."""
config = {
"timeout": 15,
"retries": 3,
}
config.update(kwargs)
# Ahora Python ya conoce 'news_api_client' y 'guardian_client'
api_clients = {
"newsAPI": news_api_client,
"Guardian": guardian_client,
}
if api_name not in api_clients:
raise ValueError(f"API '{api_name}' no soportada.")
client = api_clients[api_name]
return client(*args, **config)
# --- 3. EJECUCIÓN Y PROCESAMIENTO ---
print("=== BUSCANDO NOTICIAS ===")
# Ejecutamos la petición
response_data = fetch_news("newsAPI", api_key=API_KEY, query="Python programming")
# Procesamos los resultados (como en el código que te pasaron)
if response_data.get("status") == "ok":
print(f"Se encontraron {len(response_data.get('articles', []))} artículos.\n")
# Iteramos sobre la lista de artículos
for article in response_data["articles"][
:5
]: # Limitamos a los primeros 5 para no saturar
print(f"Título: {article['title']}")
print(f"Fuente: {article['source']['name']}")
print("-" * 30)
else:
print(f"Error al obtener noticias: {response_data.get('message')}")
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"-> {article['title'][:50]} {fecha_dt:%B %d, %Y}")