From
bafyreibdoox5k7jlhylcwvdtlzt7lrnrbk36uh6drqjh4k2c4idhxtxrz4
indexed 2026-06-18 13:14 UTC
View this version
To
bafyreibdoox5k7jlhylcwvdtlzt7lrnrbk36uh6drqjh4k2c4idhxtxrz4
indexed 2026-06-18 13:14 UTC
View this version
Compatibility
backward compatible No changes detected.
Changes
11
{22
"$type": "com.atproto.lexicon.schema",33
"defs": {44
"author": {55
"properties": {66
"name": {77
"type": "string"88
}99
},1010
"required": [1111
"name"1212
],1313
"type": "object"1414
},1515
"eprintRef": {1616
"properties": {1717
"title": {1818
"type": "string"1919
},2020
"uri": {2121
"format": "at-uri",2222
"type": "string"2323
}2424
},2525
"required": [2626
"uri",2727
"title"2828
],2929
"type": "object"3030
},3131
"main": {3232
"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.",3333
"errors": [3434
{3535
"name": "NotFound"3636
},3737
{3838
"name": "ServiceUnavailable"3939
}4040
],4141
"output": {4242
"encoding": "application/json",4343
"schema": {4444
"properties": {4545
"eprint": {4646
"ref": "#eprintRef",4747
"type": "ref"4848
},4949
"related": {5050
"items": {5151
"ref": "#relatedEprint",5252
"type": "ref"5353
},5454
"type": "array"5555
}5656
},5757
"required": [5858
"eprint",5959
"related"6060
],6161
"type": "object"6262
}6363
},6464
"parameters": {6565
"properties": {6666
"includeTypes": {6767
"description": "Types of relationships to include. 'co-citation' and 'bibliographic-coupling' use graph analysis. 'collaborative' uses collaborative filtering.",6868
"items": {6969
"knownValues": [7070
"semantic",7171
"citation",7272
"topic",7373
"author",7474
"co-citation",7575
"bibliographic-coupling",7676
"collaborative"7777
],7878
"type": "string"7979
},8080
"type": "array"8181
},8282
"limit": {8383
"default": 5,8484
"description": "Maximum number of similar papers",8585
"maximum": 20,8686
"minimum": 1,8787
"type": "integer"8888
},8989
"uri": {9090
"description": "AT-URI of the eprint",9191
"format": "at-uri",9292
"type": "string"9393
},9494
"weightAuthorNetwork": {9595
"description": "Weight for author network signal (0-100)",9696
"maximum": 100,9797
"minimum": 0,9898
"type": "integer"9999
},100100
"weightCoCitation": {101101
"description": "Weight for co-citation signal (0-100)",102102
"maximum": 100,103103
"minimum": 0,104104
"type": "integer"105105
},106106
"weightCollaborative": {107107
"description": "Weight for collaborative filtering signal (0-100)",108108
"maximum": 100,109109
"minimum": 0,110110
"type": "integer"111111
},112112
"weightConceptOverlap": {113113
"description": "Weight for concept overlap signal (0-100)",114114
"maximum": 100,115115
"minimum": 0,116116
"type": "integer"117117
},118118
"weightSemantic": {119119
"description": "Weight for semantic similarity signal (0-100)",120120
"maximum": 100,121121
"minimum": 0,122122
"type": "integer"123123
}124124
},125125
"required": [126126
"uri"127127
],128128
"type": "params"129129
},130130
"type": "query"131131
},132132
"relatedEprint": {133133
"properties": {134134
"abstract": {135135
"description": "Rich abstract with text, formatting, and entity references",136136
"items": {137137
"refs": [138138
"pub.chive.richtext.defs#textItem",139139
"pub.chive.richtext.defs#nodeRefItem",140140
"pub.chive.richtext.defs#wikidataRefItem",141141
"pub.chive.richtext.defs#fieldRefItem",142142
"pub.chive.richtext.defs#facetRefItem",143143
"pub.chive.richtext.defs#eprintRefItem",144144
"pub.chive.richtext.defs#annotationRefItem",145145
"pub.chive.richtext.defs#authorRefItem",146146
"pub.chive.richtext.defs#mentionItem",147147
"pub.chive.richtext.defs#linkItem",148148
"pub.chive.richtext.defs#tagItem",149149
"pub.chive.richtext.defs#latexItem",150150
"pub.chive.richtext.defs#codeBlockItem",151151
"pub.chive.richtext.defs#headingItem",152152
"pub.chive.richtext.defs#listItem",153153
"pub.chive.richtext.defs#blockquoteItem"154154
],155155
"type": "union"156156
},157157
"maxLength": 500,158158
"type": "array"159159
},160160
"authors": {161161
"items": {162162
"ref": "#author",163163
"type": "ref"164164
},165165
"type": "array"166166
},167167
"categories": {168168
"items": {169169
"type": "string"170170
},171171
"type": "array"172172
},173173
"explanation": {174174
"description": "Human-readable explanation of the relationship",175175
"type": "string"176176
},177177
"publicationDate": {178178
"format": "datetime",179179
"type": "string"180180
},181181
"relationshipType": {182182
"description": "Type of relationship to the source eprint",183183
"knownValues": [184184
"cites",185185
"cited-by",186186
"co-cited",187187
"semantically-similar",188188
"same-author",189189
"same-topic",190190
"bibliographic-coupling",191191
"collaborative-filtering"192192
],193193
"type": "string"194194
},195195
"score": {196196
"description": "Similarity score (scaled by 1000 for 0.0-1.0 range)",197197
"maximum": 1000,198198
"minimum": 0,199199
"type": "integer"200200
},201201
"sharedCiters": {202202
"description": "Number of papers that cite both (for co-citation)",203203
"minimum": 0,204204
"type": "integer"205205
},206206
"sharedReferences": {207207
"description": "Number of shared references (for bibliographic coupling)",208208
"minimum": 0,209209
"type": "integer"210210
},211211
"title": {212212
"type": "string"213213
},214214
"uri": {215215
"format": "at-uri",216216
"type": "string"217217
}218218
},219219
"required": [220220
"uri",221221
"title",222222
"score",223223
"relationshipType",224224
"explanation"225225
],226226
"type": "object"227227
}228228
},229229
"id": "pub.chive.discovery.getSimilar",230230
"lexicon": 1,231231
"revision": 1232232
}