API de Mastodon

API de Mastodon para datos públicos de perfil

Un endpoint para perfiles públicos de Mastodon en cualquier instancia — seguidores, seguidos, número de publicaciones. El handle es siempre usuario@instancia, porque Mastodon está federado. La misma clave y la misma forma de respuesta que otras nueve redes.

Consigue una clave gratuita — 1000 créditos al mes, sin tarjeta

o consigue una clave solo con tu correo

Una llamada. Respuesta real.

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
}

Respuesta grabada, capturada el 27 Sep 2026. Una llamada en vivo devuelve el valor del momento en que preguntas. El mismo envoltorio vuelve de todas las demás plataformas — solo cambian platform y endpoint.

Lo que este endpoint no devuelve.

Ningún handle sin instancia. En una red federada @nombre por sí solo no identifica a nadie, así que un handle sin instancia se rechaza con 400 en lugar de adivinarse.
Ningún id numérico. El id es el uri de ActivityPub, porque el id numérico es local a un servidor — la misma cuenta tiene uno distinto en cada instancia.
Ninguna marca de verificado. Mastodon verifica enlaces, no identidades, así que verified es null en lugar de presentar una comprobación de enlace como una comprobación de identidad.

Un campo que no podemos leer vuelve como null, nunca como 0. Un cero sería una afirmación sobre la cuenta; null es un hecho sobre nuestra recolección.

La parte que nos estás delegando.

La petición va a la instancia de origen de la cuenta, que es la autoritativa, y cada instancia ejecuta su propia versión del software. Mantener eso funcionando a lo largo de miles de servidores es la parte que nos estás delegando.

Precios

1000 créditos al mes, gratis, renovables — sin tarjeta. Después de eso, US$ 9 per month por 5,000 créditos. Una llamada de perfil cuesta 1 crédito, y una llamada que no encuentra nada no cuesta nada.

Inicia sesión para comprar créditos Precios completos

El nivel gratuito no necesita cuenta — el formulario de arriba de esta página es todo. Iniciar sesión es para pagar, y para ver lo que le queda a una clave. Los planes de pago se renuevan hasta que se cancelan, y un cargo puede reembolsarse por completo dentro de 7 días: términos · privacidad.