What you get
A self-contained HTML report you can sort, filter and share, plus a CSV for spreadsheets and a JSON file. Everything is built in your browser from what X already shows you when you scroll.
- Engagement rate per post: likes, reposts, replies and quotes divided by views.
- A heatmap of average interactions by weekday and hour, in your local time, with your best slot highlighted.
- Top 10 posts as reading cards, and every post in a sortable table with filters such as "10k+ views" and "engagement over 2%".
- A share image with the headline numbers, and a CSV for your own analysis.
How to run it
Five steps, on a computer. The guided setup on the home page adapts them to your system and username.
Open a profile page on X
On a computer, log in to X and open x.com/yourname. If the page was already open, reload it right before pasting: the tool reads the list as X loads it.
Open the browser console
Press Cmd+Option+I on a Mac or F12 on Windows and Linux, then click the Console tab.
Copy the script
Use the copy button on this page. The script is plain text you can read; it lives at x-utils.com/dist/engagement-report.js.
Paste it in the console and press Enter
The first time, the browser asks you to type "allow pasting" first. Type it, press Enter, paste again.
Wait, then open your report
2 to 5 minutes for the last 300 posts. If X stops serving the timeline, the tool asks for the remaining pages directly and shows its progress. The report and a CSV land in your Downloads folder.
Why this is safe
The script runs inside the X tab where you are already logged in. It never asks for, reads or stores your password, cookies or keys.
There is no server behind this. The report and the spreadsheet are written straight into your Downloads folder.
No tool follows, unfollows, blocks, likes, posts or deletes anything. It scrolls and takes notes, like a very fast assistant looking at your screen.
The code is open, short, in plain JavaScript and published on GitHub. If you know a developer, ask them to look.
Questions
How is the engagement rate calculated?
Likes plus reposts plus replies plus quotes, divided by the post's views, per post. The headline figure is the median across posts, so one viral post does not distort it.
Why are replies not counted as posts?
On the Posts tab X hides replies, and so does the report. Open the profile's Replies tab and run the tool there to include them.
Why fewer posts than the profile counter says?
The counter counts replies and reposts too. The report says how many posts it collected and what it left out, and if X cut the timeline short it says that as well.
More answers in the help section.