Instaloader is an open-source Python tool designed to download pictures and videos, along with their captions and other metadata, from Instagram. It's a popular choice for data hoarders, researchers, and backup enthusiasts for automated archiving of public or private Instagram accounts and hashtags. The library is actively maintained, with its current version being 4.15.1, and releases occurring periodically to adapt to Instagram's changes.
pip install instaloaderVerified import paths — ran on the pinned version, not inferred.
This quickstart demonstrates how to instantiate Instaloader, optionally log in using environment variables (recommended for security and to handle private profiles/rate limits), and then download posts from a specified public profile. The login attempts to reuse a saved session file, falling back to a fresh login if no file is found.
Explicitly set `download_geotags=True` or `download_comments=True` when initializing Instaloader if you rely on this functionality.
Always use `--login` (or `L.login()` in Python) and ensure a session file is saved and reused. Wait for temporary bans to expire. Avoid concurrent operations. For updates, prefer `--fast-update` or `--latest-stamps`.
If a checkpoint error occurs, log in to the Instagram account manually via a web browser, complete any verification steps, and then retry Instaloader. Ensure session files are maintained (e.g., `L.save_session_to_file()`).
Ensure the logged-in Instagram account follows the private target profile. Use `L.login(username, password)` in your script or the `--login` flag with the CLI.
Open a web browser, log in to your Instagram account, complete the required security checkpoint (e.g., entering a code, confirming identity), then close the browser and retry running Instaloader. Ensure you have a saved session file, or use `L.save_session_to_file()` after a successful interactive login.
Delete your existing session file (usually `~/.config/instaloader/session-YOUR_USERNAME`) and perform a fresh login. Ensure you are using the latest version of Instaloader (`pip install --upgrade instaloader`).
Ensure you are logged in using `L.login()` or `--login`. If logged in, Instaloader will attempt to wait. For CLI, avoid frequent restarts and consider `--fast-update` for incremental downloads. If issues persist, wait a longer period before retrying.
This is a notice, not an error, and Instaloader should resume automatically after a delay. This message is more common for unauthenticated requests or when downloading large amounts of data. Ensure you are logged in for potentially higher rate limits.
No dependency data recorded yet.