blue.microcosm.links.getBacklinkDids Documentation (EN)

main query

a list of distinct dids with a specific records linking to a target at a specified path

Parameters

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

linking_dids 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.

Service Endpoint Base URL for XRPC calls (e.g., https://api.bsky.social)

Parameters

limit number of results to return

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

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

View raw schema

{
  "description": "a list of distinct dids with a specific records linking to a target at a specified path",
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "cursor": {
          "description": "pagination cursor",
          "type": "string"
        },
        "linking_dids": {
          "items": {
            "format": "did",
            "type": "string"
          },
          "type": "array"
        },
        "total": {
          "description": "total number of matching links",
          "type": "integer"
        }
      },
      "required": [
        "total",
        "linking_dids"
      ],
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "limit": {
        "default": 16,
        "description": "number of results to return",
        "maximum": 100,
        "minimum": 1,
        "type": "integer"
      },
      "source": {
        "description": "collection and path specification (e.g., 'app.bsky.feed.like:subject.uri')",
        "type": "string"
      },
      "subject": {
        "description": "the target being linked to (at-uri, did, or uri)",
        "format": "uri",
        "type": "string"
      }
    },
    "required": [
      "subject",
      "source"
    ],
    "type": "params"
  },
  "type": "query"
}