blue.microcosm.links.getBacklinks

microcosm.blue

Documentation

a list of records linking to any record, identity, or uri

main query

a list of records linking to any record, identity, or uri

Parameters

did array of string Optional

filter links to those from specific users

limit integer Optional

number of results to return

source string Required

collection and path specification (e.g., 'app.bsky.feed.like:subject.uri')

subject string uri Required

the target being linked to (at-uri, did, or uri)

Output

Encodingapplication/json
cursor string Optional

pagination cursor

records array Required

No description available.

total integer Required

total number of matching links

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
filter links to those from specific users
number of results to return
collection and path specification (e.g., 'app.bsky.feed.like:subject.uri')
the target being linked to (at-uri, did, or uri)
View raw schema 
{
  "type": "query",
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "total",
        "records"
      ],
      "properties": {
        "total": {
          "type": "integer",
          "description": "total number of matching links"
        },
        "cursor": {
          "type": "string",
          "description": "pagination cursor"
        },
        "records": {
          "type": "array",
          "items": {
            "ref": "#linkRecord",
            "type": "ref"
          }
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "required": [
      "subject",
      "source"
    ],
    "properties": {
      "did": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "did"
        },
        "description": "filter links to those from specific users"
      },
      "limit": {
        "type": "integer",
        "default": 16,
        "maximum": 100,
        "minimum": 1,
        "description": "number of results to return"
      },
      "source": {
        "type": "string",
        "description": "collection and path specification (e.g., 'app.bsky.feed.like:subject.uri')"
      },
      "subject": {
        "type": "string",
        "format": "uri",
        "description": "the target being linked to (at-uri, did, or uri)"
      }
    }
  },
  "description": "a list of records linking to any record, identity, or uri"
}
linkRecord object

No description available.

Properties

collection string nsid Required

the collection of the linking record

did string did Required

the DID of the linking record's repository

rkey string record-key Required

the record key of the linking record

View raw schema 
{
  "type": "object",
  "required": [
    "did",
    "collection",
    "rkey"
  ],
  "properties": {
    "did": {
      "type": "string",
      "format": "did",
      "description": "the DID of the linking record's repository"
    },
    "rkey": {
      "type": "string",
      "format": "record-key",
      "description": "the record key of the linking record"
    },
    "collection": {
      "type": "string",
      "format": "nsid",
      "description": "the collection of the linking record"
    }
  }
}

Lexicon Garden

@