honesthook

Mastodon API

Mastodon API for public profile data

One endpoint for public Mastodon profiles on any instance — followers, following, post count. The handle is always user@instance, because Mastodon is federated. Same key and same response shape as nine other networks.

Get a free key — 1,000 credits a month, no card

or get a key with just your email

Free, no card. One key per address — we store your email to attach the key to it and to warn you if something breaks.

One call. Real response.

curl -H "Authorization: Bearer $HH_KEY" \
  "https://honesthook.com/api/v1/mastodon/profile?handle=Gargron@mastodon.social"
{
  "success": true,
  "platform": "mastodon",
  "endpoint": "mastodon/profile",
  "data": {
    "author": {
      "id": "https://mastodon.social/users/Gargron",
      "handle": "Gargron@mastodon.social",
      "name": "Eugen Rochko",
      "followers": 382854,
      "following": 743,
      "posts_count": 82332,
      "verified": null,
      "is_private": false
    }
  },
  "error": null,
  "cached": false
}

Recorded response, captured 27 Sep 2026. A live call returns the value at the moment you ask. The same envelope comes back from every other platform — only platform and endpoint change.

What this endpoint does not return.

A field we cannot read comes back null, never 0. A zero would be a claim about the account; null is a fact about our collection.

The part you are handing over.

The request goes to the account's origin instance, which is the authoritative one, and every instance runs its own version of the software. Keeping that working across thousands of servers is the part you are handing over.

Pricing

1,000 credits a month, free, renewing — no card. After that, US$ 9 per month for 5,000 credits. A profile call costs 1 credit, and a call that finds nothing costs nothing.

The free tier needs no account — the form at the top of this page is all of it. Signing in is for paying, and for seeing what a key has left. Paid plans renew until cancelled and a charge can be refunded in full within 7 days: terms · privacy.

Back to the free key ↑