Ce guide explique comment choisir une URL Instagram canonique, simuler l’extraction, utiliser une session de navigateur que vous contrôlez, limiter le premier téléchargement, protéger les tâches répétées avec une archive et distinguer les problèmes d’accès des erreurs de configuration.
Commencez par une publication, un profil ou une URL de médias Instagram publique et ajoutez --simulate. Si l’extracteur demande une authentification, connectez-vous normalement dans un profil de navigateur que vous contrôlez et utilisez --cookies-from-browser. Après un petit test réussi, ajoutez une archive stable et ne gardez dans la configuration que les options vérifiées.
Une tâche gallery-dl pour Instagram commence par le type exact d’URL à examiner. Utilisez une publication, un profil ou une page de médias publique copiée depuis la barre d’adresse normale. Évitez les liens raccourcis, les redirections mobiles, les paramètres de suivi et les liens de partage tant que la page canonique n’a pas été confirmée dans votre navigateur.
La première commande devrait être une simulation. Elle permet à l’extracteur installé d’identifier l’URL et d’afficher les fichiers sélectionnés sans écrire de médias. Vous séparez ainsi installation, reconnaissance de l’URL, accès et destination avant qu’un gros téléchargement ne complique le diagnostic. Entourez l’URL de guillemets pour protéger les caractères spéciaux du shell.
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 et USERNAME sont des exemples. Utilisez une URL et un contenu auxquels vous êtes autorisé à accéder, puis inspectez la simulation avant de retirer --simulate.
La liste upstream des sites pris en charge inclut Instagram et indique Cookies pour les capacités d’authentification affichées. Il s’agit d’un repère de planification, pas d’une garantie pour chaque page, compte, région ou variante d’URL. La version installée et l’URL exacte restent la preuve exécutable.
Séparez le type de page du périmètre de médias recherché. Une publication publique est un bon premier test. Un profil, une page de reels, les stories, une collection personnalisée ou une autre surface connectée peut demander une session valide et produire des métadonnées ou des règles d’accès différentes.
Une seule publication publique fournit le diagnostic le plus petit. Confirmez l’extracteur, les médias choisis, le nom du fichier et le dossier avant de tester un compte complet.
Une URL de profil peut sélectionner de nombreux éléments et demander une authentification. Commencez par une petite plage au lieu de parcourir tout le compte.
Ces zones dépendent davantage de la session, de son expiration, de la confidentialité et des changements de plateforme. Testez l’URL exacte et la documentation upstream plutôt que d’inférer le support depuis une autre page.
| URL ou objectif | Premier test | Note d’authentification |
|---|---|---|
| Une publication publique | --simulate URL | Diagnostic anonyme souvent le plus clair |
| Profil ou page de médias | --simulate --range 1-10 URL | Cookies parfois nécessaires ; vérifier le périmètre |
| Reels ou stories | Simuler l’URL exacte | Session et disponibilité peuvent varier |
| Métadonnées ou filtres | -K URL | Confirmer les champs avant de créer un filtre |
Lorsque Instagram refuse une requête anonyme, connectez-vous normalement dans un profil de navigateur que vous contrôlez. Vérifiez que la cible exacte s’ouvre dans ce profil, puis indiquez ce profil local à gallery-dl. La commande lit le stockage local des cookies ; il n’est pas nécessaire de coller des valeurs brutes dans gallery-dl.wiki ou dans un forum.
Fermez complètement le navigateur si sa base de cookies est verrouillée. Choisissez le profil qui contient la session active et rappelez-vous que les cookies ne donnent pas des droits supplémentaires. Session expirée, activité suspecte, compte privé, comportement régional et nouvelles règles de requête peuvent encore bloquer l’extraction.
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/"Ne publiez jamais une base de cookies, un chemin de profil, un identifiant de session ou des journaux non nettoyés. Masquez les noms locaux et les URL privées avant de demander de l’aide.
Après une simulation réussie, gardez la première exécution réelle petite. Utilisez --range pour un profil ou une collection, choisissez un dossier racine prévisible et examinez les premières sorties. Vous verrez ainsi si l’extracteur inclut des vidéos, des médias répétés ou une portée différente de celle prévue.
Pour une tâche récurrente, ajoutez --download-archive avec un chemin local stable. L’archive mémorise les identifiants d’extracteur terminés et ignore les éléments correspondants lors des exécutions suivantes, même si les noms changent. Elle protège contre les doublons, mais ne remplace pas une sauvegarde des médias.
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/"| Objectif | Option | Pourquoi |
|---|---|---|
| Éviter un premier lot trop grand | --range 1-10 | Facilite la vérification des chemins |
| Choisir un dossier racine | --destination PATH | Conserve une destination prévisible |
| Éviter les téléchargements répétés | --download-archive FILE | Mémorise les identifiants terminés |
| Vérifier les champs de nom | -K URL | Montre les métadonnées avant les filtres |
| Isoler la configuration | --config-ignore | Teste sans valeurs chargées |
Gardez les valeurs expérimentales dans la ligne de commande : elles sont visibles et faciles à retirer. Ajoutez à la configuration seulement les choix stables, comme le dossier, les noms, l’archive, les cookies et les délais, après une exécution limitée réussie.
Une configuration agit sur chaque requête correspondante. Un filtre ou un modèle de nom copié peut ne rien sélectionner si l’extracteur expose d’autres métadonnées. Utilisez -K, validez le JSON et comparez avec --config-ignore quand le résultat ne correspond plus à la commande 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-statusUn exemple public ne doit contenir ni cookies, ni mots de passe, ni jetons, ni URL privées, ni chemins personnels. Utilisez des paramètres fictifs et relisez chaque option.
Ne supposez pas que chaque erreur Instagram vient d’une option manquante. Comparez d’abord l’URL exacte dans un navigateur normal, puis lancez une simulation propre avec la configuration ignorée. Si la requête propre fonctionne mais que la commande habituelle échoue, examinez configuration, filtres, archive et profil de navigateur un par un.
Une base de cookies verrouillée ou expirée est différente d’une limite de requêtes. Une limite demande du temps et moins de répétitions, pas une boucle parallèle. Un résultat vide peut venir de la forme de l’URL, d’un contenu indisponible, d’un filtre trop strict ou d’une archive qui contient déjà l’élément.
| Symptôme | Première vérification | Étape sûre |
|---|---|---|
| URL non prise en charge ou résultat vide | Copier l’URL canonique et lancer -E ou --simulate | Tester une publication publique |
| Cookies demandés | Ouvrir la cible dans le profil choisi | Rafraîchir la session et fermer le navigateur |
| Activité suspecte ou HTTP 429 | Arrêter les répétitions et vérifier le rythme | Attendre, réduire le périmètre et consulter upstream |
| Tout est ignoré | Vérifier le chemin de l’archive | Utiliser une archive de diagnostic séparée |
| La configuration change le résultat | Lancer --config-ignore | Retirer une clé suspecte et retester |
gallery-dl est un téléchargeur local, pas un système d’autorisation. Téléchargez et réutilisez seulement des médias auxquels vous êtes autorisé à accéder et à faire circuler. Respectez vie privée, droit d’auteur, conditions de la plateforme, droits du compte et limites de requêtes. Une URL techniquement accessible n’est pas une licence de republication.
Le comportement de l’extracteur peut changer si Instagram modifie son site ou ses règles. Le 6 août 2026, ce site a vérifié les métadonnées PyPI et les fichiers upstream officiels ; la version vérifiée était gallery-dl 1.32.9. Revérifiez la version et `gallery-dl --help` lorsqu’une commande cesse de fonctionner.
La liste upstream actuelle inclut Instagram et affiche Cookies pour les capacités d’authentification indiquées. La version installée, l’URL, le compte et le comportement de la plateforme déterminent encore le résultat ; simulez l’URL exacte.
Connectez-vous normalement dans un profil de navigateur que vous contrôlez, vérifiez la page et utilisez --cookies-from-browser. Gardez base de cookies, session, chemins et journaux privés.
Une URL de profil peut sélectionner de nombreux éléments et demander une authentification. Commencez par --simulate et un --range réduit, examinez les chemins et ajoutez une archive stable avant d’élargir.
Vérifiez URL canonique, extracteur, session, filtres, configuration et archive. Comparez avec gallery-dl --config-ignore --simulate et réintroduisez une option à la fois.
Utilisez --download-archive avec un chemin local stable. L’archive conserve les identifiants réussis et ignore les éléments correspondants ; elle ne sauvegarde pas les médias.
Arrêtez les répétitions, réduisez la portée, attendez et vérifiez la session normale. N’utilisez pas de boucles parallèles et consultez la version et les indications upstream si le problème persiste.
La version vérifiée le 6 août 2026 est gallery-dl 1.32.9 selon les métadonnées PyPI et les fichiers upstream officiels. Revérifiez la version avant de compter sur un comportement sensible à l’extracteur.