API de plataforma de EveryData

API de Mastodon

Q: ¿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.

Q: ¿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 de origen contengan un valor.

Q: ¿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.

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.

Empieza gratis Ver el catálogo público

Endpoint: POST /api/v1/social
Funciones: 5
Por 1.000: 1,389 US$

Funciones disponibles

Compara las acciones de Mastodon por sus entradas obligatorias, datos devueltos y precio. Usa el identificador de la acción exactamente como aparece.

Acción	Obligatorios	Opcionales	Entrega	Límite	Por 1.000	Campos de respuesta
`user_posts` Leer publicaciones de una cuenta federada 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.	username	—	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
`profile` Consultar un perfil de Mastodon Resuelve `username` como handle corto o `usuario@instancia` y devuelve identidad y URL federadas. Omitir la instancia usa el comportamiento declarado, pero no prueba que esa sea la cuenta buscada.	username	—	Entrega síncrona	—	$1.39 por 1.000 solicitudes	username · display_name · handle · instance · url · platform
`hashtag` Buscar publicaciones por hashtag Consulta publicaciones de una etiqueta mediante `hashtag`, con alias compatibles de palabra o `tag`. El resultado depende de la instancia accesible y no mide toda la conversación federada.	hashtag	keyword, tag	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
`trending` Explorar 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.		—	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
`timeline` Leer 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.		—	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

¿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.

¿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 especificar instance, se usará mastodon.social por defecto. Cuentas con el mismo nombre en instancias diferentes no son la misma persona.
Mastodon: la cuenta incluye usuario y dominioWebFinger diferencia cuentas con el mismo nombre en dominios distintos, como `@[email protected]` y `@[email protected]`. El identificador completo es necesario para atribución, pero no abre campos adicionales del objeto Account oficial.Consultada 2026-09-04

¿Qué significan los parámetros de Mastodon `profile`?

Resuelve username como handle corto o usuario@instancia y devuelve identidad y URL federadas. Omitir la instancia 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 especificar instance, se usará mastodon.social por defecto. Cuentas con el mismo nombre en instancias diferentes no son la misma persona.
Mastodon: la cuenta incluye usuario y dominioWebFinger diferencia cuentas con el mismo nombre en dominios distintos, como `@[email protected]` y `@[email protected]`. El identificador completo es necesario para atribución, pero no abre campos adicionales del objeto Account oficial.Consultada 2026-09-04

¿Qué significan los parámetros de Mastodon `hashtag`?

Consulta publicaciones de una etiqueta mediante hashtag, con alias compatibles de palabra o tag. 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 la instance especificada. Actualmente 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 instanciaLa fuente 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 contrato de esta propia página, sin copiar todas las claves de consulta oficiales.Consultada 2026-09-04
keywordOpcional: Entrada de compatibilidad para la etiqueta en la acción hashtag; no es una búsqueda de texto completo abierta. Las solicitudes públicas aún requieren el parámetro hashtag.
tagOpcional: Entrada de compatibilidad para hashtag. El parámetro hashtag tiene prioridad y sigue siendo obligatorio para las solicitudes públicas. No es un ID de publicación ni un nombre de cuenta.

¿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.

Esta acción no tiene parámetros de negocio. Envía únicamente los identificadores de plataforma y acción.

¿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.

Esta acción no tiene parámetros de negocio. Envía únicamente los identificadores de plataforma y acción.

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 devuelto si la acción es asíncrona.
04Guarda los campos de la respuesta estructurada que necesita tu aplicación.

mastodon_user_posts.sh

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 de origen contengan 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 @[email protected] y @[email protected]. 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.

Behance API Bilibili API Bluesky API Dailymotion API DeviantArt API Discord API Douban API Douyin API Ver el catálogo público →