hydrant implements a subset of microcosm constellation when it's built with the backlinks cargo feature (cargo build --features backlinks).
when enabled, hydrant indexes all AT URI and DID references found inside stored records into a reverse index. this lets you efficiently answer "what records link to this subject?".
blue.microcosm.links.getBacklinks
return records that link to a given subject.
| param | required | description |
|---|---|---|
subject |
yes | AT URI or DID to look up backlinks for. |
source |
no | filter by source collection, e.g. app.bsky.feed.like. also accepts collection:path form to further filter by field path, e.g. app.bsky.feed.like:subject.uri. the path is matched against the dotted field path within the record (. is prepended automatically). |
did |
no | filter links to those from specific users. |
limit |
no | max results to return (default 50, max 100). |
cursor |
no | opaque pagination cursor from a previous response. |
reverse |
no | if true, return results in reverse order (default false). |
returns { backlinks: [{ uri, cid }], cursor? }. links from an account that's takendown, suspended, deactivated or deleted are left out, so a page can hold fewer than limit.
results are ordered by source record rkey (ascending by default, descending when reverse=true). the cursor is stable across new insertions for TID rkey records.
blue.microcosm.links.getBacklinksCount
return the number of records that link to a given subject.
| param | required | description |
|---|---|---|
subject |
yes | AT URI or DID to count backlinks for. |
source |
no | filter by source collection (same format as getBacklinks). |
returns { count }. this counts every stored link, including ones getBacklinks leaves out for an inactive account.