APIs · Automatización

Conéctate por API a casi cualquier plataforma

Detrás de casi toda aplicación que usas — Google, Bing, Reddit, YouTube, tu banco — hay una API: una puerta para que los programas pidan y manden información directamente. Antes cruzarla requería ser programador. Hoy le describes a Claude o a ChatGPT lo que quieres y la IA escribe el código. Esta guía te da el mapa: qué es una API, cómo se ve una petición de verdad, cómo te identificas y cómo pedirle el script a una IA.

Para no programadores Ejemplos reales

Qué es una API, sin rodeos

Cuando abres Google Maps y buscas "cafeterías", la aplicación pide esos datos a un servidor y te los pinta bonitos. Una API es esa misma puerta, pero abierta para tus programas: pides los datos crudos y te llegan en un formato que cualquier script entiende. Y funciona en ambas direcciones:

Pull (jalar): leer información — los lugares de una zona, tus estadísticas de búsqueda, los hilos nuevos de un subreddit.
Push (empujar): mandar información — avisar que publicaste una página, subir un dato, crear un registro.

Todo lo que haces clic por clic en un panel web, casi siempre se puede hacer por API — y entonces se puede automatizar.

La anatomía de una petición

Una petición de API son cuatro piezas: una URL, un método (GET para leer, POST para mandar), a veces unos encabezados, y a veces un cuerpo con datos. Esta es una real — leer los hilos más nuevos de un subreddit:

curl -s -A "mi-script/1.0" "https://www.reddit.com/r/Monterrey/new.json?limit=5"

Y esta es una de push — avisar a los buscadores que publicaste una página, con IndexNow:

curl -X POST "https://api.indexnow.org/indexnow" \
  -H "Content-Type: application/json" \
  -d '{"host": "ejemplo.com", "key": "TU_LLAVE", "urlList": ["https://ejemplo.com/nueva"]}'

La respuesta llega en JSON: texto estructurado con los datos. No necesitas leerlo tú — para eso está el script.

Las tres formas de identificarte

API key. Una cadena que va en la URL o en un encabezado. La más común y la más simple — así funcionan las APIs de Google y la de Bing.
Token (Bearer). Igual de simple, pero suele caducar y renovarse. Va en el encabezado Authorization: Bearer TU_TOKEN.
OAuth. El baile de "iniciar sesión con tu cuenta y autorizar permisos". Más pasos de configuración, pero las IA generan ese código de rutina sin problema — es exactamente el tipo de tarea tediosa que conviene delegarles.

La documentación de cada API te dice cuál usa. No la memorices: identifícala y pásasela a la IA.

Pídele el código a una IA

Aquí cambió el juego. Ya no necesitas saber escribir el script — necesitas saber describirlo. Un buen prompt para Claude, ChatGPT o Copilot tiene tres partes: qué API, qué quieres que pase y cómo lo vas a correr. Por ejemplo:

"Escríbeme un script de Python que use la API de PageSpeed Insights
para medir estas 20 URLs (te las pego abajo), guarde el puntaje de
cada una en un CSV, y me marque las que bajen de 80.
Lo voy a correr en mi Mac desde la terminal. Mi API key es una
variable de entorno llamada PSI_KEY."

Y cuando algo falle — porque algo siempre falla la primera vez — pégale a la IA el mensaje de error completo. Corregir errores de APIs es de las cosas que mejor hacen. Con herramientas como Claude Code, que corren en tu terminal, el ciclo es todavía más corto: la IA escribe el script, lo ejecuta, ve el error y lo corrige sola.

Regla de oro del prompt: pega también un fragmento de la documentación oficial o su URL. La IA conoce las APIs grandes de memoria, pero los detalles (endpoints nuevos, campos renombrados) cambian — con la doc enfrente no inventa.

Directorio: APIs que valen la pena

Google: Places (datos y fotos de lugares), PageSpeed (velocidad), Search Console (tus datos de búsqueda), Custom Search (búsquedas por código).
Bing Webmaster API: envía URLs y consulta tus estadísticas de búsqueda en Bing por código.
IndexNow: el push más simple que existe — un curl y los buscadores saben que publicaste.
Reddit: endpoints JSON públicos para leer, y API oficial con OAuth para publicar y monitorear.
YouTube Data API: estadísticas de videos y canales, búsquedas, subir videos — dentro del mismo proyecto de Google Cloud.
Telegram Bot API: la forma más fácil de que tus scripts te manden notificaciones al teléfono — un bot se crea en dos minutos y es gratis.
GitHub API: automatizar repositorios, issues y publicaciones de código.
Stripe API: si cobras en línea, todo — pagos, clientes, facturas — es automatizable.

Y la regla general: si una plataforma tiene panel de administración, busca "nombre de la plataforma API docs". Casi siempre existe.

Las cuatro reglas que te evitan sustos

Las llaves son secretas. Nunca en el HTML de tu sitio ni en repositorios públicos; van en variables de entorno. Y restríngelas (por API y por dominio o IP) donde la plataforma lo permita.
Respeta los límites. Toda API tiene cuota (peticiones por segundo o por día). Tu script debe esperar entre llamadas — pídeselo así a la IA: "con pausa de un segundo entre peticiones".
Revisa el precio antes de iterar. Muchas APIs tienen capa gratuita generosa, pero un ciclo mal hecho sobre miles de elementos puede facturarte. Lee qué cobra cada llamada.
Guarda lo que ya pediste. No vuelvas a pedir lo mismo: tu script debe guardar las respuestas en un archivo o base local y pedir solo lo nuevo.