Scraping de Instagram: requisitos de la API
Elige una ruta de datos de Instagram según cuenta, autorización, API y campos. Distingue los límites de Business Discovery, oEmbed y el navegador.
BotBrowser Team
Quieres la documentación estructurada de Primeros pasos?
Este artículo forma parte de la biblioteca editorial. Para pasos de configuración, material de referencia y actualizaciones continuas, entra en la sección de docs.
El scraping de Instagram empieza por una pregunta de elegibilidad: ¿puede un producto oficial devolver los campos necesarios para esa cuenta y finalidad? Un navegador con sesión iniciada no la responde. BotBrowser permite integrar Chromium con herramientas de automatización para comprobaciones del navegador autorizadas por separado, pero no concede permisos de Meta, modifica la elegibilidad de cuentas, amplía campos de API ni autoriza la recopilación. Define cuenta, activo y permisos antes de elegir una sesión. La configuración del navegador con Playwright cubre el arranque de esa capa una vez definido su cometido permitido.
TL;DR
- Las API de cuentas profesionales de Instagram sirven a cuentas Business y Creator; una cuenta personal corriente no es una entrada equivalente.
- Meta documenta actualmente Unified Login, Instagram Login y Facebook Login, con distintos requisitos de portfolio, página, token y servidor.
business_discoveryexpone una superficie profesional limitada, no datos arbitrarios; oEmbed permite mostrar contenido incrustado, no construir conjuntos de datos analíticos.- Un campo no admitido exige reducir el requisito o buscar otra fuente autorizada, no pasar automáticamente a recopilar el DOM con sesión iniciada.
Contenido
- Clasificar la cuenta y los datos solicitados
- Separar las tres configuraciones de API
- Comprobar funciones y campos
- Interpretar ausencias antes de abrir un navegador
- Conclusión práctica
Clasificar la cuenta y los datos solicitados
La descripción de Instagram Platform explica el acceso a cuentas profesionales y distingue la cuenta atendida por una aplicación de los demás usuarios que interactúan con ella. Ser propietario de una cuenta no equivale a poseer la plataforma; el consentimiento de su titular no concede una licencia general sobre sus datos. El registro de decisiones sobre permisos de recopilación separa finalidad, condiciones de la plataforma, autorización y usos posteriores antes de implementar nada.
Aplica esta matriz antes de escribir selectores. Cada fila corresponde a una decisión de producto diferente; resolver una no demuestra elegibilidad para las demás.
| Datos necesarios | Posible ruta oficial | Regla de elección |
|---|---|---|
| Perfil y contenido de la cuenta profesional conectada | Una configuración de Instagram API elegible | Comprobar condición Business/Creator, activo compartido, permisos concedidos y campos del punto de acceso |
| Metadatos públicos de otra cuenta profesional | business_discovery si la configuración elegida lo admite | Comprobar cuenta objetivo, campos públicos y límites propios; no presuponer estadísticas privadas |
| Mostrar una publicación pública en otro sitio o aplicación | /instagram_oembed | Usar solo para la visualización incrustada permitida, no para una fuente analítica almacenada |
| Historial arbitrario de cuentas personales, datos privados o grafo completo de seguidores | Estos productos no establecen una ruta general | Detener o reducir el conjunto solicitado; una sesión visible no aporta la autorización que falta |
Un requisito concreto sería obtener el perfil y las publicaciones de la cuenta Creator conectada para sus propios informes, comprobando aparte los permisos de estadísticas si hacen falta. «Todos los campos visibles en Instagram» no es equivalente. Registra juntos account_type, account_id, purpose, requested_fields, api_setup y la referencia de autorización. Es un registro de planificación de la aplicación, no un esquema de petición de Meta ni una afirmación de ejecución.
Una agencia debe vincular los activos concedidos por cada cliente a su autorización. Que un token lea una cuenta no demuestra acceso a otra. El aislamiento del navegador resuelve otra cuestión: la gestión social de varias cuentas cubre sesiones y almacenamiento autorizados, no la elegibilidad de las API de Meta.
Aplicar la matriz a una solicitud de informes
Considera un ejemplo construido: un cliente con cuenta Creator quiere su perfil, lista de publicaciones y mediciones de rendimiento. Perfil y publicaciones corresponden a la cuenta profesional conectada; las estadísticas requieren revisar otro punto de acceso y sus permisos. Guarda en requested_fields la lista real, no «todo». Si después se añaden métricas privadas de competidores, cambia el alcance de los datos; no es otra página de la lista original.
El registro de la aplicación puede explicitarlo:
| Campo de planificación | Valor construido | Consecuencia |
|---|---|---|
account_type | Creator | Se puede comprobar el requisito de cuenta profesional |
relationship | El cliente conecta su propia cuenta | Utilizar su activo compartido, no la cuenta ajena del operador |
purpose | Informes para ese cliente | Evaluar tratamiento y conservación permitidos para esa finalidad |
requested_fields | Perfil y publicaciones propias; estadísticas especificadas aparte | Revisar cada punto de acceso y el permiso adicional de estadísticas |
excluded_data | Métricas privadas de otras cuentas | No reinterpretar los recuentos de descubrimiento como esas métricas |
Son valores propuestos para la aplicación, no una respuesta satisfactoria de la API. El resultado útil siguiente es identificar un punto de acceso elegible documentado y sus permisos mínimos. Un requisito sin esa correspondencia sigue sin resolver aunque alguien vea un valor parecido en el teléfono. Si un panel combina datos de la cuenta conectada y observaciones de competidores, identifica origen y alcance por campo en vez de presentar todas las columnas como igualmente completas.
Separar las tres configuraciones de API
La comparación de Unified Login recomienda esta opción para nuevas integraciones. El cliente puede entrar mediante Instagram o Facebook, elegir su portfolio empresarial y compartir el activo de Instagram. El Business Integration System User Access Token resultante pertenece al portfolio, no a la persona que inició sesión. Esa diferencia evita confundir una cookie del navegador con una credencial de API.
| Configuración | Requisitos de página y portfolio | Servidor y clase de token |
|---|---|---|
| Unified Login | No requiere página de Facebook; sí portfolio empresarial | graph.facebook.com; Business Integration System User Access Token |
| Instagram Login | No requiere página; el flujo de inicio no exige portfolio | graph.instagram.com; Instagram User access token |
| Facebook Login | Requiere página de Facebook vinculada; portfolio según configuración | graph.facebook.com; Facebook User o Page access token |
En todas sigue siendo pertinente la elegibilidad profesional. Poder entrar con Facebook no convierte una cuenta personal de Instagram en un activo profesional admitido. La referencia de elegibilidad señala una cuenta personal o un portfolio incorrecto como causas de ausencia en la selección. Cambiar la identidad del navegador no corrige ninguna.
Los permisos también pertenecen a una configuración. Unified Login usa nombres como instagram_basic e instagram_manage_insights; Instagram Login utiliza la familia instagram_business_*. No copies un nombre entre integraciones solo porque la función visible parezca similar. La documentación de permisos relaciona las familias y remite a los requisitos de cada punto de acceso.
Standard Access permite probar con personas que tienen un rol en la aplicación. Para clientes de Unified Login sin ese rol se necesita Advanced Access para cada permiso pertinente mediante App Review, además de la aplicación en modo Live. La descripción general también exige Business Verification para Advanced Access. Una respuesta correcta con una cuenta de desarrollo no demuestra preparación para incorporar clientes externos.
La selección del activo forma parte de la autorización
En Unified Login, separa la configuración de la aplicación de la aprobación del cliente. La configuración solicita permisos y tipos de activos; después el cliente elige portfolio y cuenta y aprueba el acceso. config_id identifica esa configuración, no una cuenta de Instagram ni una garantía de que se compartieron todos los activos solicitados. Antes de aceptar un informe, vincula el identificador devuelto por el flujo admitido con la cuenta que el cliente pretendía conectar.
También cambia el diagnóstico. Si falta el activo, la página de elegibilidad dirige la comprobación hacia el tipo de cuenta y la propiedad del portfolio. Si una herramienta de integración declara inválido un token Unified, esa misma página aclara que la herramienta solo acepta tokens Instagram User de Instagram Login. Su clase de credencial debe coincidir con la integración antes de interpretar el resultado como fallo de autorización. Repetir el inicio de sesión no hace intercambiables las clases de token.
No guardes credenciales en el registro de decisiones. Meta solicita el ID de aplicación, config_id, hora aproximada con zona horaria, paso interrumpido, opción de inicio, visibilidad del activo esperado y mensaje de error. Excluye expresamente tokens, secretos de aplicación y contraseñas de registros y solicitudes de soporte. Esas observaciones permiten explicar dónde falló la selección sin distribuir una credencial que aún podría conceder acceso.
Comprobar funciones y campos
Leer perfil y publicaciones de la cuenta conectada mediante instagram_basic es distinto de obtener estadísticas con instagram_manage_insights. Importan permisos del punto de acceso, activos compartidos y campos devueltos. Un token no declara accesibles todas las funciones y cuentas.
Para otras cuentas profesionales, la referencia de Business Discovery describe consultas desde la cuenta profesional solicitante indicando el usuario objetivo. Enumera campos públicos y permisos como instagram_basic, instagram_manage_insights y pages_read_engagement para Facebook Login, con requisitos adicionales en determinados casos de roles de página mediante Business Manager. No ofrece acceso arbitrario a cuentas personales ni estadísticas privadas de otras cuentas.
Hay una diferencia documental importante: la guía de Business Discovery menciona Facebook Login y Unified Login, mientras la referencia del punto de acceso enumera explícitamente Facebook Login. Confirma la compatibilidad de la configuración elegida en su documentación vigente y mediante una petición mínima permitida. La etiqueta más amplia de la guía no basta para trasladar la receta de tokens y permisos a otra configuración. No se ejecutó ninguna petición real para esta comparación.
La referencia documenta además dos límites de integridad:
- No devuelve cuentas Business con restricción de edad. La ausencia no demuestra automáticamente un selector defectuoso ni una cuenta eliminada.
- Puede omitir
media_urlpor determinadas condiciones de audio protegido, con licencia o infracciones de derechos. Al leer contenido de otro usuario también incluye reels cuyo propietario desactivó las descargas. Un objeto sin URL no es necesariamente una respuesta HTTP incompleta.
La paginación anidada de /media constituye otra excepción: hay cursores before y after, pero no campos previous o next. Construye la consulta siguiente a partir de esos cursores documentados para esa relación; no presupongas paging.next en toda respuesta Graph. Mantén la excepción ligada a Business Discovery, sin extenderla a todos los puntos de acceso de Instagram.
La documentación de oEmbed define otro producto. Su HTML y metadatos sirven para mostrar contenido incrustado. Prohíbe explícitamente extraerlos, conservarlos o derivar análisis para otra finalidad. Una URL pública o una respuesta incrustada no justifica usar /instagram_oembed como API alternativa de recopilación.
Recuentos, estadísticas y URL multimedia responden a preguntas distintas
Un resultado de descubrimiento puede incluir followers_count o media_count; eso no lo convierte en una fuente de estadísticas privadas del objetivo. Especifica si el informe necesita recuentos públicos, estadísticas de una cuenta autorizada o entrega del archivo multimedia. Tienen contratos de elegibilidad y campos diferentes. Obtener un recuento no satisface un requisito que necesita los tres.
Distingue también la ausencia de media_url de la ausencia del objeto. Si existe el identificador pero una restricción documentada impide devolver la URL, conserva esa distinción en la definición de integridad del informe. No rellenes el hueco con una URL interna observada en el navegador ni deduzcas eliminación. La restricción de la API forma parte del resultado, no es un defecto de identidad del navegador.
oEmbed excluye cuentas privadas, inactivas y restringidas por edad, publicaciones con inserción desactivada y Stories. Incluso para contenido admitido, la finalidad permitida sigue siendo mostrarlo. Que una inserción funcione en una vista previa no demuestra permiso de exportación ni un método admitido para acumular historiales. Elige este producto porque necesitas incrustar contenido, no porque falte el punto de acceso analítico deseado.
Interpretar ausencias antes de abrir un navegador
Si una cuenta desaparece de la incorporación, revisa primero tipo, portfolio seleccionado y estado de compartición. Meta documenta errores de token cuando una cuenta cambia de portfolio o el cliente elimina la aplicación; reconectar mediante el flujo admitido resuelve esa relación. No prometas una duración universal de tokens entre las tres clases ni equipares sesión del navegador con autorización válida de API.
La página de elegibilidad concreta esa separación. Un error de tipo de cuenta señala Business o Creator; la falta de instagram_manage_messages apunta a configuración o permiso no concedido; un error de acceso a mensajes desactivado apunta al ajuste de Instagram de la cuenta. Exigen correcciones distintas. Registra error real y punto de acceso, y resuelve con el cliente autorizado el requisito indicado. Un contexto nuevo no sustituye esos cambios; leer el perfil correctamente tampoco demuestra que la mensajería esté activada.
Si falta un campo, distingue datos no admitidos, permiso ausente, contenido no disponible y petición fallida. Para límites de frecuencia, usa respuesta y ámbito de cuota documentados para el punto elegido; la concurrencia y espera progresiva explica la planificación. Añadir identidades no corrige un presupuesto de cuenta o aplicación.
Respuesta estática, página renderizada y petición JSON interna son formas observables de entrega. No son concesiones equivalentes ni contratos de datos documentados de Instagram. La decisión entre renderizado y respuesta ayuda a identificar lo recibido en una comprobación permitida por separado; no autoriza repetir un punto interno. Un muro de inicio, acceso denegado o requisito de API incumplido exige detener esa ruta y resolver el alcance.
Preguntas frecuentes
¿La contraseña del cliente sustituye App Review?
No. Tener contraseña, nivel de acceso de aplicación y permisos de API son controles diferentes. El flujo admitido debe establecer activos permitidos sin compartir contraseñas ni almacenamiento del navegador con el operador.
¿Todo objeto multimedia completo incluye una URL descargable?
No. Las omisiones documentadas de media_url dependen del contenido y ajustes del propietario. Conserva identificador y ausencia del campo sin inventar URL ni afirmar eliminación.
¿Qué ocurre con una integración existente de Instagram Login?
Una nueva configuración recomendada no basta para sustituir clases de token en código activo. Meta ofrece una migración; compara funciones, correspondencia de permisos y selección de activos antes de modificarla.
Fuentes
- Descripción de Instagram Platform
- Unified Login y comparación
- Permisos de Unified Login
- Elegibilidad y diagnóstico
- Instagram Login
- Guía de Business Discovery
- Referencia de Business Discovery
- Instagram oEmbed
- Condiciones de Meta Platform
- Coherencia de automatización de BotBrowser
Conclusión práctica
Define cuenta, finalidad y campos antes de seleccionar configuración y punto de acceso. Confirma activos y permisos concedidos con una petición mínima permitida antes de planificar la recopilación. Si el producto no cubre el conjunto requerido, reduce el requisito o elige otra fuente autorizada; añadir sesiones no completa el contrato que falta.
Este artículo forma parte de la guía: Primeros pasos con automatización de navegador: mapa inicial
Artículos Relacionados
Scraping con Playwright: navegador y perfil
Primeros pasosScraping legal y términos: qué debe decidir un equipo primero
Primeros pasosTwitter scraping: ventanas de API y límites del navegador
Primeros pasosWeb crawler vs web scraper: resultados y fallos
Primeros pasosNavegador para web scraping: ¿qué tipo necesitas?
Primeros pasosQué es un rastreador web: cinco etapas del rastreo
Ejecuta la misma comprobación en BotBrowser
Carga un perfil, mantén dentro del navegador las señales que acabas de leer y confirma el resultado en tu propia máquina antes del despliegue.