¿Qué es una API?

API son las siglas de Application Programming Interface. La documentación de MDN la describe como un conjunto de funciones y reglas dentro de un programa que permite interactuar con él mediante software, en lugar de a través de una interfaz de usuario. También la compara con un contrato: quien la usa sabe qué puede pedir, en qué formato y qué recibirá a cambio.

En la web, la mayoría de las API funcionan sobre HTTP. Un programa envía una petición a una dirección concreta, el llamado endpoint, con los parámetros que quiere, y recibe una respuesta, casi siempre en formato JSON. Para saber quién pregunta, la API suele exigir una clave o un inicio de sesión con OAuth, y limita cuántas peticiones se pueden hacer en un periodo de tiempo.

Conviene distinguir la API de la herramienta que la usa. Search Console tiene una interfaz web para personas y, además, una API para programas. Los datos de fondo son los mismos, pero las reglas de acceso, los límites y lo que se puede automatizar cambian.

Una petición a una API tiene siempre tres partes: qué se pide, con qué parámetros y quién lo pide. En la API de Search Console, por ejemplo, el método searchanalytics.query recibe un rango de fechas, las dimensiones por las que agrupar (consulta, página, país, dispositivo) y dos parámetros para paginar: rowLimit, que admite entre 1 y 25.000 filas por respuesta con un valor por defecto de 1.000, y startRow, que indica desde qué fila empezar.

Cuando el resultado no cabe en una respuesta, se pagina. La guía de Google para obtener los datos de rendimiento indica que se repita la misma petición aumentando startRow de 25.000 en 25.000 hasta recibir una respuesta sin filas. Este patrón, pedir por partes hasta que no queda nada, es habitual en casi todas las API que entregan listas largas.

Las API también fijan cuotas: cuántas peticiones se pueden hacer por minuto o por día. Superarlas no rompe nada, pero la API responde con un error hasta que la cuota se renueva. Por eso las herramientas que dependen de una API suelen pedir los datos día a día y guardar una copia propia.

Casi todo el trabajo de SEO a escala pasa por una API. Los paneles que combinan Search Console, Google Analytics y datos de rastreo leen esas fuentes por sus API, no copiando tablas a mano. Lo mismo vale para la medición de la visibilidad en IA: nuestro propio seguimiento envía las preguntas a ChatGPT, Claude o Gemini a través de API, no escribiendo en la ventana de chat.

Por eso los límites de una API se convierten en límites de lo que sabes. Quien llama a la API de Search Console sin cambiar rowLimit recibe 1.000 filas, el valor por defecto, aunque haya muchas más. Y la forma de preguntar cambia la respuesta: con más o menos dimensiones, el número de filas y la parte del tráfico que queda asignada a una consulta varían. Antes de comparar cifras de dos herramientas, conviene saber cómo preguntó cada una.

Esta web es un ejemplo de cómo una API cambia la arquitectura de un sitio. El código fuente de zds.es declara «Astro» como generador, comprobado el 8 de octubre de 2026. Lo que hay detrás es nuestra propia configuración: el contenido se edita en WordPress y Astro lo lee a través de la API REST de WordPress para construir cada página. Para quien lee no cambia nada. Para el SEO, sí: todo lo que llega a Google sale del frontend, y un dato que el frontend no pide a la API no existe en la página publicada.

• Lee la referencia oficial de cada método antes de usarlo: parámetros, valores por defecto, límites y formato de respuesta.
• Pagina hasta recibir una respuesta vacía y comprueba si el total de filas se detiene en una cifra redonda.
• Compara la misma métrica pedida de dos formas distintas, por ejemplo con más o menos dimensiones, para detectar cortes.
• Guarda las claves y los tokens de acceso fuera del código y con los permisos mínimos necesarios.
• Respeta las cuotas: pide los datos en lotes diarios y guarda una copia propia en lugar de repetir peticiones.
• Anota con qué parámetros se obtuvo cada conjunto de datos, para que otra persona pueda repetir la consulta.

• Usar el valor por defecto de rowLimit, 1.000 filas, y creer que se tienen todos los datos.
• Dar por completo un resultado porque la paginación terminó, sin comprobar dónde se detuvo.
• Comparar cifras de dos herramientas que consultan la misma API con parámetros distintos.
• Publicar claves de API en repositorios, capturas o código del navegador.
• Confundir lo que muestra la interfaz web con lo que devuelve la API: pueden aplicar límites y agregaciones diferentes.