API de Lemmy

Busca publicaciones y consulta comunidades, feeds y comentarios públicos de Lemmy. La instancia forma parte de la identidad federada y evita mezclar comunidades o usuarios homónimos.

Un feed accesible desde una instancia no representa todo el fediverso. Profundidad y comentario padre solo se usan cuando el registro los expone; no se inventan ramas faltantes.

Disponibilidad de la plataforma

Salud 24 h
Normal
Normal

Últimos 30 días

Funciones disponibles

Cada acción de Lemmy, 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.

CapacidadQué hacePor 1.000Salud en 24 horas
Buscar publicaciones federadas en LemmysearchBusca publicaciones federadas mediante keyword y conserva comunidad, instancia, autor, votos y comentarios.$1.39 por 1.000 solicitudesNormal
Consultar una comunidad de LemmycommunityConsulta la comunidad indicada en community y devuelve publicaciones con su instancia y métricas públicas.$1.39 por 1.000 solicitudesNormal
Leer el feed público de LemmyfeedLee un feed público sin parámetros de negocio y devuelve publicaciones de comunidades e instancias visibles.$1.39 por 1.000 solicitudesNormal
Recorrer comentarios de una comunidadcommentsObtiene comentarios de community y permite limitar la cantidad por publicación mediante max_comments.$1.39 por 1.000 solicitudesNormal

Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.

¿Qué acepta cada acción de Lemmy?

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ónObligatoriosOpcionalesEntregaLímitePor 1.000Campos de respuesta
search

Buscar publicaciones federadas en Lemmy

Busca publicaciones federadas mediante keyword y conserva comunidad, instancia, autor, votos y comentarios. El resultado depende del contenido visible para la consulta y no representa todo el fediverso.

keywordinstance, sort, top_rangeEntrega síncronaEl catálogo declara defaultLimit = 20 y maxLimit = 200 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 solicitudesid · title · body · url · external_url · community · community_url · instance · author_username · author_url · score · upvote_count · downvote_count · comment_count · thumbnail_url · embed_title · is_nsfw · is_locked · is_featured · posted_at · updated_at · platform
community

Consultar una comunidad de Lemmy

Consulta la comunidad indicada en community y devuelve publicaciones con su instancia y métricas públicas. No une comunidades homónimas de otras instancias ni concede membresía.

communityinstance, sort, top_rangeEntrega síncronaEl catálogo declara defaultLimit = 20 y maxLimit = 200 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 solicitudesid · title · body · url · external_url · community · community_url · instance · author_username · author_url · score · upvote_count · downvote_count · comment_count · thumbnail_url · embed_title · is_nsfw · is_locked · is_featured · posted_at · updated_at · platform
feed

Leer el feed público de Lemmy

Lee un feed público sin parámetros de negocio y devuelve publicaciones de comunidades e instancias visibles. No debe presentarse como una cronología universal, personalizada o completa.

instance, sort, top_rangeEntrega síncronaEl 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 solicitudesid · title · body · url · external_url · community · community_url · instance · author_username · author_url · score · upvote_count · downvote_count · comment_count · thumbnail_url · embed_title · is_nsfw · is_locked · is_featured · posted_at · updated_at · platform
comments

Recorrer comentarios de una comunidad

Obtiene comentarios de community y permite limitar la cantidad por publicación mediante max_comments. Conserva profundidad y padre cuando existen; no inventa relaciones para entradas eliminadas.

communityinstance, max_comments, sort, top_rangeEntrega síncronaEl catálogo declara defaultLimit = 10 y maxLimit = 200 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 solicitudesid · text · author_username · author_url · score · upvote_count · downvote_count · depth · parent_comment_id · is_deleted · post_url · post_title · community · posted_at · platform

¿Qué significan los parámetros de Lemmy search?

Busca publicaciones federadas mediante keyword y conserva comunidad, instancia, autor, votos y comentarios. El resultado depende del contenido visible para la consulta y no representa todo el fediverso.

Referencia completa: parámetros, ejemplos de código, respuesta de ejemplo y salud →
keywordObligatorio
Término de búsqueda para publicaciones de Lemmy, ejecutado en la instancia especificada en instance. No es una garantía de búsqueda completa en todas las instancias federadas.
Lemmy: visión de una instancia y contenido federado — La guía de Lemmy explica que cada instancia tiene su propio operador y normalmente muestra las comunidades que conoce. La referencia delimita el alcance federado; una consulta no debe presentarse como inventario total de todo Lemmy. · Consultada
instanceOpcional
Dominio de la instancia de Lemmy, por ejemplo lemmy.world, que también es el valor predeterminado. Una URL completa se reduce a su hostname; selecciona el punto de entrada de la consulta, no una comunidad.
sortOpcional
Orden de las publicaciones: hot, active, new, top, most_comments o new_comments. Cada acción conserva su valor predeterminado y este parámetro no ordena comentarios individuales dentro de un hilo.
Valores permitidos:activehotmost_commentsnewnew_commentstop
top_rangeOpcional
Ventana temporal aplicada únicamente cuando sort es top: hour, sixhour, twelvehour, day, week, month, threemonths, sixmonths, ninemonths, year o all. No es un filtro de fecha de publicación de comentarios.
Valores permitidos:alldayhourmonthninemonthssixhoursixmonthsthreemonthstwelvehourweekyear

¿Qué significan los parámetros de Lemmy community?

Consulta la comunidad indicada en community y devuelve publicaciones con su instancia y métricas públicas. No une comunidades homónimas de otras instancias ni concede membresía.

Referencia completa: parámetros, ejemplos de código, respuesta de ejemplo y salud →
communityObligatorio
Nombre de una comunidad de Lemmy o identificador de comunidad inter-instancia en formato name@instance. La acción community lista las publicaciones de la comunidad; comments lee las publicaciones por comunidad y expande los comentarios, no consulta directamente por la URL de una publicación individual.
Lemmy: identificadores de comunidad y acceso entre instancias — La documentación oficial muestra la URL de la comunidad y el identificador `!name@instance`, y distingue entre comunidades locales y federadas. Este servicio declara que el parámetro admite `name` o `name@instance`; el prefijo `!` de la interfaz oficial y el formato de URL no son formatos admitidos automáticamente por esta API. · Consultada
instanceOpcional
Dominio de la instancia de Lemmy, por ejemplo lemmy.world, que también es el valor predeterminado. Una URL completa se reduce a su hostname; selecciona el punto de entrada de la consulta, no una comunidad.
sortOpcional
Orden de las publicaciones: hot, active, new, top, most_comments o new_comments. Cada acción conserva su valor predeterminado y este parámetro no ordena comentarios individuales dentro de un hilo.
Valores permitidos:activehotmost_commentsnewnew_commentstop
top_rangeOpcional
Ventana temporal aplicada únicamente cuando sort es top: hour, sixhour, twelvehour, day, week, month, threemonths, sixmonths, ninemonths, year o all. No es un filtro de fecha de publicación de comentarios.
Valores permitidos:alldayhourmonthninemonthssixhoursixmonthsthreemonthstwelvehourweekyear

¿Qué significan los parámetros de Lemmy feed?

Lee un feed público sin parámetros de negocio y devuelve publicaciones de comunidades e instancias visibles. No debe presentarse como una cronología universal, personalizada o completa.

Referencia completa: parámetros, ejemplos de código, respuesta de ejemplo y salud →
instanceOpcional
Dominio de la instancia de Lemmy, por ejemplo lemmy.world, que también es el valor predeterminado. Una URL completa se reduce a su hostname; selecciona el punto de entrada de la consulta, no una comunidad.
sortOpcional
Orden de las publicaciones: hot, active, new, top, most_comments o new_comments. Cada acción conserva su valor predeterminado y este parámetro no ordena comentarios individuales dentro de un hilo.
Valores permitidos:activehotmost_commentsnewnew_commentstop
top_rangeOpcional
Ventana temporal aplicada únicamente cuando sort es top: hour, sixhour, twelvehour, day, week, month, threemonths, sixmonths, ninemonths, year o all. No es un filtro de fecha de publicación de comentarios.
Valores permitidos:alldayhourmonthninemonthssixhoursixmonthsthreemonthstwelvehourweekyear

¿Qué significan los parámetros de Lemmy comments?

Obtiene comentarios de community y permite limitar la cantidad por publicación mediante max_comments. Conserva profundidad y padre cuando existen; no inventa relaciones para entradas eliminadas.

Referencia completa: parámetros, ejemplos de código, respuesta de ejemplo y salud →
communityObligatorio
Nombre de una comunidad de Lemmy o identificador de comunidad inter-instancia en formato name@instance. La acción community lista las publicaciones de la comunidad; comments lee las publicaciones por comunidad y expande los comentarios, no consulta directamente por la URL de una publicación individual.
instanceOpcional
Dominio de la instancia de Lemmy, por ejemplo lemmy.world, que también es el valor predeterminado. Una URL completa se reduce a su hostname; selecciona el punto de entrada de la consulta, no una comunidad.
max_commentsOpcional
Para comments, es el número máximo de comentarios a leer por publicación. El valor predeterminado es 50, con un límite de 1 a 200. No se refiere al número de publicaciones de la solicitud ni al total de comentarios; si el valor está fuera de rango, se ajustará al límite más cercano.
Lemmy: los comentarios tienen una estructura anidada; el límite no equivale a la discusión completa — La documentación oficial explica la jerarquía entre comentarios de primer nivel y respuestas anidadas, y cómo la puntuación es la resta de votos positivos y negativos. El límite de comentarios por publicación de esta API es una definición propia y no una de las opciones de ordenación oficiales; alcanzar el límite tampoco garantiza que se incluyan todos los nodos padre-hijo. · Consultada
sortOpcional
Orden de las publicaciones: hot, active, new, top, most_comments o new_comments. Cada acción conserva su valor predeterminado y este parámetro no ordena comentarios individuales dentro de un hilo.
Valores permitidos:activehotmost_commentsnewnew_commentstop
top_rangeOpcional
Ventana temporal aplicada únicamente cuando sort es top: hour, sixhour, twelvehour, day, week, month, threemonths, sixmonths, ninemonths, year o all. No es un filtro de fecha de publicación de comentarios.
Valores permitidos:alldayhourmonthninemonthssixhoursixmonthsthreemonthstwelvehourweekyear

Cómo usar la API de Lemmy

  1. 01Consulta el catálogo público y elige una acción de la plataforma.
  2. 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
  3. 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
  4. 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
lemmy_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"lemmy","action":"search","params":{"keyword":"<keyword>"}}'

Preguntas sobre la API de Lemmy

¿Cómo llamo a la API de Lemmy?

Envía POST /api/v1/social con platform igual a lemmy, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.

¿Qué devuelve la API de Lemmy?

Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye title, body, external_url y community. 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 Lemmy?

La guía de Lemmy explica que cada instancia tiene su propio operador y normalmente muestra las comunidades que conoce. La referencia delimita el alcance federado; una consulta no debe presentarse como inventario total de todo Lemmy.

¿Qué parámetros son obligatorios?

Depende de la acción. search requiere keyword; community requiere community; feed no requiere parámetros obligatorios; consulta las demás acciones en la lista de funciones.

¿Las acciones de Lemmy 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.