Esta guía explica cómo elegir una URL canónica de Instagram, simular la extracción, usar una sesión del navegador bajo tu control, limitar la primera tanda, proteger los trabajos repetidos con un archivo y separar los problemas de acceso de los errores de configuración.
Empieza con una publicación, un perfil o una URL de medios pública y añade --simulate. Si el extractor necesita autenticación, inicia sesión normalmente en un perfil del navegador que controles y usa --cookies-from-browser. Después de una prueba pequeña, añade un archivo de archivo estable y pasa solo las opciones revisadas a tu configuración.
Un trabajo de gallery-dl para Instagram comienza con el tipo exacto de URL que quieres revisar. Usa una publicación, un perfil o una página de medios pública copiada de la barra de direcciones normal. Evita enlaces acortados, redirecciones móviles, parámetros de seguimiento y envoltorios de compartir hasta confirmar la página canónica en tu propio navegador.
El primer comando debería ser una simulación. Permite que el extractor instalado identifique la URL y muestre los archivos que seleccionaría sin escribir medios. Así puedes separar instalación, reconocimiento de URL, acceso y destino antes de que una descarga grande complique el diagnóstico. Pon la URL entre comillas para que los caracteres especiales no los interprete el terminal.
gallery-dl --simulate "https://www.instagram.com/p/POST_ID/"gallery-dl --simulate "https://www.instagram.com/USERNAME/"gallery-dl -K "https://www.instagram.com/p/POST_ID/"POST_ID y USERNAME son ejemplos. Usa una URL y contenido que tengas permiso para consultar y revisa la salida simulada antes de quitar --simulate.
La lista upstream de sitios compatibles incluye Instagram y muestra Cookies como método de autenticación para las capacidades indicadas. Es una referencia para planificar, no una promesa de que todas las páginas, cuentas, regiones o variantes de URL funcionarán hoy. La versión instalada y la URL exacta siguen siendo la evidencia ejecutable.
Separa el tipo de página del alcance de medios que quieres. Una publicación pública es una buena primera prueba. Un perfil, una página de reels, stories, una colección guardada u otra superficie personalizada puede exigir una sesión válida y exponer metadatos o reglas de acceso diferentes.
Usa una publicación pública cuando necesites el diagnóstico más pequeño. Confirma el extractor, los medios seleccionados, el nombre del archivo y la carpeta antes de probar una URL de cuenta completa.
Una URL de perfil puede seleccionar muchos elementos y requerir autenticación. Empieza con un rango pequeño en vez de recorrer toda la cuenta durante la primera prueba.
Estas zonas dependen más de la sesión, la caducidad, la privacidad y los cambios de la plataforma. Simula la URL exacta y comprueba la referencia upstream en lugar de inferir soporte desde otra página.
| URL u objetivo | Primera prueba | Nota de autenticación |
|---|---|---|
| Una publicación pública | --simulate URL | Suele ser el diagnóstico anónimo más claro |
| Perfil o página de medios | --simulate --range 1-10 URL | Puede requerir cookies; revisa el alcance |
| Reels o stories | Simula la URL exacta | La sesión y la disponibilidad pueden variar |
| Metadatos o filtros | -K URL | Confirma los campos antes de crear filtros |
Cuando Instagram rechace una petición anónima, inicia sesión mediante el sitio normal en un perfil del navegador que controles. Comprueba que allí abre el objetivo exacto y apunta gallery-dl a ese perfil local. El comando lee el almacenamiento local de cookies; no hace falta pegar valores de cookies en gallery-dl.wiki ni en un foro público.
Cierra el navegador por completo si su base de datos está bloqueada. Selecciona el perfil que contiene la sesión activa y recuerda que las cookies no conceden permisos que tu cuenta no tenga. Las sesiones caducadas, los avisos de actividad sospechosa, las cuentas privadas y las reglas de petición cambiantes pueden seguir provocando errores.
gallery-dl --cookies-from-browser firefox --simulate "https://www.instagram.com/USERNAME/"gallery-dl --cookies-from-browser chrome --simulate "https://www.instagram.com/USERNAME/"gallery-dl --cookies-from-browser edge --simulate "https://www.instagram.com/USERNAME/"Nunca publiques bases de cookies, rutas de perfil, identificadores de sesión ni registros sin limpiar. Oculta nombres locales y URL privadas antes de pedir ayuda.
Después de una simulación correcta, mantén pequeña la primera ejecución real. Usa --range para un perfil o colección, elige una carpeta base predecible y revisa las primeras rutas. Así sabrás si el extractor incluye vídeos, medios repetidos o un alcance distinto del que querías antes de ocupar mucho espacio.
Para trabajos periódicos, añade --download-archive con una ruta local estable. El archivo registra identificadores de extractor completados y omite los mismos elementos en ejecuciones posteriores aunque cambien los nombres. Protege contra duplicados, pero no es una copia de seguridad de los medios.
gallery-dl --range "1-10" --destination "D:/Media/Instagram" "https://www.instagram.com/USERNAME/"gallery-dl --range "1-25" --download-archive "instagram.sqlite3" "https://www.instagram.com/USERNAME/"gallery-dl -K --simulate "https://www.instagram.com/p/POST_ID/"| Objetivo | Opción | Por qué importa |
|---|---|---|
| Evitar una primera ejecución grande | --range 1-10 | Facilita revisar acceso y rutas |
| Elegir la carpeta raíz | --destination PATH | Mantiene el trabajo bajo una ubicación clara |
| Evitar descargas repetidas | --download-archive FILE | Guarda identificadores completados |
| Revisar campos de nombres | -K URL | Muestra metadatos antes de filtrar |
| Aislar la configuración | --config-ignore | Prueba la URL sin valores cargados |
Mantén los valores experimentales en la línea de comandos porque son fáciles de ver y quitar. Pasa a la configuración solo las decisiones estables, como carpeta base, nombres, archivo de archivo, cookies y tiempos, después de que una ejecución limitada funcione.
Una configuración afecta a todas las peticiones coincidentes. Un filtro o una expresión de nombre copiada puede no encontrar nada si el extractor ofrece otros metadatos. Usa -K, valida el JSON y compara con --config-ignore cuando el resultado no coincide con el comando visible.
{
"extractor": {
"base-directory": "D:/Media/Instagram",
"archive": "D:/Media/Instagram/archive.sqlite3"
}
}gallery-dl --config-ignore --simulate "https://www.instagram.com/USERNAME/"gallery-dl --config-statusUna configuración pública no debe incluir cookies, contraseñas, tokens, URL privadas ni rutas personales del navegador. Usa marcadores y revisa cada opción antes de ejecutarla.
No interpretes cada error de Instagram como falta de una opción. Compara primero la URL exacta en un navegador normal y ejecuta una simulación limpia con la configuración ignorada. Si la petición limpia funciona y el comando normal falla, revisa configuración, filtros, archivo y perfil del navegador uno por uno.
Una base de cookies bloqueada o caducada no es lo mismo que un límite de peticiones. Ante un límite necesitas esperar y reducir solicitudes, no lanzar reintentos paralelos. Un resultado vacío puede deberse a una URL incorrecta, contenido no disponible, un filtro restrictivo o un archivo que ya contiene el elemento.
| Síntoma | Primera comprobación | Siguiente paso seguro |
|---|---|---|
| URL no compatible o resultado vacío | Copia la URL canónica y usa -E o --simulate | Prueba una publicación pública |
| Se necesitan cookies | Abre el objetivo en el perfil elegido | Actualiza la sesión y cierra el navegador |
| Actividad sospechosa o HTTP 429 | Detén reintentos y revisa el ritmo | Espera, reduce el alcance y consulta upstream |
| Todo aparece omitido | Revisa la ruta del archivo | Usa otro archivo solo para diagnosticar |
| La configuración cambia el resultado | Ejecuta --config-ignore | Quita una clave sospechosa y prueba de nuevo |
gallery-dl es un descargador local, no un sistema de permisos. Descarga y reutiliza solo medios que tengas derecho a consultar y copiar, respeta privacidad, copyright, condiciones de la plataforma, permisos de la cuenta y límites de solicitudes. Una URL técnicamente accesible no es una licencia para republicar contenido.
El comportamiento del extractor puede cambiar cuando Instagram modifica su sitio o sus reglas. Este sitio verificó los metadatos oficiales de PyPI y los archivos upstream el 6 de agosto de 2026; la versión comprobada fue gallery-dl 1.32.9. Vuelve a revisar la versión oficial y `gallery-dl --help` cuando cambie un comando.
La lista upstream actual incluye Instagram y muestra Cookies para las capacidades de autenticación indicadas. La versión instalada, la URL, la cuenta y el comportamiento actual de la plataforma siguen determinando el resultado; simula la URL exacta.
Inicia sesión normalmente en un perfil del navegador que controles, comprueba allí la página y usa --cookies-from-browser. Mantén privadas la base de cookies, la sesión, las rutas y los registros.
Una URL de perfil puede seleccionar muchos elementos y requerir autenticación. Empieza con --simulate y un --range pequeño, revisa las rutas y añade --download-archive antes de ampliar el trabajo.
Comprueba la URL canónica, el extractor, la sesión, los filtros, la configuración y el archivo. Compara el comando normal con gallery-dl --config-ignore --simulate y añade una opción cada vez.
Usa --download-archive con una ruta local estable. Guarda identificadores completados y omite elementos coincidentes; no es una copia de seguridad de los archivos.
Detén reintentos, reduce el alcance, espera y comprueba la sesión normal. No uses bucles paralelos ni intentes saltar un desafío; revisa la versión y la guía upstream si persiste.
La versión comprobada para esta página el 6 de agosto de 2026 es gallery-dl 1.32.9 según los metadatos oficiales de PyPI y los archivos upstream. Revisa de nuevo la versión antes de depender de un comportamiento sensible al extractor.