Search and list links
search_linksFind and filter bookmarks by title, URL, description, or tag. Lists all links when no query is given, with pagination and optional filters by collection or tag.
Instructions
Searches bookmarks, or lists them when no query is given. This is the way to find links — there is no separate list tool, and the older /links listing route is deprecated upstream.
Plain text matches the title, URL, description and tag names of a link.
IMPORTANT: the field-filter syntax below only works on instances that run
Meilisearch. Linkwarden parses those filters exclusively in its Meilisearch
branch; without it the whole query is matched as one literal substring, so
tag:news searches for the characters "tag:news" and finds nothing. Use the
collection_id, tag_id and pinned_only arguments instead — those are applied by
the database and work either way. list_collections and list_tags give you the ids.
Where Meilisearch is available the filters are: url: name: description: type: collection: tag: pinned: public: before: after: Quote values that contain spaces, e.g. collection:"Read later". Prefix a filter with ! to negate it, e.g. !tag:archive. pinned: and public: take true or false; before: and after: take a date such as 2026-01-31. If the instance sets SEARCH_FILTER_LIMIT, field filters beyond that count are dropped silently, so prefer few, specific filters.
Returns at most 100 links plus a next_cursor for the following page. Article text is not included; use get_link_content for that.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Sort order, default date_newest | |
| query | No | Search query, see the syntax above. Omit to list links. | |
| cursor | No | Opaque pagination cursor. Pass back the "next_cursor" value from a previous result verbatim; do not compute or increment it — depending on whether the instance runs Meilisearch it is either a row offset or the last id seen. | |
| tag_id | No | Restrict the result to this tag | |
| pinned_only | No | Only return links pinned by the authenticated account | |
| collection_id | No | Restrict the result to this collection |