full diff

pub.chive.metrics.getTrending

lexicons.governance.chive.pub +0 −0

← Back to Compare Lexicon page

From

bafyreiavdy2ekzu2p7gt3ireqcumrwdboezplxyh7vkjfghq4ifzzyuwoy 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 "authorRef": {

55 "description": "Reference to an author with optional ATProto identity",

66 "properties": {

77 "affiliations": {

88 "items": {

99 "ref": "pub.chive.defs#affiliation",

1010 "type": "ref"

1111 },

1212 "type": "array"

1313 },

1414 "avatarUrl": {

1515 "description": "Avatar URL (if available)",

1616 "type": "string"

1717 },

1818 "contributions": {

1919 "items": {

2020 "ref": "#contribution",

2121 "type": "ref"

2222 },

2323 "type": "array"

2424 },

2525 "did": {

2626 "description": "Author DID (if linked to ATProto identity)",

2727 "format": "did",

2828 "type": "string"

2929 },

3030 "email": {

3131 "description": "Contact email",

3232 "type": "string"

3333 },

3434 "handle": {

3535 "description": "ATProto handle (if resolved)",

3636 "type": "string"

3737 },

3838 "isCorrespondingAuthor": {

3939 "description": "Whether this is the corresponding author",

4040 "type": "boolean"

4141 },

4242 "isHighlighted": {

4343 "description": "Whether to highlight this author",

4444 "type": "boolean"

4545 },

4646 "name": {

4747 "description": "Display name",

4848 "type": "string"

4949 },

5050 "orcid": {

5151 "description": "ORCID identifier",

5252 "type": "string"

5353 },

5454 "order": {

5555 "description": "Author order position",

5656 "minimum": 1,

5757 "type": "integer"

5858 }

5959 },

6060 "required": [

6161 "name",

6262 "order",

6363 "affiliations",

6464 "contributions"

6565 ],

6666 "type": "object"

6767 },

6868 "contribution": {

6969 "description": "CRediT contribution role",

7070 "properties": {

7171 "degree": {

7272 "description": "Degree of contribution (lead, supporting, equal)",

7373 "type": "string"

7474 },

7575 "typeId": {

7676 "description": "Contribution type slug",

7777 "type": "string"

7878 },

7979 "typeLabel": {

8080 "description": "Human-readable contribution label",

8181 "type": "string"

8282 },

8383 "typeUri": {

8484 "description": "AT-URI of the contribution type node",

8585 "format": "at-uri",

8686 "type": "string"

8787 }

8888 },

8989 "required": [

9090 "typeUri",

9191 "typeId",

9292 "typeLabel"

9393 ],

9494 "type": "object"

9595 },

9696 "eprintMetrics": {

9797 "description": "Current metrics for the eprint",

9898 "properties": {

9999 "downloads": {

100100 "description": "Total download count",

101101 "minimum": 0,

102102 "type": "integer"

103103 },

104104 "endorsements": {

105105 "description": "Endorsement count",

106106 "minimum": 0,

107107 "type": "integer"

108108 },

109109 "views": {

110110 "description": "Total view count",

111111 "minimum": 0,

112112 "type": "integer"

113113 }

114114 },

115115 "required": [

116116 "views",

117117 "downloads"

118118 ],

119119 "type": "object"

120120 },

121121 "fieldRef": {

122122 "description": "Reference to a knowledge graph field node",

123123 "properties": {

124124 "id": {

125125 "description": "Field ID",

126126 "type": "string"

127127 },

128128 "label": {

129129 "description": "Display label",

130130 "type": "string"

131131 },

132132 "parentUri": {

133133 "description": "Parent field URI",

134134 "format": "at-uri",

135135 "type": "string"

136136 },

137137 "uri": {

138138 "description": "AT-URI of the field node",

139139 "format": "at-uri",

140140 "type": "string"

141141 }

142142 },

143143 "required": [

144144 "uri",

145145 "label"

146146 ],

147147 "type": "object"

148148 },

149149 "main": {

150150 "description": "Get trending eprints based on view counts within a time window",

151151 "errors": [],

152152 "output": {

153153 "encoding": "application/json",

154154 "schema": {

155155 "properties": {

156156 "cursor": {

157157 "description": "Cursor for next page",

158158 "type": "string"

159159 },

160160 "hasMore": {

161161 "description": "Whether more results are available",

162162 "type": "boolean"

163163 },

164164 "trending": {

165165 "items": {

166166 "ref": "#trendingEntry",

167167 "type": "ref"

168168 },

169169 "type": "array"

170170 },

171171 "window": {

172172 "description": "Time window used",

173173 "enum": [

174174 "24h",

175175 "7d",

176176 "30d"

177177 ],

178178 "type": "string"

179179 }

180180 },

181181 "required": [

182182 "trending",

183183 "window",

184184 "hasMore"

185185 ],

186186 "type": "object"

187187 }

188188 },

189189 "parameters": {

190190 "properties": {

191191 "cursor": {

192192 "description": "Pagination cursor",

193193 "type": "string"

194194 },

195195 "fieldUris": {

196196 "description": "Optional field URIs to flag matching eprints as in-field",

197197 "items": {

198198 "format": "at-uri",

199199 "type": "string"

200200 },

201201 "maxLength": 50,

202202 "type": "array"

203203 },

204204 "limit": {

205205 "default": 20,

206206 "description": "Maximum number of results to return",

207207 "maximum": 100,

208208 "minimum": 1,

209209 "type": "integer"

210210 },

211211 "window": {

212212 "default": "7d",

213213 "description": "Time window for trending calculation",

214214 "enum": [

215215 "24h",

216216 "7d",

217217 "30d"

218218 ],

219219 "type": "string"

220220 }

221221 },

222222 "type": "params"

223223 },

224224 "type": "query"

225225 },

226226 "sourceInfo": {

227227 "description": "PDS source information for data transparency",

228228 "properties": {

229229 "blobUrl": {

230230 "description": "URL to fetch associated blob",

231231 "type": "string"

232232 },

233233 "lastVerifiedAt": {

234234 "description": "When the record was last verified",

235235 "format": "datetime",

236236 "type": "string"

237237 },

238238 "pdsEndpoint": {

239239 "description": "URL of the source PDS",

240240 "type": "string"

241241 },

242242 "recordUrl": {

243243 "description": "Direct URL to fetch the record",

244244 "type": "string"

245245 },

246246 "stale": {

247247 "description": "Whether the indexed data may be stale",

248248 "type": "boolean"

249249 }

250250 },

251251 "required": [

252252 "pdsEndpoint",

253253 "recordUrl",

254254 "lastVerifiedAt",

255255 "stale"

256256 ],

257257 "type": "object"

258258 },

259259 "trendingEntry": {

260260 "description": "A trending eprint entry with full metadata",

261261 "properties": {

262262 "abstract": {

263263 "description": "Rich abstract with text, formatting, and entity references",

264264 "items": {

265265 "refs": [

266266 "pub.chive.richtext.defs#textItem",

267267 "pub.chive.richtext.defs#nodeRefItem",

268268 "pub.chive.richtext.defs#wikidataRefItem",

269269 "pub.chive.richtext.defs#fieldRefItem",

270270 "pub.chive.richtext.defs#facetRefItem",

271271 "pub.chive.richtext.defs#eprintRefItem",

272272 "pub.chive.richtext.defs#annotationRefItem",

273273 "pub.chive.richtext.defs#authorRefItem",

274274 "pub.chive.richtext.defs#mentionItem",

275275 "pub.chive.richtext.defs#linkItem",

276276 "pub.chive.richtext.defs#tagItem",

277277 "pub.chive.richtext.defs#latexItem",

278278 "pub.chive.richtext.defs#codeBlockItem",

279279 "pub.chive.richtext.defs#headingItem",

280280 "pub.chive.richtext.defs#listItem",

281281 "pub.chive.richtext.defs#blockquoteItem"

282282 ],

283283 "type": "union"

284284 },

285285 "maxLength": 500,

286286 "type": "array"

287287 },

288288 "authors": {

289289 "items": {

290290 "ref": "#authorRef",

291291 "type": "ref"

292292 },

293293 "type": "array"

294294 },

295295 "cid": {

296296 "description": "CID of the eprint record",

297297 "format": "cid",

298298 "type": "string"

299299 },

300300 "createdAt": {

301301 "description": "Original creation timestamp",

302302 "format": "datetime",

303303 "type": "string"

304304 },

305305 "fields": {

306306 "description": "Knowledge graph field classifications",

307307 "items": {

308308 "ref": "#fieldRef",

309309 "type": "ref"

310310 },

311311 "type": "array"

312312 },

313313 "inUserFields": {

314314 "description": "Whether this eprint matches the requested fieldUris",

315315 "type": "boolean"

316316 },

317317 "indexedAt": {

318318 "description": "When Chive indexed this record",

319319 "format": "datetime",

320320 "type": "string"

321321 },

322322 "license": {

323323 "description": "License identifier",

324324 "type": "string"

325325 },

326326 "metrics": {

327327 "description": "Current metrics snapshot",

328328 "ref": "#eprintMetrics",

329329 "type": "ref"

330330 },

331331 "paperDid": {

332332 "description": "DID of the paper identity (if using paper-centric model)",

333333 "format": "did",

334334 "type": "string"

335335 },

336336 "rank": {

337337 "description": "Position in trending list",

338338 "minimum": 1,

339339 "type": "integer"

340340 },

341341 "source": {

342342 "description": "PDS source information for transparency",

343343 "ref": "#sourceInfo",

344344 "type": "ref"

345345 },

346346 "submittedBy": {

347347 "description": "DID of the submitter",

348348 "format": "did",

349349 "type": "string"

350350 },

351351 "title": {

352352 "description": "Eprint title",

353353 "type": "string"

354354 },

355355 "uri": {

356356 "description": "AT-URI of the eprint",

357357 "format": "at-uri",

358358 "type": "string"

359359 },

360360 "velocity": {

361361 "description": "Rate of view increase (optional)",

362362 "type": "integer"

363363 },

364364 "viewsInWindow": {

365365 "description": "Views within the trending window",

366366 "minimum": 0,

367367 "type": "integer"

368368 }

369369 },

370370 "required": [

371371 "uri",

372372 "cid",

373373 "title",

374374 "abstract",

375375 "authors",

376376 "submittedBy",

377377 "license",

378378 "createdAt",

379379 "indexedAt",

380380 "source",

381381 "viewsInWindow",

382382 "rank"

383383 ],

384384 "type": "object"

385385 }

386386 },

387387 "id": "pub.chive.metrics.getTrending",

388388 "lexicon": 1,

389389 "revision": 2

390390}