La Graph API es la API HTTP de Meta para Facebook e Instagram. Si un software publica un post, lee estadísticas o gestiona una cuenta en cualquiera de las dos plataformas, pasa por la Graph API. Para un ejemplo práctico, consulta cómo publicar con la Graph API de Instagram. El nombre viene del "grafo social" de Meta: personas, páginas y posts como nodos conectados.
// 01
Para qué se usa
En Instagram, la Graph API cubre las cuentas profesionales: publicar posts mediante contenedores de medios, leer estadísticas de la cuenta y gestionar sus datos. El acceso requiere un permiso OAuth con los scopes adecuados, y los permisos que tu app puede pedir dependen del proceso de revisión de apps de Meta.
// 02
Trabajar con la Graph API
La Graph API tiene versiones, y cada versión tiene fecha de retirada, así que las integraciones necesitan mantenimiento regular a medida que campos y permisos cambian entre versiones. También impone sus propios límites de peticiones por app y por usuario. Esa carga de mantenimiento explica en gran parte por qué existen las APIs unificadas: siguen los cambios de Meta para que cada producto construido encima no tenga que hacerlo.
// 03
¿La Instagram Graph API es gratis?
Meta no publica ninguna tarifa de uso. Lo que pagas es cumplir sus requisitos y respetar sus límites: una cuenta profesional de Instagram, la App Review de Meta antes de que tu app obtenga Advanced Access, 4.800 llamadas por impresión en una ventana de 24 horas y 100 publicaciones hechas por API por cuenta en 24 horas. El coste real es el trabajo de ingeniería, que se detalla en cuánto cuesta la API de Instagram.
// 04
La Instagram Graph API e Instagram Login no son la misma API
La documentación de Meta agrupa ahora sus APIs de Instagram dentro de Instagram Platform, y hay dos APIs distintas entre las que elegir, cada una con su propia configuración:
- La Instagram Graph API, que se usa con Facebook Login for Business. La cuenta de Instagram debe ser Business o Creator y estar vinculada a una página de Facebook, y las peticiones van a la Graph API.
- La Instagram API with Instagram Login, una variante independiente que Meta lanzó en julio de 2024. Elimina el requisito de la página de Facebook, usa graph.instagram.com como host y tiene sus propios scopes de permisos, como instagram_business_basic e instagram_business_content_publish.
Elige una antes de empezar, porque el host, los scopes y el flujo de inicio de sesión son distintos. Las dos son oficiales. Las herramientas que inician sesión como el usuario no lo son y ponen la cuenta en riesgo. Si prefieres no construir ninguno de los dos flujos de inicio de sesión, la API de publicación en Instagram gestiona la conexión de cuentas por ti.
Pasa de la definición a la documentación que muestra cómo aplicarlo.
Solución principal Conectar una cuenta de Instagram