API de Mastodon
Consulta perfiles, publicaciones, hashtags, tendencias y cronologías públicas de Mastodon. Un handle completo conserva usuario e instancia para identificar correctamente la cuenta federada.
La visibilidad y el orden dependen de la instancia accesible; ninguna selección es un índice global del fediverso. Boosts y respuestas se mantienen separados de la publicación original.
Disponibilidad de la plataforma
- Salud 24 h
- Normal
Últimos 30 días
Funciones disponibles
Cada acción de Mastodon, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Leer publicaciones de una cuenta federadauser_posts | Lee publicaciones públicas del username o cuenta federada y conserva instancia, idioma, boosts y respuestas. | $1.39 por 1.000 solicitudes | Normal |
Consultar un perfil de Mastodonprofile | Resuelve username como handle corto o usuario@instancia y devuelve identidad y URL federadas. | $1.39 por 1.000 solicitudes | Normal |
Buscar publicaciones por hashtaghashtag | Consulta publicaciones de una etiqueta mediante hashtag, con instance opcional para elegir la instancia. | $1.39 por 1.000 solicitudes | Normal |
Explorar publicaciones en tendenciatrending | Obtiene una selección pública en tendencia sin parámetros de negocio. | $1.39 por 1.000 solicitudes | Normal |
Leer la cronología públicatimeline | Lee una cronología pública sin entradas adicionales y devuelve estados con instancia, autor e interacciones. | $1.39 por 1.000 solicitudes | Normal |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿Qué acepta cada acción de Mastodon?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
user_postsLeer publicaciones de una cuenta federada Lee publicaciones públicas del | username | instance | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 100 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · url · text · author_name · author_username · author_url · instance · like_count · reblog_count · comment_count · language · is_reblog · posted_at · platform · media_urls · hashtags |
profileConsultar un perfil de Mastodon Resuelve | username | instance | Entrega síncrona | — | $1.39 por 1.000 solicitudes | username · display_name · handle · instance · url · platform |
hashtagBuscar publicaciones por hashtag Consulta publicaciones de una etiqueta mediante | hashtag | instance | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 100 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · url · text · author_name · author_username · author_url · instance · like_count · reblog_count · comment_count · language · is_reblog · posted_at · platform · media_urls · hashtags |
trendingExplorar publicaciones en tendencia Obtiene una selección pública en tendencia sin parámetros de negocio. La posición y los contadores pertenecen a esa observación; no explican el algoritmo ni forman un ranking global del fediverso. | instance | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 100 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · url · text · author_name · author_username · author_url · instance · like_count · reblog_count · comment_count · language · is_reblog · posted_at · platform · media_urls · hashtags | |
timelineLeer la cronología pública Lee una cronología pública sin entradas adicionales y devuelve estados con instancia, autor e interacciones. No es un feed personal autenticado ni un archivo universal de Mastodon. | instance | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 100 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · url · text · author_name · author_username · author_url · instance · like_count · reblog_count · comment_count · language · is_reblog · posted_at · platform · media_urls · hashtags |
¿Qué significan los parámetros de Mastodon user_posts?
Lee publicaciones públicas del username o cuenta federada y conserva instancia, idioma, boosts y respuestas. No mezcla automáticamente cuentas homónimas ni garantiza el historial completo.
usernameObligatorio- Nombre de cuenta de Mastodon o cuenta completa en formato
user@instance. Puedes omitir el@inicial. Si solo envías el nombre de usuario corto sin especificarinstance, se usarámastodon.socialpor defecto. Cuentas con el mismo nombre en instancias diferentes no son la misma persona.Mastodon: la cuenta incluye usuario y dominio — WebFinger diferencia cuentas con el mismo nombre en dominios distintos, como `@usuario@ejemplo.com` y `@usuario @ejemplo.org`. El identificador completo es necesario para atribución, pero no abre campos adicionales del objeto Account oficial. · Consultada instanceOpcional- Dominio de la instancia de Mastodon, sin protocolo ni ruta.
timelineusafosstodon.orgpor defecto y las demás accionesmastodon.social; si también aparece una instancia enusername, mantén ambos valores coherentes.
¿Qué significan los parámetros de Mastodon profile?
Resuelve username como handle corto o usuario@instancia y devuelve identidad y URL federadas. Si se omite la instancia, se usa el comportamiento declarado, pero no prueba que esa sea la cuenta buscada.
usernameObligatorio- Nombre de cuenta de Mastodon o cuenta completa en formato
user@instance. Puedes omitir el@inicial. Si solo envías el nombre de usuario corto sin especificarinstance, se usarámastodon.socialpor defecto. Cuentas con el mismo nombre en instancias diferentes no son la misma persona.Mastodon: la cuenta incluye usuario y dominio — WebFinger diferencia cuentas con el mismo nombre en dominios distintos, como `@usuario@ejemplo.com` y `@usuario @ejemplo.org`. El identificador completo es necesario para atribución, pero no abre campos adicionales del objeto Account oficial. · Consultada instanceOpcional- Dominio de la instancia de Mastodon, sin protocolo ni ruta.
timelineusafosstodon.orgpor defecto y las demás accionesmastodon.social; si también aparece una instancia enusername, mantén ambos valores coherentes.
¿Qué significan los parámetros de Mastodon hashtag?
Consulta publicaciones de una etiqueta mediante hashtag, con instance opcional para elegir la instancia. El resultado depende de la instancia accesible y no mide toda la conversación federada.
hashtagObligatorio- Término de la etiqueta, sin el
#. Lee el flujo del tema en lainstanceespecificada. No incluye «boosts» ni respuestas, por lo que no debes considerarlo una muestra completa de la etiqueta en toda la red federada.Mastodon: límites del timeline de etiquetas y vista previa pública de la instancia — La documentación oficial explica la lectura del timeline de etiquetas para estados públicos que contienen una etiqueta específica, cuya ruta no lleva `#`; el acceso está restringido si la instancia desactiva la vista previa pública. La exclusión de Boosts o respuestas y los parámetros admitidos por EveryInfra se rigen por el acuerdo de esta página, sin copiar todas las claves de consulta oficiales. · Consultada instanceOpcional- Dominio de la instancia de Mastodon, sin protocolo ni ruta.
timelineusafosstodon.orgpor defecto y las demás accionesmastodon.social; si también aparece una instancia enusername, mantén ambos valores coherentes.
¿Qué significan los parámetros de Mastodon trending?
Obtiene una selección pública en tendencia sin parámetros de negocio. La posición y los contadores pertenecen a esa observación; no explican el algoritmo ni forman un ranking global del fediverso.
Referencia completa: parámetros, ejemplos de código, respuesta de ejemplo y salud →instanceOpcional- Dominio de la instancia de Mastodon, sin protocolo ni ruta.
timelineusafosstodon.orgpor defecto y las demás accionesmastodon.social; si también aparece una instancia enusername, mantén ambos valores coherentes.
¿Qué significan los parámetros de Mastodon timeline?
Lee una cronología pública sin entradas adicionales y devuelve estados con instancia, autor e interacciones. No es un feed personal autenticado ni un archivo universal de Mastodon.
Referencia completa: parámetros, ejemplos de código, respuesta de ejemplo y salud →instanceOpcional- Dominio de la instancia de Mastodon, sin protocolo ni ruta.
timelineusafosstodon.orgpor defecto y las demás accionesmastodon.social; si también aparece una instancia enusername, mantén ambos valores coherentes.
Cómo usar la API de Mastodon
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"mastodon","action":"user_posts","params":{"username":"<username>"}}'
Preguntas sobre la API de Mastodon
¿Cómo llamo a la API de Mastodon?
Envía POST /api/v1/social con platform igual a mastodon, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Mastodon?
Devuelve JSON estructurado. Por ejemplo, el esquema de user_posts incluye text, author_name, author_username y author_url. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de Mastodon?
WebFinger diferencia cuentas con el mismo nombre en dominios distintos, como @usuario y @usuario. El identificador completo es necesario para atribución, pero no abre campos adicionales del objeto Account oficial.
¿Qué parámetros son obligatorios?
Depende de la acción. user_posts requiere username; profile requiere username; hashtag requiere hashtag; consulta las demás acciones en la lista de funciones.
¿Las acciones de Mastodon responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.