Tutoriales
Mastodon profile en JavaScript
Una llamada autenticada a /api/v1/mastodon/profile?handle=Gargron@mastodon.social, la respuesta que devolvió, y la línea que saca un campo de ella.
Lo que necesitas
Node 18 o posterior, donde fetch es global. Ningún paquete que instalar. El mismo código corre en un navegador, salvo que un navegador dejaría tu clave a la vista — llama a esto desde tu servidor.
La llamada
const url = "https://honesthook.com/api/v1/mastodon/profile?handle=Gargron@mastodon.social";
const response = await fetch(url, {
headers: { Authorization: `Bearer ${process.env.HH_KEY}` },
});
if (!response.ok) {
throw new Error(`HTTP ${response.status}`);
}
const envelope = await response.json();
console.log(envelope.success, envelope.platform, envelope.endpoint);
Lo que volvió
{
"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 registrada, capturada el 27 Sep 2026. Una llamada en vivo devuelve el valor del momento en que preguntas, no este.
Todos los campos de esa captura
| En JavaScript | Tipo en esta captura |
|---|
envelope.success | boolean |
envelope.platform | string |
envelope.endpoint | string |
envelope.data.author.id | string |
envelope.data.author.handle | string |
envelope.data.author.name | string |
envelope.data.author.followers | number |
envelope.data.author.following | number |
envelope.data.author.posts_count | number |
envelope.data.author.verified | null |
envelope.data.author.is_private | boolean |
envelope.error | null |
envelope.cached | boolean |
Un campo que no podemos leer vuelve null, nunca 0. Un cero sería una afirmación sobre la cuenta; null es un hecho sobre nuestra recolección. La lista completa de lo que esta ruta no devuelve está en mastodon-api/profile.
Leer un campo
console.log(envelope.data.author.followers);
envelope es el objeto del bloque de arriba. Deja la clave en el servidor: una clave enviada a un navegador es una clave que cualquiera puede leer.
Mastodon no es un sitio. Son miles de servidores que se ponen de acuerdo en un protocolo, y ese único hecho decide cómo llamas a este endpoint.
El handle tiene que llevar su instancia
@name por sí solo no identifica a nadie en una red federada — el mismo nombre local existe en cientos de servidores, y pertenece a personas distintas. Así que aquí el handle es siempre user@instance, y un handle sin instancia se rechaza con un 400 en lugar de adivinarse.
La misma lógica gobierna el id que recibes: es la URI de ActivityPub, no un número. Los ids numéricos son locales a un servidor, y la misma cuenta tiene uno distinto en cada instancia que la ha visto. Un número quedaría más limpio y estaría equivocado en el momento en que compararas dos instancias.
Qué estás llamando
Un GET autenticado a nuestro endpoint, con tu clave en una cabecera Authorization. La petición se enruta a la instancia de origen de la cuenta, que es la autoritativa. El handle del ejemplo es el que produjo la respuesta registrada más abajo — fíjate en la @ dentro de la cadena de consulta; ahí es legal y no necesita escaparse.
Antes de copiar el bloque
Guarda la clave en una variable de entorno — los tres ejemplos leen HH_KEY. Luego lee la lista de campos: Mastodon verifica enlaces, no identidades, así que el campo de verificado se queda en null en lugar de dar por identidad comprobada lo que es una comprobación de enlace.
El endpoint en sí
Parámetros, el formato del handle, lo que la ruta no devuelve y lo que cuesta una llamada: mastodon-api/profile.
La misma llamada en curl · Python.
← Tutoriales · mastodon-api · Precios