Some code to explore servers on the Fediverse


browse  log 



You can also use your local clone with git send-email.

#Fediverse servers scan

This script uses the public APIs of Fediverse severs to make a list of active servers on the network containing:

  • the name of the server and the platform (Mastodon, Pleroma, Hubzilla...)
  • some information about its size and activity
  • the servers it federates with (if this information is available)


To use the script, run the gen_fediverse_data.py file. You will need to adapt it to your machine by setting num_processes if it has a lot of cores and you want to use more than 6 simultaneous processes. If you have fewer cores, the script will automatically adapt to your machine. Data is saved as a json-formatted lines in instances.txt.

#Supported platforms

The code should successfully fetch basic data for any server supporting the nodeinfo v2.0 format (via .well-known/nodeinfo)

Platform-specific data is then obtained via the respective APIs for the following platforms:

  • Friendica
  • Hubzilla
  • Mastodon
  • Misskey
  • PeerTube
  • Pixelfed
  • Pleroma

#Current limitations

  • Hubzilla and Misskey servers do not have a list of known federated peers.
  • Friendica, Hubzilla, and Misskey servers do not have recent activity information.