← Documentation Home 🚀 Try the App

How to Download Your Instagram Data as JSON

This complete guide shows you how to get your Instagram data in the correct format for Instagram Unfollow Tracker. The most important step: choose JSON format, not HTML.

Quick Steps

  1. Go to Meta Accounts Center: Visit https://accountscenter.instagram.com/
  2. Log in with your Instagram credentials
  3. Navigate to “Your information and permissions” in the left sidebar
  4. Click “Download your information”
  5. Configure your download:
    • Select “Some of your information” (not “All of your information”)
    • Choose “Followers and Following” section only
    • Select “JSON” format ← Critical step!
    • Set date range to “All time”
  6. Submit the request and wait for Instagram to prepare your data (usually 5-30 minutes)
  7. Download the ZIP file when you receive the email notification
  8. Upload the ZIP to Instagram Unfollow Tracker using the upload button

JSON vs HTML: Why Format Matters

This is the #1 cause of upload errors — 74% of failed uploads are caused by choosing the wrong format.

Comparison Table

Feature JSON Format ✅ HTML Format ❌
Works with tracker Yes No
File contents .json files with structured data .html files for browser viewing
Data structure Machine-readable arrays and objects Human-readable web pages
File size Smaller (1-5 MB typical) Larger (includes styling/markup)
Processing Instant parsing Cannot be parsed by the tracker

How to Tell Which Format You Have

JSON format — Inside the ZIP you’ll see files like:

connections/followers_and_following/following.json
connections/followers_and_following/followers_1.json

HTML format — Inside the ZIP you’ll see files like:

connections/followers_and_following/following.html
connections/followers_and_following/followers_1.html

Already downloaded HTML? You need to re-request your data. Go back to Meta Accounts Center, select JSON format, and submit a new request. The old HTML export won’t work.


Detailed Instructions

Step 1: Access Meta Accounts Center

Step 2: Navigate to Data Download

Step 3: Select Information Type

Step 4: Choose Data Section

Step 5: Select File Format — JSON

This is the most critical step. Select JSON format.

Step 6: Set Date Range

Step 7: Submit Request

Step 8: Download and Upload


File Structure Inside the ZIP

The Instagram data export ZIP contains a specific folder structure. Instagram Unfollow Tracker looks for files at these paths:

your-instagram-export.zip
└── connections/
    └── followers_and_following/
        ├── following.json          ← Who you follow
        ├── followers_1.json        ← Your followers (part 1)
        ├── followers_2.json        ← Your followers (part 2, if many)
        ├── followers_3.json        ← (additional parts as needed)
        ├── close_friends.json      ← Close friends list (optional)
        ├── pending_follow_requests.json  ← Pending requests (optional)
        ├── recently_unfollowed_profiles.json  ← Recent unfollows (optional)
        └── restricted_profiles.json     ← Restricted accounts (optional)

What Each File Contains

following.json — List of accounts you follow:

{
  "relationships_following": [
    {
      "title": "",
      "media_list_data": [],
      "string_list_data": [
        {
          "href": "https://www.instagram.com/username",
          "value": "username",
          "timestamp": 1704067200
        }
      ]
    }
  ]
}

followers_1.json — Your followers list (same structure, key is "relationships_followers").

The tracker reads these JSON arrays, extracts usernames and timestamps, and cross-references them to identify:

If Your Structure Differs

If your archive has a different folder structure, the tracker will try to locate files by name anywhere in the ZIP. You can also use the sample data demo to test the app.


Common Errors and Solutions

“Wrong Format: HTML” Error

Problem: You downloaded your data in HTML format instead of JSON. Solution: Go back to Meta Accounts Center → Download your information → Select JSON format → Submit a new request. You cannot convert HTML exports to JSON.

“No Data Found” Error

Problem: The ZIP doesn’t contain follower/following data files. Solutions:

  1. Make sure you selected “Followers and Following” when configuring the export
  2. Check that you selected “Some of your information” (not “All”) and picked the right section
  3. Verify the ZIP contains connections/followers_and_following/ folder

“Not an Instagram Export” Error

Problem: The uploaded file isn’t from Instagram’s official data export. Solution: Use the Meta Accounts Center to request your data. Don’t upload random ZIP files or exports from third-party apps.

File Size Expectations

What You Selected Expected Size Processing Time
Followers and Following only 1-5 MB Under 5 seconds
All data (everything) 50-500+ MB 10-60 seconds

Processing Time by Account Size

Account Size Filter Speed Search Speed
Under 1,000 followers < 1ms < 1ms
1,000-10,000 followers ~2ms < 1ms
10,000-100,000 followers ~3ms ~1ms
100,000-1,000,000+ followers ~5ms ~2ms

Privacy and Security

Your Instagram data export contains personal information. Here’s how we handle it:

Keep your ZIP file secure and don’t share it with others. Delete it after analysis if you prefer.


Ready to Analyze?

  1. Already have your JSON ZIP?Upload it now
  2. Need help downloading?Follow our step-by-step wizard
  3. Want to try first?Load sample data