EveryData platform API
Lemmy API
This Lemmy reference organizes Lemmy community posts, instance feeds, and comments grouped beneath community posts into 4 concrete operations—`search`, `community`, `feed` among them—so shared parameter names do not blur object types.
Read matching public results through Lemmy `search` and a single community record through `community`; `search` uses `keyword`, while `community` uses the community name, and every later action follows the same scope separation.
- Endpoint
- POST /api/v1/social
- Capabilities
- 4
- Per 1,000
- $1.389
Available capabilities
Compare the Lemmy actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Search public results on Lemmy. Accepts these parameters: | keyword | — | Sync delivery | Catalog values: defaultLimit=20, maxLimit=200. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · 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 |
communityCommunity Use the | community | — | Sync delivery | Catalog values: defaultLimit=20, maxLimit=200. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · 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 |
feedFeed Retrieve public feed posts from Lemmy. Requires no parameters. Returns these fields: | — | Sync delivery | Catalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · 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 | |
commentsComments Retrieve public comments from Lemmy. Accepts these parameters: | community | comment_limit, max_comments | Sync delivery | Catalog values: defaultLimit=10, maxLimit=200. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · text · author_username · author_url · score · upvote_count · downvote_count · depth · parent_comment_id · is_deleted · post_url · post_title · community · posted_at · platform |
What does each Lemmy action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
What do the Lemmy search parameters mean?
Search public results on Lemmy. Accepts these parameters: keyword. Returns these fields: external_url, author_username, body, and community.
keywordRequired- Specifies the search term for the Lemmy search action, which executes on the designated instance rather than guaranteeing a complete search across all federated instances.Lemmy: Instance Visibility Does Not Equal the Entire FediverseOfficial onboarding guides explain that instances are managed by distinct operators; standard browsing displays only communities known to the local instance, while cross-instance objects must be resolved separately. This context explains instance perspectives and post objects, without mirroring full web search functionality into gateway parameters.Checked
What do the Lemmy community parameters mean?
Use the community action on Lemmy. Accepts these parameters: community. Returns these fields: community, downvote_count, community_url, and instance.
communityRequired- Specifies the community name or the cross-instance identifier in name@instance format. In the community action, it lists community posts; in the comments action, it fetches posts from the community and expands their comments rather than querying a single post URL directly.Lemmy: Community Identifiers and Cross-Instance AccessOfficial guides present community URLs and the !name@instance identifier format while distinguishing between local and federated communities. EveryInfra specifies this parameter as name or name@instance; the ! prefix and URL formats from the official UI are not automatically supported by this interface.Checked
What do the Lemmy feed parameters mean?
Retrieve public feed posts from Lemmy. Requires no parameters. Returns these fields: is_nsfw, comment_count, is_featured, and external_url.
This action has no business parameters. Send only the platform and action identifiers.
What do the Lemmy comments parameters mean?
Retrieve public comments from Lemmy. Accepts these parameters: max_comments, community, and comment_limit. Returns these fields: author_username, author_url, community, and depth.
communityRequired- Specifies the community name or the cross-instance identifier in name@instance format. In the community action, it lists community posts; in the comments action, it fetches posts from the community and expands their comments rather than querying a single post URL directly.
comment_limitOptional- Serves as a compatibility alias for max_comments to set the maximum comment limit per post, read when max_comments is omitted. It does not guarantee that every post contains this many publicly accessible comments.
max_commentsOptional- Sets the maximum number of comments to fetch per post in the comments action, defaulting to 50 with an allowed range of 1 to 200. It limits comments per post rather than total posts or total comments for the request, takes precedence over comment_limit, and automatically clamps values outside the allowed range.Lemmy: Nested Comment Hierarchies and Limit BoundariesOfficial documentation explains top-level comments, nested reply hierarchies, and score calculations (upvotes minus downvotes). EveryInfra per-post comment limits represent an independent contract, not official sorting options; hitting a limit does not guarantee complete inclusion of all parent and child nodes.Checked
How to use the Lemmy API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result or poll the returned job ID when the selected action is asynchronous.
- 04Store the structured response fields needed by your application.
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>"}}'
Lemmy API questions
What can I retrieve with the Lemmy API?
Set platform to lemmy. The current catalog lists search, community, feed, and comments. These action names identify different Lemmy objects or views; they are not interchangeable search modes.
Which input starts a Lemmy `search` request?
Specifies the search term for the Lemmy search action, which executes on the designated instance rather than guaranteeing a complete search across all federated instances. Send it as keyword inside params.
Which fields can Lemmy `search` return?
Its declared schema includes title, body, external_url, and community. A declared field can still be absent from an individual source record, and every other action has its own field list.
Does every Lemmy action return immediately?
No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.