Search

Search bookmarks

Search whole bookmarks or rank individual images by their AI vision captions, using the same hybrid semantic + keyword engine as the web app. Image-ranked pages include tileOrder entries with bookmarkId, ref, and caption. Ranking covers the top 200 fused candidates — narrow with filters rather than paging deep. Cursors are bound to their query/filters/state; reusing one with different inputs returns 422.

post/v1/search

Request

  • Base URL: https://stashr.me
  • URL: https://stashr.me/v1/search
  • Auth: HTTP bearer

Request body

cursorstring

nextCursor value from the previous page of the same search

limitinteger
querystring required

What to look for, 1 to 200 characters

rankMode'post' | 'image'

post ranks whole bookmarks; image ranks individual images by caption

state'active' | 'archived' | 'all'
view'full' | 'summary'

summary returns a compact page (bounded snippets, no raw content) — prefer it for agent discovery

Response

One page of ranked results (full or summary view)

Changes

No recorded changes to this operation across all 1 revision of this API.