Search Lemmy instance
Search Lemmy posts, comments, communities, users or exact URLs; All and Comments can take longer.
Headers
Get your API keyAPI key (`sfk_...`)
The Lemmy instance, e.g. `lemmy.world`. A URL on the instance is also accepted. Ids and counts belong to this instance.
Search term, 1 to 300 characters, in any language. Required, never empty and no control characters.
min 1 chars · max 300 chars
`Posts` (default), `All` (every kind), `Comments` (comment text), `Communities`, `Users` or `Url` (posts linking to an exact URL). `All` and `Comments` can take much longer than the other kinds.
one of: All, Comments, Posts, Communities, Users, Url
Order. `Scaled` and `Controversial` are refused by 0.18 instances.
one of: Active, Hot, New, Old, TopHour, TopSixHour, TopTwelveHour, TopDay, TopWeek, TopMonth, TopThreeMonths, TopSixMonths, TopNineMonths, TopYear, TopAll, MostComments, NewComments, Controversial, Scaled
Community name, e.g. `technology`, or `technology@lemmy.world` to resolve a community on another instance. Prefer the community's home instance for counts.
Restrict to one author, by username.
`local` reads only this instance's own items; `all` includes federated items the instance has seen. Default: the endpoint's own listing.
one of: local, all
Page number, 1 to 100. Default: 1. An instance refuses pages past 100. Lemmy pages by number over a live order, so new or re-ranked items can shift a row onto the next page. Remove repeats by `id`.
≥ 1 · ≤ 100
Pass `page.nextCursor` from the previous response to get the next page. It only works with the same filters; do not send it with `page`.
min 1 chars · max 2048 chars
Rows per page, 1 to 50. Default: 10.
≥ 1 · ≤ 50
Endpoint-specific response payload.
`found`, `not_found` (the entity is missing, or the host name does not resolve), `private` (the instance does not allow public lists) or `not_compatible` (the host is not a Lemmy instance, or its version does not serve this operation). See `reason`.
one of: found, not_found, private, not_compatible
The instance that was asked.
Why `lookupStatus` is not `found`, or null when it is `found`.
Machine-readable reason.
one of: instance_private, not_a_lemmy_instance, not_available, deleted, host_not_found
Plain-language explanation.
The result kind, as Lemmy names it.
Matching posts.
Post id on this instance.
Canonical ActivityPub id.
Post title.
Link the post points at; null for a text post.
Content type of the link.
Thumbnail URL.
Whether the post is NSFW.
Whether the post is locked.
Whether a moderator removed it.
Whether it was deleted.
When it was posted.
When it last changed.
Discussion language id.
Whether it was posted on the instance asked.
Votes up minus votes down.
Upvotes.
Downvotes.
Comments on the post.
The community it was posted in, with the counts the single-post answer carries.
Community id on this instance.
Community name without the host.
Display title.
Canonical ActivityPub id.
Host the community lives on.
`name@host`.
Community icon URL.
Whether the community is NSFW.
Whether the community lives on the instance asked.
Description as Markdown.
Banner URL.
When the community was created.
When the community last changed.
Whether a moderator removed the community.
Whether the community was deleted.
Whether the community is hidden.
Whether only moderators may post.
`Public` or another visibility the instance reports.
Subscribers.
Subscribers on the community's own instance.
Posts in the community.
Comments in the community.
Active users in the community.
Active users today.
Active users this week.
Active users this month.
Active users in the last six months.
Moderators; null on list rows, which do not carry them.
User id on this instance.
Username without the host.
Display name.
Profile text as Markdown.
Avatar URL.
Banner URL.
Canonical ActivityPub id.
Host the account lives on.
`user@host`.
When the account was created.
When the profile last changed.
Whether the account is banned.
When the ban ends.
Whether the account was deleted.
Whether the account is a bot.
Whether the account lives on the instance asked.
Matrix id the user chose to publish.
Discussion language ids; null on rows that do not carry them. The instance endpoint maps ids to language codes.
Who posted it; null on a modlog row, which does not carry the creator.
User id on this instance.
Username without the host.
Display name.
Profile text as Markdown.
Avatar URL.
Banner URL.
Canonical ActivityPub id.
Host the account lives on.
`user@host`.
When the account was created.
When the profile last changed.
Whether the account is banned.
When the ban ends.
Whether the account was deleted.
Whether the account is a bot.
Whether the account lives on the instance asked.
Matrix id the user chose to publish.
Post text as Markdown.
Link preview; null when the instance found none.
Embedded page title.
Embedded page description.
Embedded video URL.
Alt text for the image.
Image details; null when the post has no image.
Image URL.
Width in pixels.
Height in pixels.
Media type.
Whether it is featured in its community.
Whether it is featured on the instance.
When the newest comment was made.
Whether the author is an instance administrator.
Whether the author moderates the community.
Whether the author is banned from the community.
Posts of the same link in other communities; null on list rows.
Post id on this instance.
Canonical ActivityPub id.
Post title.
Link the post points at; null for a text post.
Content type of the link.
Thumbnail URL.
Whether the post is NSFW.
Whether the post is locked.
Whether a moderator removed it.
Whether it was deleted.
When it was posted.
When it last changed.
Discussion language id.
Whether it was posted on the instance asked.
Votes up minus votes down.
Upvotes.
Downvotes.
Comments on the post.
The community it was posted in.
Community id on this instance.
Community name without the host.
Display title.
Canonical ActivityPub id.
Host the community lives on.
`name@host`.
Community icon URL.
Whether the community is NSFW.
Whether the community lives on the instance asked.
Who posted it; null on a modlog row, which does not carry the creator.
User id on this instance.
Username without the host.
Display name.
Profile text as Markdown.
Avatar URL.
Banner URL.
Canonical ActivityPub id.
Host the account lives on.
`user@host`.
When the account was created.
When the profile last changed.
Whether the account is banned.
When the ban ends.
Whether the account was deleted.
Whether the account is a bot.
Whether the account lives on the instance asked.
Matrix id the user chose to publish.
Moderators of the community; null on list rows, which do not carry them.
User id on this instance.
Username without the host.
Display name.
Profile text as Markdown.
Avatar URL.
Banner URL.
Canonical ActivityPub id.
Host the account lives on.
`user@host`.
When the account was created.
When the profile last changed.
Whether the account is banned.
When the ban ends.
Whether the account was deleted.
Whether the account is a bot.
Whether the account lives on the instance asked.
Matrix id the user chose to publish.
Matching comments.
Comment id on this instance.
Canonical ActivityPub id.
Comment text as Markdown; empty when a moderator removed it or its author deleted it.
The post it belongs to.
The dotted ancestor chain, from the root post (`0.1234.5678`).
Depth in the tree, from `path`.
The comment it replies to; null for a top-level comment.
Whether a moderator marked it as a moderator comment.
Discussion language id.
Whether it was written on the instance asked.
Whether a moderator removed it.
Whether its author deleted it.
When it was written.
When it last changed.
Votes up minus votes down.
Upvotes.
Downvotes.
Direct replies.
Whether the author is an instance administrator.
Whether the author moderates the community.
Whether the author is banned from the community.
The post it belongs to.
Post id on this instance.
Canonical ActivityPub id.
Post title.
Link the post points at; null for a text post.
Content type of the link.
Thumbnail URL.
Whether the post is NSFW.
Whether the post is locked.
Whether a moderator removed it.
Whether it was deleted.
When it was posted.
When it last changed.
Discussion language id.
Whether it was posted on the instance asked.
Votes up minus votes down.
Upvotes.
Downvotes.
Comments on the post.
The community it was posted in.
Community id on this instance.
Community name without the host.
Display title.
Canonical ActivityPub id.
Host the community lives on.
`name@host`.
Community icon URL.
Whether the community is NSFW.
Whether the community lives on the instance asked.
Who posted it; null on a modlog row, which does not carry the creator.
User id on this instance.
Username without the host.
Display name.
Profile text as Markdown.
Avatar URL.
Banner URL.
Canonical ActivityPub id.
Host the account lives on.
`user@host`.
When the account was created.
When the profile last changed.
Whether the account is banned.
When the ban ends.
Whether the account was deleted.
Whether the account is a bot.
Whether the account lives on the instance asked.
Matrix id the user chose to publish.
The community of the post.
Community id on this instance.
Community name without the host.
Display title.
Canonical ActivityPub id.
Host the community lives on.
`name@host`.
Community icon URL.
Whether the community is NSFW.
Whether the community lives on the instance asked.
Who wrote it.
User id on this instance.
Username without the host.
Display name.
Profile text as Markdown.
Avatar URL.
Banner URL.
Canonical ActivityPub id.
Host the account lives on.
`user@host`.
When the account was created.
When the profile last changed.
Whether the account is banned.
When the ban ends.
Whether the account was deleted.
Whether the account is a bot.
Whether the account lives on the instance asked.
Matrix id the user chose to publish.
Matching communities.
Community id on this instance.
Community name without the host.
Display title.
Canonical ActivityPub id.
Host the community lives on.
`name@host`.
Community icon URL.
Whether the community is NSFW.
Whether the community lives on the instance asked.
Description as Markdown.
Banner URL.
When the community was created.
When the community last changed.
Whether a moderator removed the community.
Whether the community was deleted.
Whether the community is hidden.
Whether only moderators may post.
`Public` or another visibility the instance reports.
Subscribers.
Subscribers on the community's own instance.
Posts in the community.
Comments in the community.
Active users in the community.
Active users today.
Active users this week.
Active users this month.
Active users in the last six months.
Moderators; null on list rows, which do not carry them.
User id on this instance.
Username without the host.
Display name.
Profile text as Markdown.
Avatar URL.
Banner URL.
Canonical ActivityPub id.
Host the account lives on.
`user@host`.
When the account was created.
When the profile last changed.
Whether the account is banned.
When the ban ends.
Whether the account was deleted.
Whether the account is a bot.
Whether the account lives on the instance asked.
Matrix id the user chose to publish.
Discussion language ids; null on rows that do not carry them. The instance endpoint maps ids to language codes.
Matching users with the same profile fields as user.get, including avatar, join date, post and comment counts and the admin flag.
User id on this instance.
Username without the host.
Display name.
Profile text as Markdown.
Avatar URL.
Banner URL.
Canonical ActivityPub id.
Host the account lives on.
`user@host`.
When the account was created.
When the profile last changed.
Whether the account is banned.
When the ban ends.
Whether the account was deleted.
Whether the account is a bot.
Whether the account lives on the instance asked.
Matrix id the user chose to publish.
Posts the user has made.
Comments the user has made.
Combined score of the user's posts, when the instance reports it.
Combined score of the user's comments, when the instance reports it.
Whether the user is an instance administrator.
Communities the user moderates; null when the answer did not carry them.
Community id on this instance.
Community name without the host.
Display title.
Canonical ActivityPub id.
Host the community lives on.
`name@host`.
Community icon URL.
Whether the community is NSFW.
Whether the community lives on the instance asked.
Pagination state for the current page.
Current page number. Lemmy pages by number over a live order, so new or re-ranked items can shift a row onto the next page. Remove repeats by `id`.
≥ 0
Whether a full page came back, so another page may exist. A last page that exactly fills the limit still sets true, and the next page is then empty.
Next page number; null when this page was short, so the list ended.
≥ 0
Cursor to pass in the next request; null when this page was short. It only works with the same filters.
True when a full page stopped at the instance's 100-page ceiling and rows may remain. False when the list ended because it ran out.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/lemmy/search?instance=lemmy.world&query=linux" \
-H "x-api-key: YOUR_API_KEY"Responses
Search results.