josephrocca / public-mastodon-data.js

Simple JS functions for interacting with the public (i.e. no Auth) Mastodon data APIs

public-mastodon-data.js

Simple JS functions for interacting with the public Mastodon data APIs. No API key is needed to use these functions - just import the module, and call the functions like this:

import * as m from "https://cdn.jsdelivr.net/gh/josephrocca/public-mastodon-data.js@0.0.5/mod.js";

// see mod.js for all available parameters

await m.getPostsByUser({userHandle:"[e-mail]"});
await m.getFollowersOfUser({userHandle:"[e-mail]"}); // users that follow this user
await m.getFolloweesOfUser({userHandle:"[e-mail]"); // users that this user follows
await m.getTimelinePosts({instanceDomain:"mastodon.social"});
await m.getTimelinePostsByTag({instanceDomain:"mastodon.social", tag:"cat"});
await m.getUsersWhoFavoritedPost({instanceDomain:"mastodon.social", postId:"110697430691266528"});
await m.getUsersWhoBoostedPost({instanceDomain:"mastodon.social", postId:"110697430691266528"});
await m.getParentsAndChildrenOfPost({instanceDomain:"mastodon.social", postId:"110697449558194709"});
await m.getPost({instanceDomain:"mastodon.social", postId:"110697430691266528"});
await m.getUsersKnownToInstance({instanceDomain:"mastodon.social"});

Note:

• userHandle can be of the form [e-mail] or @[e-mail]
• all functions return a maximum 200 items by default, and you can increase that with the maxItems parameter

Demos:

• See a breakdown of your followers by Mastodon instance/server: https://josephrocca.github.io/public-mastodon-data.js/demos/followers-by-instance.html - uses Chart.js.

followers-by-instance-demo.mp4