Skip to content
Back to Blog

APINovember 20, 20268 min read

Instaloader: what it does, where it stops and the alternatives

Instaloader is the go-to Python tool to download Instagram content. It is also the tool people outgrow when a script turns into a pipeline. What it does well, what it needs a login for and what to use instead.

Instaloader is an independent open source project, not affiliated with Instagram. Its own documentation ends with three words worth reading first: use at your own risk. Every fact below comes from that documentation, read in November 2026 (version 4.16).

What Instaloader does

Give it a profile name and it downloads the posts and the current profile picture, with a caption file and a JSON metadata file per post. Options add more:

  • --stories, --highlights: stories and highlights of the profile.
  • --reels, --igtv, --tagged: reels, IGTV videos and posts where the profile is tagged.
  • --comments, --geotags: comments of each post and the location with a Google Maps link.
  • #hashtag, %location, :feed, :saved: posts from a hashtag, a location, your feed or your saved posts.
Install and download a public profile
pip3 install instaloader
instaloader yourcompetitor

As a Python module

The same features are available in code, which is how most people use it in a project:

Python
import instaloader

L = instaloader.Instaloader()
profile = instaloader.Profile.from_username(L.context, "yourcompetitor")

print(profile.username, profile.followers, profile.biography, profile.external_url)

for post in profile.get_posts():
    print(post.shortcode, post.likes, post.date_utc)

Where Instaloader stops

A login for most useful data

The command line options page marks stories, highlights, comments, geotags, hashtags, locations, the feed and saved posts as requiring a login. Private profiles also need a login and you must follow the account. Profile.get_followers() exists in the module, but Instagram only shows followers lists to logged-in visitors, so it runs on your session.

That login is your own Instagram account. Instaloader supports the checkpoint challenge Instagram issues when it suspects unusual activity on an account: a sign that the account doing the work is the one taking the risk.

Rate limits and 429 errors

When Instagram answers 429 Too Many Requests, Instaloader waits until the temporary ban should be over and retries. The troubleshooting page adds two warnings. Restarting Instaloader often in a short time is prone to cause a 429. Servers on shared or cloud IP addresses may get significantly stricter limits for anonymous access. A script that works on a laptop can stall once it moves to a server.

No contact details

The Profile structure has a biography, an external URL, a business category, follower and following counts. It has no email and no phone field. For lead generation that is the missing column.

You maintain it

When Instagram changes, a new release follows. Version 4.16 fixed Profile.get_posts() when logged in and Profile.from_id(). Until you upgrade, your pipeline waits.

Instaloader alternatives

OptionBest forInstagram loginContact details
InstaloaderArchiving posts and media of a few profilesYes for most featuresNo
Official Instagram APIManaging your own professional accountAn access token from the account ownerNo, for other accounts
A data API (IGLeads)Lists of people behind an account, a hashtag or a postNo, an API keyPublic email and phone when shown

The official API

If the account is yours, the official API is the stable route: media, comments, insights and publishing, with a token you control. It only serves professional accounts. Getting the token is covered in the Instagram API key guide and what it returns in the Instagram API guide.

A data API for lead lists

If you used Instaloader to collect the followers of a competitor and then hunted for their emails, a data API does both in one call. The IGLeads API reads the public audience of an account, keeps the profiles that show a public email and returns them as rows. No Instagram account of yours is involved.

Python, the same job with an API key
import time
import requests

HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}
BASE_URL = "https://api.igleads.ai/v1"

job_id = requests.post(
    f"{BASE_URL}/leads/competitors",
    headers=HEADERS,
    json={"usernames": ["yourcompetitor"], "limit": 500},
).json()["jobId"]

while requests.get(f"{BASE_URL}/leads/jobs/{job_id}", headers=HEADERS).json()["job"]["status"] not in ("completed", "failed"):
    time.sleep(15)

for lead in requests.get(f"{BASE_URL}/leads/jobs/{job_id}/results", headers=HEADERS).json()["leads"]:
    print(lead["username"], lead["followers"], lead["email"])

API access comes with the Business ($199 a month) and Scale ($399 a month) plans. The Instagram API with Python guide compares the three approaches side by side.

Which one to pick

  • You archive posts of a few public profiles: Instaloader does it well, for free.
  • You manage your own business account: the official API.
  • You need people and their contact details: a data API, with no Instagram account at risk.

Frequently asked questions

Is Instaloader free?

Yes. Instaloader is open source under the MIT license and installs with pip3 install instaloader. It needs Python 3.10 or later. Version 4.16 came out on October 26, 2026.

Does Instaloader need an Instagram login?

For public posts and profile pictures, no. Its documentation marks stories, highlights, comments, geotags, hashtags, locations, the feed, saved posts and private profiles as requiring a login.

Why does Instaloader return 429 Too Many Requests?

Instagram temporarily refuses requests that come too fast. Instaloader waits and retries. Its documentation warns that restarting it often in a short time is prone to cause a 429. It adds that shared or cloud IP addresses can get much stricter limits when not logged in.

Can Instaloader get emails from Instagram profiles?

The Profile structure in its documentation has no email or phone field. It gives the biography, the external URL, the business category and follower counts. To get the public email shown on a profile, you need a tool that reads contact details.

Ready to extract Instagram leads?

See 25 leads from your own target free. Unlock them from $19, no subscription needed.

Free preview of 25 leads. No Instagram login, no card. View pricing