Lemmy
App · Social Media · 10 actions
Read Lemmy, the open network of community forums, from a workflow. Watch a community's posts, pull a whole discussion in reading order, search every server your own one can see for a name or a topic, look up a community before you post in it or a person before you act on what they said, and follow a community's public moderation log. Every result carries the handle and the link a later step needs, so a scheduled workflow can turn a community into a digest, a keyword into an alert, or a thread into a summary. Set 'Only what is newer than' and a run never reports the same post twice. Every action reads: nothing here posts, votes or subscribes. No account or API key required.
Actions
| Action | What it does |
|---|---|
| Get a comment | Read one comment: what it says, who wrote it, what it answers, how it scored and which post and community it belongs to. |
| Get a community | Look up one community: what it is for, its rules, how many people follow it, how busy it has been this month and who moderates it. |
| Get a person | Look up somebody: their profile, when they joined, how much they have written, which communities they moderate, and their latest posts and comments. |
| Get a post | Read one post in full, along with the community it was posted in - its rules, its size and who moderates it - and anywhere the same link was cross-posted. |
| Get server details | Describe the Lemmy server this connection reads: its name, what it is for, its rules, how many people and communities it holds, how many are active this month, whether sign-ups are open and who its admins are. |
| List comments on a post | Read a post's discussion, in the order a person would read it: every reply follows the comment it answers, and each one says how deep it sits. |
| List communities | Browse the communities your server carries, busiest or biggest first. |
| List moderation actions | Read the public moderation log as one list of events in time order: posts removed, comments removed, people banned, moderators added, communities purged. |
| List posts | Read a feed of posts: one community's, or everything your server can see. |
| Search Lemmy | Search your server and everything it federates with, for posts, comments, communities or people. |
Get a comment
Read one comment: what it says, who wrote it, what it answers, how it scored and which post and community it belongs to. Takes the comment's address or its number, both of which come out of any listing or search here. Use it to pull the full text of a comment a search only showed the start of.
Inputs
- Comment
commenttextRequired - The comment to read: its number, or its full address on the server this connection reads. Comment numbers belong to the server that answers, so a link copied from a different Lemmy server is refused rather than quietly fetching an unrelated comment.
Outputs
commentobject- The comment, with the post and community it belongs to
servertext- The Lemmy server that answered
Example output
{
"comment": {
"author": {
"avatar_url": null,
"display_name": null,
"handle": "@boonhet@lemmy.zip",
"id": 23908729,
"is_admin": false,
"is_banned_from_community": false,
"is_bot": false,
"is_local": false,
"is_moderator": false,
"name": "boonhet",
"server": "lemmy.zip",
"url": "https://lemmy.world/u/boonhet@lemmy.zip"
},
"body": "I'm sure Bernie has good intentions but this is exactly what Altman and Amodei want and wh...",
"community": {
"handle": "!technology@lemmy.world",
"icon_url": "https://lemmy.world/pictrs/image/2a85bf08-5c07-4326-8dad-f549bfb2189e.png",
"id": 2478,
"is_local": true,
"is_nsfw": false,
"name": "technology",
"server": "lemmy.world",
"title": "Technology",
"url": "https://lemmy.world/c/technology"
},
"depth": 0,
"downvotes": 2,
"id": 25819340,
"is_deleted": false,
"is_from_moderator": false,
"is_removed": false,
"is_reply": false,
"language": "English",
"origin_url": "https://lemmy.zip/comment/28840268",
"parent_comment_id": null,
"post": {
"id": 51903676,
"title": "Bernie Sanders proposes 20 year prison sentence for AI devs who plow ahead with Artificial...",
"url": "https://lemmy.world/post/51903676"
},
"published": "2026-09-14T11:21:59.943446Z",
"reply_count": 27,
"score": 224,
"updated": null,
"upvotes": 226,
"url": "https://lemmy.world/comment/25819340"
},
"server": "lemmy.world"
}Get a community
Look up one community: what it is for, its rules, how many people follow it, how busy it has been this month and who moderates it. This is the step to run before a workflow posts anywhere near a community, and the quickest way to tell a 50-subscriber namesake on your own server from the 80,000- subscriber one everybody means.
Inputs
- Community
communitytextRequired - The community to read. The list is the busiest communities on your server, and you can type any other community's handle beside it - !linux@lemmy.ml, or its address such as https://lemmy.ml/c/linux. Always include the @server part: a bare 'linux' means your own server's community of that name, which is usually a different and much smaller place.
Outputs
communityobject- The community, with its rules, its size and its activity
moderator_countnumber- How many moderators
moderator_handleslist- Just their handles
moderatorslist- Who moderates it
servertext- The Lemmy server that answered
Example output
{
"community": {
"active_users_day": 814,
"active_users_month": 5969,
"active_users_week": 2993,
"banner_url": null,
"comment_count": 238008,
"created": "2019-06-01T15:07:36.179766Z",
"description": "From Wikipedia, the free encyclopedia\n\nLinux is a family of open source Unix-like operatin...",
"handle": "!linux@lemmy.ml",
"icon_url": "https://lemmy.ml/pictrs/image/q98XK4sKtw.png",
"id": 37,
"is_deleted": false,
"is_hidden": false,
"is_local": false,
"is_nsfw": false,
"is_removed": false,
"name": "linux",
"origin_url": "https://lemmy.ml/c/linux",
"post_count": 9320,
"posting_restricted_to_mods": false,
"server": "lemmy.ml",
"subscribers": 67576,
"title": "Linux",
"url": "https://lemmy.world/c/linux@lemmy.ml"
},
"moderator_count": 6,
"moderator_handles": [
"@AgreeableLandscape@lemmy.ml"
],
"moderators": [
{
"avatar_url": "https://lemmy.ml/pictrs/image/05kw0h.jpg",
"display_name": null,
"handle": "@AgreeableLandscape@lemmy.ml",
"id": 223,
"is_admin": false,
"is_banned_from_community": false,
"is_bot": false,
"is_local": false,
"is_moderator": true,
"name": "AgreeableLandscape",
"server": "lemmy.ml",
"url": "https://lemmy.world/u/AgreeableLandscape@lemmy.ml"
}
],
"server": "lemmy.world"
}Get a person
Look up somebody: their profile, when they joined, how much they have written, which communities they moderate, and their latest posts and comments. Use it to weigh a comment before acting on it - a three-day-old account with four comments reads differently from a moderator of the community it was posted in - or to follow one person's activity.
Inputs
- Person
persontextRequired - Whose profile to read. Their handle (@ruud@lemmy.world), their profile address (https://lemmy.world/u/ruud) or their id all work. Include the @server part for somebody whose account is on another server, or your server will look for a local account of that name.
- Order their activity by
sorttext - What to put first among their posts and comments. 'Newest first' is what they have been doing lately; 'Top of all time' is what they are known for.One of:
Active(Active: busiest discussions first),Hot(Hot: rising right now),New(Newest first),Scaled(Scaled: hot, but fairer to small communities),TopDay(Top today),TopWeek(Top this week),TopMonth(Top this month),TopYear(Top this year),TopAll(Top of all time),MostComments(Most comments),NewComments(Most recently replied to),Controversial(Controversial: voted hard both ways). Default:New. - How much activity
limitnumber - How many recent posts and how many recent comments to bring back, from 1 to 50 of each.From 1 to 50. Default:
10.
Outputs
limitnumber- How many posts and comments were asked for
moderateslist- The communities they moderate
moderates_handleslist- Just those communities' handles
personobject- The person, with how much they have written
recent_commentslist- Their latest comments
recent_postslist- Their latest posts
servertext- The Lemmy server that answered
sorttext- The order their posts came in
Example output
{
"limit": 1,
"moderates": [
{
"handle": "!fediverse@lemmy.world",
"icon_url": "https://lemmy.world/pictrs/image/eb9cfeb5-4eb5-4b1b-a75c-8d9e04c3f856.png",
"id": 2,
"is_local": true,
"is_nsfw": false,
"name": "fediverse",
"server": "lemmy.world",
"title": "Fediverse",
"url": "https://lemmy.world/c/fediverse"
}
],
"moderates_handles": [
"!fediverse@lemmy.world"
],
"person": {
"avatar_url": "https://lemmy.world/pictrs/image/2f75baeb-34c1-4a8b-8d1e-bc0a52b47a62.png",
"banner_url": "https://lemmy.world/pictrs/image/2cddd018-5a89-4427-963a-025594190857.png",
"bio": "Admin of a lot of fediverse servers.\nSee my accounts on [Keyoxide](https://keyoxide.world/...",
"comment_count": 992,
"display_name": "Ruud",
"handle": "@ruud@lemmy.world",
"id": 2,
"is_admin": true,
"is_banned": false,
"is_bot": false,
"is_deleted": false,
"is_local": true,
"joined": "2023-06-01T07:01:45.388375Z",
"name": "ruud",
"origin_url": "https://lemmy.world/u/ruud",
"post_count": 128,
"server": "lemmy.world",
"url": "https://lemmy.world/u/ruud"
},
"recent_comments": [
{
"author": {
"avatar_url": "https://lemmy.world/pictrs/image/2f75baeb-34c1-4a8b-8d1e-bc0a52b47a62.png",
"display_name": "Ruud",
"handle": "@ruud@lemmy.world",
"id": 2,
"is_admin": true,
"is_banned_from_community": false,
"is_bot": false,
"is_local": true,
"is_moderator": true,
"name": "ruud",
"server": "lemmy.world",
"url": "https://lemmy.world/u/ruud"
},
"body": "Good point. Will update the post and remember for upcoming donation posts",
"community": {
"handle": "!lemmyworld@lemmy.world",
"icon_url": "https://lemmy.world/pictrs/image/f3189f30-f8c8-4c4f-b957-e3a7bfd1c784.png",
"id": 5,
"is_local": true,
"is_nsfw": false,
"name": "lemmyworld",
"server": "lemmy.world",
"title": "Lemmy.World Announcements",
"url": "https://lemmy.world/c/lemmyworld"
},
"depth": 3,
"downvotes": 0,
"id": 23159117,
"is_deleted": false,
"is_from_moderator": false,
"is_removed": false,
"is_reply": true,
"language": null,
"origin_url": "https://lemmy.world/comment/23159117",
"parent_comment_id": 23153848,
"post": {
"id": 45439860,
"title": "Call for donations for Lemmy.World",
"url": "https://lemmy.world/post/45439860"
},
"published": "2026-04-11T08:08:33.302480Z",
"reply_count": 0,
"score": 2,
"updated": null,
"upvotes": 2,
"url": "https://lemmy.world/comment/23159117"
}
],
"recent_posts": [
{
"author": {
"avatar_url": "https://lemmy.world/pictrs/image/2f75baeb-34c1-4a8b-8d1e-bc0a52b47a62.png",
"display_name": "Ruud",
"handle": "@ruud@lemmy.world",
"id": 2,
"is_admin": true,
"is_banned_from_community": false,
"is_bot": false,
"is_local": true,
"is_moderator": false,
"name": "ruud",
"server": "lemmy.world",
"url": "https://lemmy.world/u/ruud"
},
"body": "I setup a chatmail relay yesterday, so if you want to try Delta Chat (or other compatible...",
"comment_count": 0,
"community": {
"handle": "!delta_chat@lemmy.zip",
"icon_url": "https://lemmy.zip/pictrs/image/521566d7-7b70-47e7-b2cc-c9fe04a1ea05.png",
"id": 94805,
"is_local": false,
"is_nsfw": false,
"name": "delta_chat",
"server": "lemmy.zip",
"title": "Delta Chat",
"url": "https://lemmy.world/c/delta_chat@lemmy.zip"
},
"downvotes": 0,
"id": 40464240,
"image_url": null,
"is_deleted": false,
"is_local": true,
"is_locked": false,
"is_nsfw": false,
"is_pinned_in_community": false,
"is_pinned_on_server": false,
"is_removed": false,
"language": "English",
"last_comment_at": "2025-12-20T12:19:49.694347Z",
"link": "https://chat.in-the.eu/",
"link_description": null,
"link_title": "chat.in-the.eu home",
"origin_url": "https://lemmy.world/post/40464240",
"published": "2025-12-20T12:19:49.694347Z",
"score": 7,
"thumbnail_url": null,
"title": "New Delta Chat (Chatmail) relay",
"updated": null,
"upvotes": 7,
"url": "https://lemmy.world/post/40464240"
}
],
"server": "lemmy.world",
"sort": "New"
}Get a post
Read one post in full, along with the community it was posted in - its rules, its size and who moderates it - and anywhere the same link was cross-posted. Takes the post's address or its number. Use it after a search or a feed to get the whole text before summarising it, or to check the room's rules before a person replies.
Inputs
- Post
posttextRequired - The post to read: its number, or its full address on the server this connection reads. Post numbers belong to the server that answers, so a link copied from a different Lemmy server is refused rather than quietly fetching an unrelated post - open the post on your own server and copy that link instead.
Outputs
communityobject- The community it is in, with its rules and its size
cross_post_countnumber- How many other communities it was posted in
cross_post_urlslist- Just those posts' addresses
cross_postslist- The same link posted in other communities
moderator_handleslist- Just their handles
moderatorslist- Who moderates that community
postobject- The post itself
servertext- The Lemmy server that answered
Example output
{
"community": {
"active_users_day": 3621,
"active_users_month": 15651,
"active_users_week": 8259,
"banner_url": "https://lemmy.world/pictrs/image/be818d42-f96f-4a33-b963-2a6e35938d54.png",
"comment_count": 950464,
"created": "2023-06-11T02:16:17.173483Z",
"description": "This is a [most excellent](https://media.giphy.com/media/v1.Y2lkPTc5MGI3NjExN3N0NmhuODNib3...",
"handle": "!technology@lemmy.world",
"icon_url": "https://lemmy.world/pictrs/image/2a85bf08-5c07-4326-8dad-f549bfb2189e.png",
"id": 2478,
"is_deleted": false,
"is_hidden": false,
"is_local": true,
"is_nsfw": false,
"is_removed": false,
"name": "technology",
"origin_url": "https://lemmy.world/c/technology",
"post_count": 21747,
"posting_restricted_to_mods": false,
"server": "lemmy.world",
"subscribers": 88039,
"title": "Technology",
"url": "https://lemmy.world/c/technology"
},
"cross_post_count": 1,
"cross_post_urls": [
"https://lemmy.world/post/51926985"
],
"cross_posts": [
{
"author": {
"avatar_url": "https://lemmy.world/pictrs/image/74e38473-e085-4c7f-af78-0043b07dfda9.png",
"display_name": "lechekaflan",
"handle": "@lechekaflan@lemmy.world",
"id": 305202,
"is_admin": false,
"is_banned_from_community": false,
"is_bot": false,
"is_local": true,
"is_moderator": false,
"name": "lechekaflan",
"server": "lemmy.world",
"url": "https://lemmy.world/u/lechekaflan"
},
"body": null,
"comment_count": 8,
"community": {
"handle": "!fuck_ai@lemmy.world",
"icon_url": "https://lemmy.world/pictrs/image/c48ef21e-b874-490f-ba79-e72993beb47a.jpeg",
"id": 619560,
"is_local": true,
"is_nsfw": false,
"name": "fuck_ai",
"server": "lemmy.world",
"title": "Fuck AI",
"url": "https://lemmy.world/c/fuck_ai"
},
"downvotes": 1,
"id": 51926985,
"image_url": "https://lemmy.world/pictrs/image/933fb8ad-19d0-4d39-9e73-4d6a29f1f5e9.jpeg",
"is_deleted": false,
"is_local": true,
"is_locked": false,
"is_nsfw": false,
"is_pinned_in_community": false,
"is_pinned_on_server": false,
"is_removed": false,
"language": "English",
"last_comment_at": "2026-09-15T06:16:59.728212Z",
"link": "https://www.tomshardware.com/tech-industry/artificial-intelligence/sanders-proposes-20-yea...",
"link_description": "Scale of penalty matches that facing rogue nuclear weapon designers.",
"link_title": "Bernie Sanders proposes 20 year prison sentence for AI devs who plow ahead with Artificial...",
"origin_url": "https://lemmy.world/post/51926985",
"published": "2026-09-15T00:40:24.030291Z",
"score": 126,
"thumbnail_url": "https://lemmy.world/pictrs/image/933fb8ad-19d0-4d39-9e73-4d6a29f1f5e9.jpeg",
"title": "Bernie Sanders proposes 20 year prison sentence for AI devs who plow ahead with Artificial...",
"updated": null,
"upvotes": 127,
"url": "https://lemmy.world/post/51926985"
}
],
"moderator_handles": [
"@L3s@lemmy.world"
],
"moderators": [
{
"avatar_url": "https://lemmy.world/pictrs/image/ca50d860-0713-4719-b9f6-97e3e6d6f2e8.png",
"display_name": null,
"handle": "@L3s@lemmy.world",
"id": 319663,
"is_admin": false,
"is_banned_from_community": false,
"is_bot": false,
"is_local": true,
"is_moderator": true,
"name": "L3s",
"server": "lemmy.world",
"url": "https://lemmy.world/u/L3s"
}
],
"post": {
"author": {
"avatar_url": "https://thelemmy.club/pictrs/image/66364803-7fc3-4442-afcb-ef74f4b3d5a6.png",
"display_name": null,
"handle": "@Mustachius_Grumpius@thelemmy.club",
"id": 24283634,
"is_admin": false,
"is_banned_from_community": false,
"is_bot": false,
"is_local": false,
"is_moderator": false,
"name": "Mustachius_Grumpius",
"server": "thelemmy.club",
"url": "https://lemmy.world/u/Mustachius_Grumpius@thelemmy.club"
},
"body": null,
"comment_count": 150,
"community": {
"handle": "!technology@lemmy.world",
"icon_url": "https://lemmy.world/pictrs/image/2a85bf08-5c07-4326-8dad-f549bfb2189e.png",
"id": 2478,
"is_local": true,
"is_nsfw": false,
"name": "technology",
"server": "lemmy.world",
"title": "Technology",
"url": "https://lemmy.world/c/technology"
},
"downvotes": 19,
"id": 51903676,
"image_url": "https://lemmy.world/pictrs/image/933fb8ad-19d0-4d39-9e73-4d6a29f1f5e9.jpeg",
"is_deleted": false,
"is_local": false,
"is_locked": false,
"is_nsfw": false,
"is_pinned_in_community": false,
"is_pinned_on_server": false,
"is_removed": false,
"language": "English",
"last_comment_at": "2026-09-15T07:50:57.288624Z",
"link": "https://www.tomshardware.com/tech-industry/artificial-intelligence/sanders-proposes-20-yea...",
"link_description": "Scale of penalty matches that facing rogue nuclear weapon designers.",
"link_title": "Bernie Sanders proposes 20 year prison sentence for AI devs who plow ahead with Artificial...",
"origin_url": "https://thelemmy.club/post/55903506",
"published": "2026-09-14T10:54:19.145096Z",
"score": 999,
"thumbnail_url": "https://lemmy.world/pictrs/image/933fb8ad-19d0-4d39-9e73-4d6a29f1f5e9.jpeg",
"title": "Bernie Sanders proposes 20 year prison sentence for AI devs who plow ahead with Artificial...",
"updated": null,
"upvotes": 1018,
"url": "https://lemmy.world/post/51903676"
},
"server": "lemmy.world"
}Get server details
Describe the Lemmy server this connection reads: its name, what it is for, its rules, how many people and communities it holds, how many are active this month, whether sign-ups are open and who its admins are. It needs nothing filled in, so it is also the one-step check that the connection works and points at the server you meant.
Inputs
None.
Outputs
active_users_daynumber- How many people posted or commented today
active_users_half_yearnumber- How many in the last six months
active_users_monthnumber- How many this month
active_users_weeknumber- How many this week
admin_handleslist- Just their handles
adminslist- The people who run it
banner_urltext- Its banner image
comment_countnumber- How many comments it holds
community_countnumber- How many communities it hosts
createdtext- When it was set up
descriptiontext- Its sidebar: what it is and its rules, as Markdown
downvotes_enabledtrue/false- True when downvoting is allowed here
federation_enabledtrue/false- True when it exchanges content with other servers
icon_urltext- Its icon image
is_privatetrue/false- True when the server only answers to people logged in to it
legal_informationtext- Its terms and legal notices, as Markdown
nametext- What the server calls itself
nsfw_allowedtrue/false- True when NSFW content is allowed here
post_countnumber- How many posts it holds
post_languageslist- The languages posts here can be tagged with
registrationtext- Whether anyone can sign up, sign-ups need an application, or sign-ups are closed
registration_questiontext- The question applicants are asked, where there is one
servertext- The server's domain
taglinetext- Its one-line description
taglineslist- The rotating notices it shows on its front page
urltext- Its home page
user_countnumber- How many accounts it holds
versiontext- The version of Lemmy it runs
Example output
{
"active_users_day": 4885,
"active_users_half_year": 22793,
"active_users_month": 12873,
"active_users_week": 8628,
"admin_handles": [
"@ruud@lemmy.world"
],
"admins": [
{
"avatar_url": "https://lemmy.world/pictrs/image/2f75baeb-34c1-4a8b-8d1e-bc0a52b47a62.png",
"banner_url": "https://lemmy.world/pictrs/image/2cddd018-5a89-4427-963a-025594190857.png",
"bio": "Admin of a lot of fediverse servers.\nSee my accounts on [Keyoxide](https://keyoxide.world/...",
"comment_count": 992,
"display_name": "Ruud",
"handle": "@ruud@lemmy.world",
"id": 2,
"is_admin": true,
"is_banned": false,
"is_bot": false,
"is_deleted": false,
"is_local": true,
"joined": "2023-06-01T07:01:45.388375Z",
"name": "ruud",
"origin_url": "https://lemmy.world/u/ruud",
"post_count": 128,
"server": "lemmy.world",
"url": "https://lemmy.world/u/ruud"
}
],
"banner_url": "https://lemmy.world/pictrs/image/d22b2935-f27b-49f0-81e7-c81c21088467.png",
"comment_count": 7031048,
"community_count": 13613,
"created": "2023-06-01T07:01:46.127298Z",
"description": "The World's Internet Frontpage \nLemmy.World is a general-purpose Lemmy instance of variou...",
"downvotes_enabled": true,
"federation_enabled": true,
"icon_url": "https://lemmy.world/pictrs/image/0fd47927-ca3a-4d2c-b2e4-a25353786671.png",
"is_private": false,
"legal_information": "## Lemmy.World Legal Info\nhttps://legal.lemmy.world\n\n## Lemmy.World Support\nVisit our supp...",
"name": "Lemmy.World",
"nsfw_allowed": true,
"post_count": 773652,
"post_languages": [
"Afaan Oromoo"
],
"registration": "Sign-ups need an application",
"registration_question": "`Welcome to Lemmy.World!`\n\n**Please agree to our [Terms of Service (TOS)](https://legal.le...",
"server": "lemmy.world",
"tagline": "A generic Lemmy server for everyone to use.",
"taglines": [
"**\ud83d\udc97 Community Spotlight \ud83d\udc97** [!newcommunities@lemmy.world](https://lemmy.world/c/newcommuni..."
],
"url": "https://lemmy.world",
"user_count": 198350,
"version": "0.19.19-9-gc55dd700c"
}List comments on a post
Read a post's discussion, in the order a person would read it: every reply follows the comment it answers, and each one says how deep it sits. 'How many' counts whole conversations rather than rows, so ten means the top ten threads with their replies attached, not ten comments cut out of the middle. Feed the result to a summarising step to get the gist of a hundred-comment thread in one line.
Inputs
- Post
posttextRequired - The post to read: its number, or its full address on the server this connection reads. Post numbers belong to the server that answers, so a link copied from a different Lemmy server is refused rather than quietly fetching an unrelated post - open the post on your own server and copy that link instead.
- Order
sorttext - What to put first. 'Hot' is what Lemmy shows when you open a post; 'Top' is the best-scoring opinions; 'Newest first' is what has just been said.One of:
Hot(Hot: the discussion as Lemmy shows it),Top(Top: highest scoring first),New(Newest first),Old(Oldest first),Controversial(Controversial: voted hard both ways). Default:Hot. - How much of each thread
depthtext - How far down the replies to read. 'Top-level comments only' is the quickest read of what a post provoked; 'The whole thread' is what Lemmy itself shows.One of:
1(Top-level comments only),2(Comments and their direct replies),4(Four levels deep),8(The whole thread). Default:8. - How many threads
limitnumber - How many top-level conversations to return, from 1 to 50. Their replies come with them and are not counted against this.From 1 to 50. Default:
10.
Outputs
comment_idslist- Just the comment numbers, ready for a later step
commentslist- The discussion in reading order: every reply follows what it answers, and 'depth' says how far in it sits
countnumber- How many comments came back
depthnumber- How deep the replies were read
limitnumber- How many threads were asked for
post_idnumber- The post that was read
post_urltext- That post's address
servertext- The Lemmy server that answered
sorttext- The order that was used
thread_countnumber- How many top-level comments those belong to
total_countnumber- How many comments the server returned before the cut
total_thread_countnumber- How many top-level comments the post has in all
Example output
{
"comment_ids": [
25819340
],
"comments": [
{
"author": {
"avatar_url": null,
"display_name": null,
"handle": "@boonhet@lemmy.zip",
"id": 23908729,
"is_admin": false,
"is_banned_from_community": false,
"is_bot": false,
"is_local": false,
"is_moderator": false,
"name": "boonhet",
"server": "lemmy.zip",
"url": "https://lemmy.world/u/boonhet@lemmy.zip"
},
"body": "I'm sure Bernie has good intentions but this is exactly what Altman and Amodei want and wh...",
"community": {
"handle": "!technology@lemmy.world",
"icon_url": "https://lemmy.world/pictrs/image/2a85bf08-5c07-4326-8dad-f549bfb2189e.png",
"id": 2478,
"is_local": true,
"is_nsfw": false,
"name": "technology",
"server": "lemmy.world",
"title": "Technology",
"url": "https://lemmy.world/c/technology"
},
"depth": 0,
"downvotes": 2,
"id": 25819340,
"is_deleted": false,
"is_from_moderator": false,
"is_removed": false,
"is_reply": false,
"language": "English",
"origin_url": "https://lemmy.zip/comment/28840268",
"parent_comment_id": null,
"post": {
"id": 51903676,
"title": "Bernie Sanders proposes 20 year prison sentence for AI devs who plow ahead with Artificial...",
"url": "https://lemmy.world/post/51903676"
},
"published": "2026-09-14T11:21:59.943446Z",
"reply_count": 27,
"score": 224,
"updated": null,
"upvotes": 226,
"url": "https://lemmy.world/comment/25819340"
}
],
"count": 7,
"depth": 2,
"limit": 1,
"post_id": 51903676,
"post_url": "https://lemmy.world/post/51903676",
"server": "lemmy.world",
"sort": "Top",
"thread_count": 1,
"total_count": 80,
"total_thread_count": 33
}List communities
Browse the communities your server carries, busiest or biggest first. Use it to find where a subject is discussed before you start watching it, or to keep a directory of the rooms your team cares about. Each one comes back with its handle, ready to paste into any other action here.
Inputs
- Order
sorttext - What to put first. 'Busiest this month' is the practical answer to 'where is the conversation happening'; 'Biggest of all time' is the most subscribed, which is not always the same thing.One of:
TopMonth(Busiest this month),TopWeek(Busiest this week),TopDay(Busiest today),TopAll(Biggest of all time),Active(Most active),Hot(Hot right now),New(Newest communities first),MostComments(Most comments). Default:TopMonth. - Where to look
listingtext - Whether to include communities on other servers. 'Everywhere' is everything your server can see, which is what makes Lemmy worth reading; 'This server only' is the communities it hosts itself. Lemmy also has 'Subscribed' and 'Moderator view', but both need an account logged in to the server - without one Lemmy quietly answers them with everything, so they are not offered.One of:
All(Everywhere: this server and every server it federates with),Local(This server only: communities hosted here). Default:All. - Include NSFW communities
include_nsfwtrue/false - Whether to include communities marked NSFW. Off by default.Default:
false. - How many
limitnumber - How many results to return, from 1 to 50. Lemmy refuses more than 50 in one request; use the page number for the next 50.From 1 to 50. Default:
10. - Page
pagenumber - Which page of results to return, counting from 1. Leave it empty for the first page. Pages are cut by the 'How many' setting, so page 2 with 50 per page is results 51 to 100.At least 1. Default:
1.
Outputs
communitieslist- The communities, in the order the sort put them
countnumber- How many came back
handleslist- Just their handles, ready to feed a later step
include_nsfwtrue/false- Whether NSFW communities were included
limitnumber- How many were asked for
listingtext- All or Local
pagenumber- The page that was read
servertext- The Lemmy server that answered
sorttext- The order that was used
Example output
{
"communities": [
{
"active_users_day": 3621,
"active_users_month": 15651,
"active_users_week": 8259,
"banner_url": "https://lemmy.world/pictrs/image/be818d42-f96f-4a33-b963-2a6e35938d54.png",
"comment_count": 950464,
"created": "2023-06-11T02:16:17.173483Z",
"description": "This is a [most excellent](https://media.giphy.com/media/v1.Y2lkPTc5MGI3NjExN3N0NmhuODNib3...",
"handle": "!technology@lemmy.world",
"icon_url": "https://lemmy.world/pictrs/image/2a85bf08-5c07-4326-8dad-f549bfb2189e.png",
"id": 2478,
"is_deleted": false,
"is_hidden": false,
"is_local": true,
"is_nsfw": false,
"is_removed": false,
"name": "technology",
"origin_url": "https://lemmy.world/c/technology",
"post_count": 21747,
"posting_restricted_to_mods": false,
"server": "lemmy.world",
"subscribers": 88039,
"title": "Technology",
"url": "https://lemmy.world/c/technology"
}
],
"count": 1,
"handles": [
"!technology@lemmy.world"
],
"include_nsfw": false,
"limit": 1,
"listing": "All",
"page": 1,
"server": "lemmy.world",
"sort": "TopMonth"
}List moderation actions
Read the public moderation log as one list of events in time order: posts removed, comments removed, people banned, moderators added, communities purged. Every entry says what happened, who did it, what it was about and the reason they gave, and carries a ready-made line to paste into a message. Use it to keep a record of what happens in a community you run, or to be told when something is removed.
Inputs
- Community
communitytext - Narrow to one community. The list is the busiest communities on your server, and you can type any other community's handle beside it, such as !linux@lemmy.ml. Leave it empty to read the whole server. Always include the @server part: a bare 'linux' means your own server's community of that name.
- Done by
moderatortext - Only actions taken by this moderator or admin. Their handle, profile address or id all work. Leave it empty for everybody.
- Only these kinds
actionstext - Which kinds of action to report. Choose nothing for all of them. Each kind covers the action and its reversal - 'Post removed or restored' returns both, and each event says which it was.One or more of:
ModRemovePost(Post removed or restored),ModLockPost(Post locked or unlocked),ModFeaturePost(Post pinned or unpinned),ModRemoveComment(Comment removed or restored),ModBanFromCommunity(Someone banned from a community),ModBan(Someone banned from the whole server),ModAddCommunity(Moderator added or removed),ModTransferCommunity(Community handed to a new owner),ModRemoveCommunity(Community removed or restored),ModHideCommunity(Community hidden or unhidden), and 5 more. - How many
limitnumber - How many events to return, newest first, from 1 to 50.From 1 to 50. Default:
10.
Outputs
action_typeslist- The kinds of action that were asked for
actionslist- The events, newest first
communitytext- The community it was narrowed to, if any
countnumber- How many events came back
descriptionslist- Just the readable lines, ready to paste into a message
limitnumber- How many were asked for
moderator_idnumber- The moderator it was narrowed to, if any
servertext- The Lemmy server that answered
total_foundnumber- How many the server returned before the cut to the limit
Example output
{
"action_types": [],
"actions": [
{
"action": "Post removed",
"comment": null,
"community": {
"handle": "!technology@lemmy.world",
"icon_url": "https://lemmy.world/pictrs/image/2a85bf08-5c07-4326-8dad-f549bfb2189e.png",
"id": 2478,
"is_local": true,
"is_nsfw": false,
"name": "technology",
"server": "lemmy.world",
"title": "Technology",
"url": "https://lemmy.world/c/technology"
},
"description": "Post removed by @L4s@lemmy.world - 'hello world' in !technology@lemmy.world (AutoMod rule...",
"expires": null,
"is_admin_action": false,
"moderator": {
"avatar_url": "https://lemmy.world/pictrs/image/7c668ec0-a3ad-455f-b736-1f5f13808b09.png",
"display_name": "L4sBot",
"handle": "@L4s@lemmy.world",
"id": 350808,
"is_admin": false,
"is_banned_from_community": false,
"is_bot": true,
"is_local": true,
"is_moderator": false,
"name": "L4s",
"server": "lemmy.world",
"url": "https://lemmy.world/u/L4s"
},
"person": null,
"post": {
"id": 51927456,
"title": "hello world",
"url": "https://lemmy.world/post/51927456"
},
"reason": "AutoMod rule triggered",
"reverted": false,
"type": "ModRemovePost",
"when": "2026-09-15T00:57:58.676508Z"
}
],
"community": "!technology@lemmy.world",
"count": 1,
"descriptions": [
"Post removed by @L4s@lemmy.world - 'hello world' in !technology@lemmy.world (AutoMod rule..."
],
"limit": 1,
"moderator_id": null,
"server": "lemmy.world",
"total_found": 6
}List posts
Read a feed of posts: one community's, or everything your server can see. Each post comes back with its title, its text, the link it points at, its score, its comment count and its author's handle, plus its own address so a later step can link to it. Sort by what is busy, what is new or what is top this week. Set 'Only what is newer than' to the newest post from your last run and a scheduled workflow will only ever see what it has not seen before.
Inputs
- Community
communitytext - Narrow to one community. The list is the busiest communities on your server, and you can type any other community's handle beside it, such as !linux@lemmy.ml. Leave it empty to read the whole server. Always include the @server part: a bare 'linux' means your own server's community of that name.
- Order
sorttext - What to put first. 'Active' is Lemmy's own front-page order. Choose 'Newest first' for anything that has to catch every post, because that is the only order in which a page is a window in time.One of:
Active(Active: busiest discussions first),Hot(Hot: rising right now),New(Newest first),Scaled(Scaled: hot, but fairer to small communities),TopDay(Top today),TopWeek(Top this week),TopMonth(Top this month),TopYear(Top this year),TopAll(Top of all time),MostComments(Most comments),NewComments(Most recently replied to),Controversial(Controversial: voted hard both ways). Default:Active. - Where to look
listingtext - Whether to include communities on other servers. 'Everywhere' is everything your server can see, which is what makes Lemmy worth reading; 'This server only' is the communities it hosts itself. Lemmy also has 'Subscribed' and 'Moderator view', but both need an account logged in to the server - without one Lemmy quietly answers them with everything, so they are not offered.One of:
All(Everywhere: this server and every server it federates with),Local(This server only: communities hosted here). Default:All. - Only what is newer than
posted_afterdate and time - Only return things published after this moment. This is how a scheduled workflow avoids re-reading what it has already seen: keep the newest 'published' value from the last run and feed it back in here. Leaving it empty returns everything on the page. Setting it sorts newest-first unless you choose another order, because no other order makes 'since' mean anything.
- How many
limitnumber - How many results to return, from 1 to 50. Lemmy refuses more than 50 in one request; use the page number for the next 50.From 1 to 50. Default:
10. - Page
pagenumber - Which page of results to return, counting from 1. Leave it empty for the first page. Pages are cut by the 'How many' setting, so page 2 with 50 per page is results 51 to 100.At least 1. Default:
1.
Outputs
communitytext- The community that was read, empty for the whole server
countnumber- How many posts came back
fetched_countnumber- How many the server returned before the 'newer than' cut
limitnumber- How many were asked for
listingtext- All or Local
may_have_moretrue/false- True when the 'newer than' filter kept a whole page, which is the one case where an older post may have been left behind - ask for more per page, or run the workflow more often
pagenumber- The page that was read
post_idslist- Just the post numbers, ready for a later step
post_urlslist- Just the post addresses
posted_aftertext- The cut-off that was applied, if any
postslist- The posts, in the order the sort put them
servertext- The Lemmy server that answered
sorttext- The order that was used
Example output
{
"community": "!technology@lemmy.world",
"count": 1,
"fetched_count": 1,
"limit": 1,
"listing": "All",
"may_have_more": false,
"page": 1,
"post_ids": [
51903676
],
"post_urls": [
"https://lemmy.world/post/51903676"
],
"posted_after": null,
"posts": [
{
"author": {
"avatar_url": "https://thelemmy.club/pictrs/image/66364803-7fc3-4442-afcb-ef74f4b3d5a6.png",
"display_name": null,
"handle": "@Mustachius_Grumpius@thelemmy.club",
"id": 24283634,
"is_admin": false,
"is_banned_from_community": false,
"is_bot": false,
"is_local": false,
"is_moderator": false,
"name": "Mustachius_Grumpius",
"server": "thelemmy.club",
"url": "https://lemmy.world/u/Mustachius_Grumpius@thelemmy.club"
},
"body": null,
"comment_count": 150,
"community": {
"handle": "!technology@lemmy.world",
"icon_url": "https://lemmy.world/pictrs/image/2a85bf08-5c07-4326-8dad-f549bfb2189e.png",
"id": 2478,
"is_local": true,
"is_nsfw": false,
"name": "technology",
"server": "lemmy.world",
"title": "Technology",
"url": "https://lemmy.world/c/technology"
},
"downvotes": 19,
"id": 51903676,
"image_url": "https://lemmy.world/pictrs/image/933fb8ad-19d0-4d39-9e73-4d6a29f1f5e9.jpeg",
"is_deleted": false,
"is_local": false,
"is_locked": false,
"is_nsfw": false,
"is_pinned_in_community": false,
"is_pinned_on_server": false,
"is_removed": false,
"language": "English",
"last_comment_at": "2026-09-15T07:50:57.288624Z",
"link": "https://www.tomshardware.com/tech-industry/artificial-intelligence/sanders-proposes-20-yea...",
"link_description": "Scale of penalty matches that facing rogue nuclear weapon designers.",
"link_title": "Bernie Sanders proposes 20 year prison sentence for AI devs who plow ahead with Artificial...",
"origin_url": "https://thelemmy.club/post/55903506",
"published": "2026-09-14T10:54:19.145096Z",
"score": 999,
"thumbnail_url": "https://lemmy.world/pictrs/image/933fb8ad-19d0-4d39-9e73-4d6a29f1f5e9.jpeg",
"title": "Bernie Sanders proposes 20 year prison sentence for AI devs who plow ahead with Artificial...",
"updated": null,
"upvotes": 1018,
"url": "https://lemmy.world/post/51903676"
}
],
"server": "lemmy.world",
"sort": "TopDay"
}Search Lemmy
Search your server and everything it federates with, for posts, comments, communities or people. This is the brand- and topic-monitoring step: search your product's name, narrow to a community or an author, set 'Only what is newer than' to the last run, and a scheduled workflow reports only what is new. Leaving the text empty is allowed and useful - an empty search of one community, newest first, is 'what has just been said in here'.
Inputs
- Search for
querytext - The words to look for. Leave it empty to get everything, which only makes sense alongside a community and a newest-first order.
- Look for
look_fortext - What kind of thing to find. 'Posts linking to a web address' searches the links posts point at rather than their words, which is how to find who has shared a particular page.One of:
posts,comments,communities,people,url(Posts linking to a web address),everything(Everything at once). Default:posts. - Community
communitytext - Narrow to one community. The list is the busiest communities on your server, and you can type any other community's handle beside it, such as !linux@lemmy.ml. Leave it empty to read the whole server. Always include the @server part: a bare 'linux' means your own server's community of that name.
- Written by
authortext - Only things written by this person. Their handle (@ruud@lemmy.world), their profile address or their id all work. Leave it empty for everybody.
- Order
sorttext - What to put first. 'Top of all time' surfaces the best-known matches; 'Newest first' is what you want for monitoring.One of:
Active(Active: busiest discussions first),Hot(Hot: rising right now),New(Newest first),Scaled(Scaled: hot, but fairer to small communities),TopDay(Top today),TopWeek(Top this week),TopMonth(Top this month),TopYear(Top this year),TopAll(Top of all time),MostComments(Most comments),NewComments(Most recently replied to),Controversial(Controversial: voted hard both ways). Default:TopAll. - Where to look
listingtext - Whether to include communities on other servers. 'Everywhere' is everything your server can see, which is what makes Lemmy worth reading; 'This server only' is the communities it hosts itself. Lemmy also has 'Subscribed' and 'Moderator view', but both need an account logged in to the server - without one Lemmy quietly answers them with everything, so they are not offered.One of:
All(Everywhere: this server and every server it federates with),Local(This server only: communities hosted here). Default:All. - Only what is newer than
posted_afterdate and time - Only return things published after this moment. This is how a scheduled workflow avoids re-reading what it has already seen: keep the newest 'published' value from the last run and feed it back in here. Leaving it empty returns everything on the page. Setting it sorts newest-first unless you choose another order, because no other order makes 'since' mean anything.
- How many
limitnumber - How many results to return, from 1 to 50. Lemmy refuses more than 50 in one request; use the page number for the next 50.From 1 to 50. Default:
10. - Page
pagenumber - Which page of results to return, counting from 1. Leave it empty for the first page. Pages are cut by the 'How many' setting, so page 2 with 50 per page is results 51 to 100.At least 1. Default:
1.
Outputs
author_idnumber- The person it was narrowed to, if any
comment_countnumber- How many comments matched
commentslist- Matching comments
communitieslist- Matching communities
communitytext- The community it was narrowed to, if any
community_countnumber- How many communities matched
countnumber- How many matches in all
foundtrue/false- True when anything matched
limitnumber- How many were asked for
listingtext- All or Local
looked_fortext- What was searched for: Posts, Comments, Communities, Users, Url or All
pagenumber- The page that was read
peoplelist- Matching people
people_countnumber- How many people matched
post_countnumber- How many posts matched
posted_aftertext- The cut-off that was applied, if any
postslist- Matching posts, empty unless posts were looked for
querytext- The text that was searched for
servertext- The Lemmy server that answered
sorttext- The order that was used
Example output
{
"author_id": null,
"comment_count": 1,
"comments": [
{
"author": {
"avatar_url": null,
"display_name": null,
"handle": "@kadu@lemmy.world",
"id": 52906,
"is_admin": false,
"is_banned_from_community": false,
"is_bot": false,
"is_local": true,
"is_moderator": false,
"name": "kadu",
"server": "lemmy.world",
"url": "https://lemmy.world/u/kadu"
},
"body": "What I find most ridiculous about people claiming lemmy.world is too big and therefore bad...",
"community": {
"handle": "!lemmyworld@lemmy.world",
"icon_url": "https://lemmy.world/pictrs/image/f3189f30-f8c8-4c4f-b957-e3a7bfd1c784.png",
"id": 5,
"is_local": true,
"is_nsfw": false,
"name": "lemmyworld",
"server": "lemmy.world",
"title": "Lemmy.World Announcements",
"url": "https://lemmy.world/c/lemmyworld"
},
"depth": 0,
"downvotes": 12,
"id": 2244187,
"is_deleted": false,
"is_from_moderator": false,
"is_removed": false,
"is_reply": false,
"language": null,
"origin_url": "https://lemmy.world/comment/2244187",
"parent_comment_id": null,
"post": {
"id": 2923697,
"title": "Lemmy World outages",
"url": "https://lemmy.world/post/2923697"
},
"published": "2023-08-09T17:33:53.726346Z",
"reply_count": 41,
"score": 1034,
"updated": null,
"upvotes": 1046,
"url": "https://lemmy.world/comment/2244187"
}
],
"communities": [
{
"active_users_day": 1,
"active_users_month": 60,
"active_users_week": 1,
"banner_url": null,
"comment_count": 1083,
"created": "2019-04-25T07:48:39.940802Z",
"description": null,
"handle": "!rust@lemmy.ml",
"icon_url": "https://lemmy.ml/pictrs/image/oHAh2Yu3zC.png",
"id": 380,
"is_deleted": false,
"is_hidden": false,
"is_local": false,
"is_nsfw": false,
"is_removed": false,
"name": "rust",
"origin_url": "https://lemmy.ml/c/rust",
"post_count": 387,
"posting_restricted_to_mods": false,
"server": "lemmy.ml",
"subscribers": 9377,
"title": "Rust Programming",
"url": "https://lemmy.world/c/rust@lemmy.ml"
}
],
"community": null,
"community_count": 1,
"count": 4,
"found": true,
"limit": 1,
"listing": "All",
"looked_for": "All",
"page": 1,
"people": [
{
"avatar_url": "https://lemmy.world/pictrs/image/71249f16-cdce-4d7d-af8d-b48a08f6ed44.jpeg",
"banner_url": "https://lemmy.world/pictrs/image/df7ed039-2d4f-4797-b616-339420444c92.jpeg",
"bio": "Alt: @rustyfish@piefed.world",
"comment_count": 2422,
"display_name": null,
"handle": "@rustyfish@lemmy.world",
"id": 638058,
"is_admin": false,
"is_banned": false,
"is_bot": false,
"is_deleted": false,
"is_local": true,
"joined": "2023-07-02T09:41:43.318831Z",
"name": "rustyfish",
"origin_url": "https://lemmy.world/u/rustyfish",
"post_count": 8,
"server": "lemmy.world",
"url": "https://lemmy.world/u/rustyfish"
}
],
"people_count": 1,
"post_count": 1,
"posted_after": null,
"posts": [
{
"author": {
"avatar_url": "https://infosec.pub/pictrs/image/b6c873d8-059f-49c1-89e9-d1d7e86cf461.png",
"display_name": "sapient [they/them]",
"handle": "@sapient_cogbag@infosec.pub",
"id": 80007,
"is_admin": false,
"is_banned_from_community": false,
"is_bot": false,
"is_local": false,
"is_moderator": false,
"name": "sapient_cogbag",
"server": "infosec.pub",
"url": "https://lemmy.world/u/sapient_cogbag@infosec.pub"
},
"body": "I strongly encourage instance admins to defederate from Facebook/Threads/Meta.\n\nThey aren'...",
"comment_count": 524,
"community": {
"handle": "!fediverse@lemmy.world",
"icon_url": "https://lemmy.world/pictrs/image/eb9cfeb5-4eb5-4b1b-a75c-8d9e04c3f856.png",
"id": 2,
"is_local": true,
"is_nsfw": false,
"name": "fediverse",
"server": "lemmy.world",
"title": "Fediverse",
"url": "https://lemmy.world/c/fediverse"
},
"downvotes": 155,
"id": 1110170,
"image_url": null,
"is_deleted": false,
"is_local": false,
"is_locked": false,
"is_nsfw": false,
"is_pinned_in_community": false,
"is_pinned_on_server": false,
"is_removed": false,
"language": null,
"last_comment_at": "2026-07-05T02:47:45.681585Z",
"link": "https://ploum.net/2023-06-23-how-to-kill-decentralised-networks.html",
"link_description": "How to Kill a Decentralised Network (such as the Fediverse) \u00e9crit par Ploum, Lionel Dricot...",
"link_title": "How to Kill a Decentralised Network (such as the Fediverse)",
"origin_url": "https://infosec.pub/post/400702",
"published": "2023-07-06T20:09:58.664474Z",
"score": 3724,
"thumbnail_url": "https://infosec.pub/pictrs/image/6d018a62-b15d-49c7-a2f2-12ac2cc8e6a9.jpeg",
"title": "Why Defederating from Facebook/Meta is So Important",
"updated": "2023-07-07T03:08:37.660752Z",
"upvotes": 3879,
"url": "https://lemmy.world/post/1110170"
}
],
"query": "rust",
"server": "lemmy.world",
"sort": "TopAll"
}