blue.microcosm.links.getManyToManyCounts

microcosm.blue

Documentation

count many-to-many relationships with secondary link paths

main query

count many-to-many relationships with secondary link paths

Parameters

did array of string Optional

filter links to those from specific users

limit integer Optional

number of results to return

otherSubject array of string Optional

filter secondary links to specific subjects

pathToOther string Required

path to the secondary link in the many-to-many record (e.g., 'otherThing.uri')

source string Required

collection and path specification for the primary link

subject string uri Required

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

Output

Encodingapplication/json
counts_by_other_subject array Required

No description available.

cursor string Optional

pagination cursor

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
filter secondary links to specific subjects
path to the secondary link in the many-to-many record (e.g., 'otherThing.uri')
collection and path specification for the primary link
the primary target being linked to (at-uri, did, or uri)
View raw schema
{
  "type": "query",
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "counts_by_other_subject"
      ],
      "properties": {
        "cursor": {
          "type": "string",
          "description": "pagination cursor"
        },
        "counts_by_other_subject": {
          "type": "array",
          "items": {
            "ref": "#countBySubject",
            "type": "ref"
          }
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "required": [
      "subject",
      "source",
      "pathToOther"
    ],
    "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 for the primary link"
      },
      "subject": {
        "type": "string",
        "format": "uri",
        "description": "the primary target being linked to (at-uri, did, or uri)"
      },
      "pathToOther": {
        "type": "string",
        "description": "path to the secondary link in the many-to-many record (e.g., 'otherThing.uri')"
      },
      "otherSubject": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "filter secondary links to specific subjects"
      }
    }
  },
  "description": "count many-to-many relationships with secondary link paths"
}
countBySubject object

No description available.

Properties

distinct integer Required

number of distinct DIDs linking to this subject

subject string Required

the secondary subject being counted

total integer Required

total number of links to this subject

View raw schema
{
  "type": "object",
  "required": [
    "subject",
    "total",
    "distinct"
  ],
  "properties": {
    "total": {
      "type": "integer",
      "description": "total number of links to this subject"
    },
    "subject": {
      "type": "string",
      "description": "the secondary subject being counted"
    },
    "distinct": {
      "type": "integer",
      "description": "number of distinct DIDs linking to this subject"
    }
  }
}

Lexicon Garden

@