Turn DEV.to follower data into clean reports with Python

A free afternoon led one developer to build a lightweight Python tool that turns raw follower data into structured reports. After noticing how quickly DEV.to audiences grow but struggling to review followers effectively, they created devto-followers2md, an open-source utility that exports follower details into clean Markdown, CSV, or JSON files.

The project started as a weekend challenge when the developer had extra time between classes. While browsing DEV.to during a free period, they realized the platform lacks an intuitive way to view or export follower lists in anything but a visual grid of profile pictures and usernames. Frustration with the default dashboard inspired a practical solution—one that could benefit thousands of writers and creators across the platform.

From idea to open-source tool in under 300 lines

The developer built devto-followers2md as a compact Python script under 300 lines, balancing brevity with functionality. Each line was carefully crafted to handle API calls, rate limiting, data transformation, and output formatting without unnecessary complexity. Behind the concise codebase lay hours of debugging, linting, and architectural decisions aimed at ensuring both usability and reliability.

The tool’s core purpose is simple: retrieve follower data from the DEV.to API and present it in formats that are easier to analyze than raw JSON. Whether you need a quick visual summary or a full dataset for tracking growth, devto-followers2md delivers both in one execution.

Multi-format exports with built-in safety and clarity

One of the tool’s standout features is its support for multiple export types. Users can generate:

• A clean Markdown report with formatted tables, user bios, and join dates
• A complete CSV file containing every field returned by the API
• A structured JSON file ideal for automation or further processing

Beyond versatility, the script emphasizes security and clarity. It prompts for the DEV.to API Key using Python’s getpass module, ensuring the key never appears in terminal history. A prominent warning in the output reminds users that API keys act like passwords and should be handled with care.

The tool also includes smart rate limiting to stay within DEV.to’s API thresholds. It enforces a one-second delay between requests as a baseline. If the server responds with a 429 Too Many Requests status, the script reads the Retry-After header to determine the appropriate pause, preventing IP bans and unnecessary delays. A custom user-agent header ensures requests are recognized by the API.

Designed for accessibility and flexibility

The developer prioritized usability for users who may not be comfortable with command-line tools. devto-followers2md guides users through setup with clear instructions in the README, including steps to generate a DEV.to API Key. The script walks you through choosing save locations for each file type, reducing friction for first-time users.

The Markdown output is intentionally beautiful yet concise, combining key details like username, real name, location, join date, and bio into a readable format. For deeper analysis, the CSV and JSON exports include every field returned from the API, from user IDs to timestamps.

This dual approach lets creators choose between a polished overview and a full audit trail of their follower base—without compromise.

Looking ahead: automation beyond followers

While devto-followers2md currently focuses on followers, its architecture makes it adaptable for other DEV.to analytics. The modular design could be extended to track engagement, trending posts, or comment threads with minimal changes.

For content creators who value clarity over clutter, this lightweight Python tool offers a reliable way to own and analyze their audience data. No complex setup, no hidden APIs—just a clean report generated in minutes.

As DEV.to continues to evolve, tools like this one remind us that even simple challenges can spark meaningful solutions—one line of code at a time.