pub.chive.discovery.getSimilar

chive.pub

Documentation

Get related papers for an eprint based on citation patterns, semantic similarity, and topic overlap. Supports graph-based analysis including co-citation and bibliographic coupling.

main query

Get related papers for an eprint based on citation patterns, semantic similarity, and topic overlap. Supports graph-based analysis including co-citation and bibliographic coupling.

Parameters

includeTypes array of string Optional

Types of relationships to include. 'co-citation' and 'bibliographic-coupling' use graph analysis. 'collaborative' uses collaborative filtering.

limit integer Optional

Maximum number of similar papers

uri string at-uri Required

AT-URI of the eprint

weightAuthorNetwork integer Optional

Weight for author network signal (0-100)

weightCoCitation integer Optional

Weight for co-citation signal (0-100)

weightCollaborative integer Optional

Weight for collaborative filtering signal (0-100)

weightConceptOverlap integer Optional

Weight for concept overlap signal (0-100)

weightSemantic integer Optional

Weight for semantic similarity signal (0-100)

Output

Encodingapplication/json
eprint ref#eprintRef Required

No description available.

related array Required

No description available.

Errors

NotFound
ServiceUnavailable
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
Types of relationships to include. 'co-citation' and 'bibliographic-coupling' use graph analysis. 'collaborative' uses collaborative filtering.
Maximum number of similar papers
AT-URI of the eprint
Weight for author network signal (0-100)
Weight for co-citation signal (0-100)
Weight for collaborative filtering signal (0-100)
Weight for concept overlap signal (0-100)
Weight for semantic similarity signal (0-100)
View raw schema 
{
  "type": "query",
  "errors": [
    {
      "name": "NotFound"
    },
    {
      "name": "ServiceUnavailable"
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "eprint",
        "related"
      ],
      "properties": {
        "eprint": {
          "ref": "#eprintRef",
          "type": "ref"
        },
        "related": {
          "type": "array",
          "items": {
            "ref": "#relatedEprint",
            "type": "ref"
          }
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "required": [
      "uri"
    ],
    "properties": {
      "uri": {
        "type": "string",
        "format": "at-uri",
        "description": "AT-URI of the eprint"
      },
      "limit": {
        "type": "integer",
        "default": 5,
        "maximum": 20,
        "minimum": 1,
        "description": "Maximum number of similar papers"
      },
      "includeTypes": {
        "type": "array",
        "items": {
          "type": "string",
          "knownValues": [
            "semantic",
            "citation",
            "topic",
            "author",
            "co-citation",
            "bibliographic-coupling",
            "collaborative"
          ]
        },
        "description": "Types of relationships to include. 'co-citation' and 'bibliographic-coupling' use graph analysis. 'collaborative' uses collaborative filtering."
      },
      "weightSemantic": {
        "type": "integer",
        "maximum": 100,
        "minimum": 0,
        "description": "Weight for semantic similarity signal (0-100)"
      },
      "weightCoCitation": {
        "type": "integer",
        "maximum": 100,
        "minimum": 0,
        "description": "Weight for co-citation signal (0-100)"
      },
      "weightAuthorNetwork": {
        "type": "integer",
        "maximum": 100,
        "minimum": 0,
        "description": "Weight for author network signal (0-100)"
      },
      "weightCollaborative": {
        "type": "integer",
        "maximum": 100,
        "minimum": 0,
        "description": "Weight for collaborative filtering signal (0-100)"
      },
      "weightConceptOverlap": {
        "type": "integer",
        "maximum": 100,
        "minimum": 0,
        "description": "Weight for concept overlap signal (0-100)"
      }
    }
  },
  "description": "Get related papers for an eprint based on citation patterns, semantic similarity, and topic overlap. Supports graph-based analysis including co-citation and bibliographic coupling."
}
author object

No description available.

Properties

name string Required

No description available.

View raw schema 
{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string"
    }
  }
}
eprintRef object

No description available.

Properties

title string Required

No description available.

uri string at-uri Required

An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).

View raw schema 
{
  "type": "object",
  "required": [
    "uri",
    "title"
  ],
  "properties": {
    "uri": {
      "type": "string",
      "format": "at-uri"
    },
    "title": {
      "type": "string"
    }
  }
}
relatedEprint object

No description available.

Properties

abstract array of union Optional

Rich abstract with text, formatting, and entity references

maxLength: 500 items
Known types:
authors array of ref#author Optional

No description available.

categories array of string Optional

No description available.

explanation string Required

Human-readable explanation of the relationship

publicationDate string datetime Optional

An RFC 3339 formatted timestamp.

relationshipType string Required

Type of relationship to the source eprint

Known values: cites, cited-by, co-cited, semantically-similar, same-author, same-topic, bibliographic-coupling, collaborative-filtering
score integer Required

Similarity score (scaled by 1000 for 0.0-1.0 range)

minimum: 0maximum: 1000
sharedCiters integer Optional

Number of papers that cite both (for co-citation)

minimum: 0
sharedReferences integer Optional

Number of shared references (for bibliographic coupling)

minimum: 0
title string Required

No description available.

uri string at-uri Required

An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).

View raw schema 
{
  "type": "object",
  "required": [
    "uri",
    "title",
    "score",
    "relationshipType",
    "explanation"
  ],
  "properties": {
    "uri": {
      "type": "string",
      "format": "at-uri"
    },
    "score": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 0,
      "description": "Similarity score (scaled by 1000 for 0.0-1.0 range)"
    },
    "title": {
      "type": "string"
    },
    "authors": {
      "type": "array",
      "items": {
        "ref": "#author",
        "type": "ref"
      }
    },
    "abstract": {
      "type": "array",
      "items": {
        "refs": [
          "pub.chive.richtext.defs#textItem",
          "pub.chive.richtext.defs#nodeRefItem",
          "pub.chive.richtext.defs#wikidataRefItem",
          "pub.chive.richtext.defs#fieldRefItem",
          "pub.chive.richtext.defs#facetRefItem",
          "pub.chive.richtext.defs#eprintRefItem",
          "pub.chive.richtext.defs#annotationRefItem",
          "pub.chive.richtext.defs#authorRefItem",
          "pub.chive.richtext.defs#mentionItem",
          "pub.chive.richtext.defs#linkItem",
          "pub.chive.richtext.defs#tagItem",
          "pub.chive.richtext.defs#latexItem",
          "pub.chive.richtext.defs#codeBlockItem",
          "pub.chive.richtext.defs#headingItem",
          "pub.chive.richtext.defs#listItem",
          "pub.chive.richtext.defs#blockquoteItem"
        ],
        "type": "union"
      },
      "maxLength": 500,
      "description": "Rich abstract with text, formatting, and entity references"
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "explanation": {
      "type": "string",
      "description": "Human-readable explanation of the relationship"
    },
    "sharedCiters": {
      "type": "integer",
      "minimum": 0,
      "description": "Number of papers that cite both (for co-citation)"
    },
    "publicationDate": {
      "type": "string",
      "format": "datetime"
    },
    "relationshipType": {
      "type": "string",
      "description": "Type of relationship to the source eprint",
      "knownValues": [
        "cites",
        "cited-by",
        "co-cited",
        "semantically-similar",
        "same-author",
        "same-topic",
        "bibliographic-coupling",
        "collaborative-filtering"
      ]
    },
    "sharedReferences": {
      "type": "integer",
      "minimum": 0,
      "description": "Number of shared references (for bibliographic coupling)"
    }
  }
}

Lexicon Garden

@