gallery-dlでInstagramを使う

確認したい種類のURLを最初に決めます。通常のアドレスバーからコピーした公開投稿、プロフィール、メディアURLを使い、短縮URL、追跡パラメーター、モバイル転送、非公開メッセージ内のリンクは最初の診断では避けます。

最初のコマンドは通常シミュレーションにします。メディアを書き込まずにインストール、URL認識、アクセス、保存対象を分けて確認できます。シェルが記号を解釈しないようURLは引用符で囲みます。

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/"

upstreamの対応サイト一覧にはInstagramが掲載され、該当する認証方法としてCookieが示されています。これは計画用の参照であり、すべてのページ、アカウント、地域、URL形式が動作する保証ではありません。実際の判定は、インストール済みのバージョンと正確なURLで行います。

単一の公開投稿は小さく診断できる良い出発点です。プロフィール、リール、ストーリーズ、保存済み領域などは有効なセッションや別のアクセス条件を必要とする場合があるため、対象URLそのものをシミュレーションします。

匿名アクセスが拒否されたら、自分で管理するブラウザープロファイルで通常どおりログインし、同じプロファイルで対象ページを開けることを確認します。その後、gallery-dlにローカルプロファイルを指定します。生のCookie値をサイトや公開スレッドへ貼り付ける必要はありません。

Cookieデータベースがロックされている場合はブラウザーを完全に終了し、正しいプロファイルを選びます。期限切れセッション、追加認証、非公開アカウント、地域差、リクエスト規則の変更は別の原因として残ります。

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/"

シミュレーションが成功しても、最初の実行は小さくします。プロフィールやコレクションには --range を使い、予測しやすい保存先を選び、最初のパスを確認します。動画、重複、意図しない範囲がないかを保存量が増える前に確認できます。

定期実行には安定したローカルパスの --download-archive を追加します。成功したエクストラクターIDを記録して後の実行で同じ項目をスキップしますが、メディアのバックアップではありません。

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/"

試行中の値は見やすく削除しやすいコマンドラインに置きます。保存先、ファイル名、アーカイブ、Cookieの選択、待機時間などは、範囲を絞ったコマンドが動作してから設定ファイルへ移します。

設定は一致するすべてのリクエストへ影響します。コピーしたフィルターが別のメタデータでは何も選ばないこともあるため、-Kでフィールドを確認し、結果が違うときは --config-ignore で比較します。

{
  "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-status

Instagramのエラーを別のフラグ不足と決めつけないでください。まず通常のブラウザーで正確なURLを確認し、設定を無視したクリーンなシミュレーションを実行します。成功する場合は、設定、フィルター、アーカイブ、ブラウザープロファイルを一つずつ確認します。

ロックされたCookieとレート制限は別の問題です。制限には時間と少ないリクエストが必要で、並列リトライでは解決しません。空の結果はURL形式、非公開状態、フィルター、または既存アーカイブが原因の可能性があります。

gallery-dlはローカルのダウンローダーであり、利用許可を与える仕組みではありません。アクセスと利用の権利があるメディアだけを扱い、プライバシー、著作権、プラットフォーム規約、アカウント権限、レート制限を守ってください。技術的に見えることは再公開の許可ではありません。

Instagramのサイトやリクエスト規則が変わると、エクストラクターの動作も変わります。このページでは2026年8月6日に公式PyPIメタデータとupstreamのリリースファイルを確認し、gallery-dl 1.32.9を検証しました。動作が変わったら公式情報とインストール済みバージョンを再確認してください。

• 対応能力は公式upstream一覧を参照する
• 最初は公開・小範囲・シミュレーションにする
• Cookie、トークン、非公開アーカイブ、未加工ログを共有しない
• 生成コマンドを実行前に範囲、保存先、権限まで確認する