User Guide

For now, this is X only. I want to add Instagram later; follow on Twitter for updates. Your X data is YOURS and it’s FREE—you just have to ask X for it.

Getting Your Data

Go to Profile > More > Settings and Privacy > Download archive.
X will acknowledge the request and send you a "READY" message in a day or two.
When you have it, unzip the file and look in the Data directory to find following.js and follower.js.

You might think these files contain useful info like usernames, but no such luck. While waiting, explore the Demo Data to understand how you can best use yours. The real system provides more detail than the simplified demo, including profile links and websites.

Analyzing Your Network

Ready? Go to GrabYourDataNow.com and follow these steps:

Press the Start button.
Press the Try button.
Upload your follower and following files. Ensure you put the right file in the right box, though the system will spot errors if you mix them up.
Analyze your counts:
- Mutuals: People you follow who follow you back. These are absolute legends for collabs and advice.
- Idols: People you follow who don’t follow you back.
- Fans: People who follow you, but you do not follow back.
Download the ID lists.

Getting Full Profile Data

If you like what you see, Get Full Profile Data
Pick one of your ID files, Mutuals is the most useful.
System will work out how much it will cost. We have to pay API fees
Purchases are handled via Buy Me A Coffee or Bitcoin.

Once you purchase, I buy credits from X to cover the data costs. This is currently a manual process; I send keys daily, but sometimes life is busy, so allow two working days before chasing. Best way to reach me is Twitter, (follow me first, and for belt and braces, @me as well as DM), and include the email or Twitter you gave with your order.

IMPORTANT: Keep your key! It opens several features. Put your CSV file somewhere safe and only work with copies of that file.

Using the Additional Tools

All tools are located on the GrabYourDataNow.com front page. Use your ORIGINAL CSV data download for these.

Infer Country

This tool identifies where your mutuals are based using location fields and profile text (clues like cities, countries, and flags). It understands language variations, like "Brasil" being Brazil. It adds a new column to your data to help you scan for relevant local contacts.

Create Categories

Create categories (e.g., "Musician") and search terms (e.g., "Guitarist", "Drummer") to help organize and sort your mutuals. This is perfect for sorting by category and country to find exactly who you need.

TIP: Save your Categories and Terms for future use. Just create a Categories document. You can expand terms as needed, for example later deciding that Flutes matter, and adding Flute and Flautist to your Musicians.

TIP: You can create multiple Categories and their terms for sophisticated searches, though normally not needed unless you have thousands of Mutuals.

Tidy Up

This tool converts your raw CSV into a nicely formatted Excel file. It improves the column order, adds word wrap for bios, and duplicates profiles that fall into multiple countries or categories so they show up correctly when sorting.

Update Your Mutuals

When you want to update your list later, use this tool to compare your new archive with your old one. It identifies new mutuals and those you've lost, allowing you to request data only for the new ones—saving you money.

Purge Audit

When X does a purge of "bots and inauthentic accounts" it removes them from your followers list. But, is it ALSO removing real people? This allows you to see which IDs have been removed. You can them drop them into an existing profiles sheet and see who vanished, and were they real, or not.

Appendix: Huge Networks

If you have 4,000+ mutuals, contact us for a quote. This is partly because yes, you can have a volume discount, but also because we need to break it down into multiple files and keys, on account of X's API rate limiting.