¿WTF es una API?

En una frase

Una API (Application Programming Interface, interfaz de programación de aplicaciones) es un conjunto de reglas que permite que dos programas hablen entre sí.

Eso es todo. No hay más. El resto de esta guía solo desgrana lo que significa en la práctica.

La analogía del restaurante

La mejor analogía para entender una API es un restaurante.

Estás sentado a una mesa. Quieres comer. La cocina puede preparar comida. Pero no entras en la cocina a ponerte a cocinar. No le das instrucciones a gritos al chef. Usas una carta y un camarero.

La carta te dice qué puede preparar la cocina. El camarero lleva tu pedido a la cocina y te trae la comida.

En esta analogía, tú eres la aplicación que hace una petición. La cocina es el otro programa (una base de datos, un servicio, un modelo de IA). El camarero es la API. La carta es la documentación de la API.

La API es la forma acordada en que se comunican dos sistemas: qué puedes pedir, cómo lo pides y qué recibes a cambio.

Un ejemplo real

Esto es lo que pasa de verdad cuando usas una app del tiempo en el móvil:

Abres la app del tiempo.
La app no tiene los datos meteorológicos guardados en tu móvil.
Envía una petición a la API de un servicio meteorológico: «Dame la previsión para Chicago».
Los servidores del servicio meteorológico procesan la petición.
La API devuelve los datos: temperatura, humedad y previsión para los próximos 7 días.
Tu app los muestra en una interfaz bonita.

No has visto nada de eso. Solo has visto el tiempo. Pero todo ha funcionado gracias a una API.

Este mismo patrón (petición, proceso, respuesta) está detrás de casi todo lo que pasa en internet. Cada vez que inicias sesión con Google, cada vez que pagas con Stripe, cada vez que compartes algo en Twitter, cada vez que un agente de IA hace algo en el mundo, hay una API de por medio.

Por qué las API importan en la economía de los agentes

Las API son el motivo por el que los agentes de IA pueden hacer algo útil.

Un agente de IA por sí solo es un cerebro en un frasco: puede pensar y planificar, pero no puede actuar. Las API son sus manos y sus piernas. Son la forma en que los agentes se conectan con el mundo real.

Estos son ejemplos de lo que hacen los agentes a través de API:

Acción	Cómo lo hace el agente
Enviar un correo	El agente llama a la API de Gmail o a la de SendGrid con el contenido del mensaje, el destinatario y el asunto.
Navegar por la web	El agente llama a una API de web scraping o usa una herramienta de automatización del navegador expuesta mediante una API.
Procesar un pago	El agente llama a la API de Stripe con el importe y los datos de la tarjeta.
Publicar en redes sociales	El agente llama a la API de Twitter/X o a la de LinkedIn con el contenido de la publicación.
Leer una hoja de cálculo	El agente llama a la API de Google Sheets para consultar o actualizar datos.
Reservar un hueco en el calendario	El agente llama a la API de Google Calendar o a la de Calendly.
Consultar una base de datos	El agente llama a la API de Supabase o de Postgres para leer o escribir registros.
Usar un modelo de IA	El agente llama a la API de Anthropic o a la de OpenAI para que Claude o GPT piensen un problema.

Sin API, un agente de IA sería como un genio encerrado en una habitación sin teléfono, sin ordenador y sin forma de relacionarse con el exterior. Las API le abren la puerta.

MCP: la API de los agentes de IA

Uno de los avances más importantes de la economía de los agentes es el Model Context Protocol (MCP), creado por Anthropic y publicado en noviembre de 2024.

Antes de MCP, conectar un agente de IA a una herramienta o fuente de datos concreta exigía desarrollo a medida. Cada integración era distinta. Era como si cada electrodoméstico tuviera un enchufe diferente.

MCP lo estandarizó. Es el enchufe universal: el USB-C de la IA. Si una herramienta es compatible con MCP, cualquier agente de IA puede conectarse a ella sin código a medida.

En 2026, MCP lo admiten OpenAI, Google, Microsoft y prácticamente todos los grandes frameworks de agentes. Se ha donado a la Agentic AI Foundation (respaldada por Anthropic, OpenAI, Google, Microsoft, Amazon y Cloudflare), lo que lo convierte en un estándar abierto, neutral y permanente.

Esto importa porque significa que el ecosistema de herramientas al alcance de los agentes de IA crece de forma exponencial. Cada nueva herramienta compatible con MCP queda disponible al instante para todos los agentes compatibles con MCP.

Los tipos de API de los que oirás hablar

API REST

El tipo más común. Usa peticiones web estándar (GET, POST, PUT, DELETE) para obtener o enviar datos. Cuando alguien dice «la API» sin especificar, casi siempre se refiere a una API REST. La API de Polsia que usa WTF Agents para seguir los datos de las empresas es una API REST.

Webhooks

En lugar de que tú le pidas datos a la API, la API te avisa cuando pasa algo. Por ejemplo: Stripe lanza un webhook a tu servidor en el momento en que se completa un pago. No tienes que preguntar una y otra vez «¿se ha hecho ya el pago?»: Stripe te avisa cuando ocurre.

API GraphQL

Una alternativa más flexible a REST. En lugar de recibir un conjunto fijo de datos, indicas exactamente qué campos quieres. Más eficiente, pero más compleja de usar.

API de streaming

Envían datos de forma continua en lugar de en una sola respuesta. Por eso ChatGPT y Claude escriben sus respuestas palabra a palabra: la IA va emitiendo su resultado mediante una API de streaming en lugar de esperar a terminar la respuesta entera.

SDK (Software Development Kit)

Técnicamente no es una API, pero a menudo se confunden. Un SDK, o kit de desarrollo de software, es un paquete de código que envuelve una API y la hace más fácil de usar. El SDK de Anthropic es un paquete de Python o JavaScript que se encarga de los detalles técnicos de llamar a la API de Claude.

Claves de API: qué son y por qué importan

Casi todas las API exigen una clave de API: una cadena de caracteres única que identifica quién hace la petición.

Piensa en una clave de API como en la contraseña de un servicio. Cuando te das de alta en la API de Anthropic, la de OpenAI o en Stripe, te dan una clave con un aspecto parecido a este: sk-ant-api03-xxxxxxxxxxxxx

Las claves de API importan por tres motivos:

Autenticación: el servicio sabe que eres tú quien hace la petición, y no otra persona.
Facturación: el uso se registra contra tu clave. Si pierdes la clave, otra persona puede dispararte la factura.
Límite de peticiones: los servicios usan las claves para limitar cuántas peticiones puedes hacer.

La regla de oro: no compartas nunca tus claves de API en público. No las subas nunca a GitHub. Guárdalas en variables de entorno (una forma segura de pasar valores sensibles a un programa sin escribirlos directamente en el código).

Las API en el día a día: las usas sin parar

Interactúas con API decenas de veces al día sin saberlo:

Iniciar sesión con Google: la API OAuth de Google verifica tu identidad y le dice al otro sitio que eres quien dices ser.

Pagar por internet: la API de pagos de Stripe procesa tu tarjeta de forma segura sin que la web vea nunca el número completo.

Consultar el tiempo: la app del tiempo de tu móvil llama a una API de datos meteorológicos.

Buscar cómo llegar: la API de Google Maps o de Apple Maps calcula tu ruta.

Publicar en Instagram: la API de Instagram recibe tu foto y tu texto y los guarda.

Leer tu correo en una app de terceros: la API de Gmail le da a la app acceso a tus correos.

Usar «Iniciar sesión con Apple»: la API de autenticación de Apple verifica que eres tú.

Un agente de IA que te reserva un viaje: el agente llama a las API de vuelos, hoteles y calendario, todo en un único flujo automatizado.

¿Hace falta entender las API para usar agentes de IA?

Sinceramente, para la mayoría de los usos, no mucho.

Plataformas como OpenClaw, Polsia y Paperclip se encargan de las conexiones con las API por ti. Tú describes lo que quieres que haga el agente, y la plataforma se ocupa de la fontanería técnica: a qué API llamar y cómo.

Pero entender qué son las API, y saber que existen, te ayuda de tres formas:

Entiendes por qué los agentes pueden hacer lo que hacen (y por qué a veces no pueden).
Puedes evaluar las plataformas de agentes con más criterio, preguntando «¿con qué API se conecta esto?».
Si quieres crear algo a medida, sabes qué buscar.

La economía de los agentes funciona con API. No hace falta ser fontanero para vivir en una casa con agua corriente. Pero saber que hay tuberías, y más o menos cómo funcionan, te convierte en un inquilino mejor informado.

Glosario

API (Application Programming Interface): : un conjunto de reglas que permite que dos programas se comuniquen entre sí.
API REST: : el tipo de API más común. Usa peticiones web estándar para enviar y recibir datos.
Webhook: : una API que te envía datos cuando pasa algo, en lugar de esperar a que tú los pidas.
Clave de API: : un identificador único que sirve para autenticar las peticiones a una API. Trátala como una contraseña.
MCP (Model Context Protocol): : el estándar abierto de Anthropic para conectar agentes de IA con herramientas externas. El enchufe universal de la IA.
SDK (Software Development Kit): : un paquete de código que facilita usar una API en un lenguaje de programación concreto.
Endpoint: : una URL concreta que expone una API para un tipo concreto de petición. Por ejemplo, /api/data es el endpoint de los datos de las empresas de Polsia.
Límite de peticiones (rate limiting): : una restricción de cuántas peticiones a la API puedes hacer en un periodo de tiempo.
Autenticación: : el proceso de demostrarle a una API quién eres, normalmente con una clave de API o un token OAuth.
Streaming: : una API que envía datos de forma continua en lugar de todos a la vez. Así es como Claude y ChatGPT dan sus respuestas palabra a palabra.

Ya sabes qué son las API. Aquí tienes por dónde seguir en la serie WTF Agents.