Volver al Centro de conocimiento
Primeros pasos

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

Documentación

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_discovery expone 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.

La elegibilidad distingue la cuenta profesional autorizada con instagram_basic, los campos restringidos de business_discovery y la visualización exclusiva de instagram_oembed; los requisitos no admitidos se detienen antes de elegir navegador.

Contenido

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 necesariosPosible ruta oficialRegla de elección
Perfil y contenido de la cuenta profesional conectadaUna configuración de Instagram API elegibleComprobar condición Business/Creator, activo compartido, permisos concedidos y campos del punto de acceso
Metadatos públicos de otra cuenta profesionalbusiness_discovery si la configuración elegida lo admiteComprobar 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_oembedUsar 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 seguidoresEstos productos no establecen una ruta generalDetener 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ónValor construidoConsecuencia
account_typeCreatorSe puede comprobar el requisito de cuenta profesional
relationshipEl cliente conecta su propia cuentaUtilizar su activo compartido, no la cuenta ajena del operador
purposeInformes para ese clienteEvaluar tratamiento y conservación permitidos para esa finalidad
requested_fieldsPerfil y publicaciones propias; estadísticas especificadas aparteRevisar cada punto de acceso y el permiso adicional de estadísticas
excluded_dataMétricas privadas de otras cuentasNo 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ónRequisitos de página y portfolioServidor y clase de token
Unified LoginNo requiere página de Facebook; sí portfolio empresarialgraph.facebook.com; Business Integration System User Access Token
Instagram LoginNo requiere página; el flujo de inicio no exige portfoliograph.instagram.com; Instagram User access token
Facebook LoginRequiere página de Facebook vinculada; portfolio según configuracióngraph.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_url por 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

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.

#Instagram Scraping#Instagram API#Browser Automation#recopilacion de datos

Este artículo forma parte de la guía: Primeros pasos con automatización de navegador: mapa inicial

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.