pub.chive.metrics.getTrending

Get trending eprints based on view counts within a time window

Repository @lexicons.governance.chive.pub did:plc:egjghlwgts2hlcer2txilxeh not from the namespace authority
Details · query
Kindquery
Authoritymetrics.chive.pub
Indexed

Query

query · GET

Parameters

query string

cursor

string

Pagination cursor

Optional field URIs to flag matching eprints as in-field

  • maxLength: 50
itemsstring · at-uri

limit

integer

Maximum number of results to return

  • minimum: 1
  • maximum: 100
  • default: 20

window

string

Time window for trending calculation

  • default: "7d"
  • enum: 24h | 7d | 30d

Output

application/json

cursor

string

Cursor for next page

hasMore

requiredboolean

Whether more results are available

window

requiredstring

Time window used

  • enum: 24h | 7d | 30d

#authorRef

object

Reference to an author with optional ATProto identity

Properties

affiliations

requiredarray
itemsref

avatarUrl

string

Avatar URL (if available)

contributions

requiredarray
itemsref
Reference

did

string · did

Author DID (if linked to ATProto identity)

email

string

Contact email

handle

string

ATProto handle (if resolved)

Whether this is the corresponding author

Whether to highlight this author

name

requiredstring

Display name

orcid

string

ORCID identifier

order

requiredinteger

Author order position

  • minimum: 1

#contribution

object

CRediT contribution role

Properties

degree

string

Degree of contribution (lead, supporting, equal)

typeId

requiredstring

Contribution type slug

typeLabel

requiredstring

Human-readable contribution label

typeUri

requiredstring · at-uri

AT-URI of the contribution type node

#eprintMetrics

object

Current metrics for the eprint

Properties

downloads

requiredinteger

Total download count

  • minimum: 0

Endorsement count

  • minimum: 0

views

requiredinteger

Total view count

  • minimum: 0

#fieldRef

object

Reference to a knowledge graph field node

Properties

id

string

Field ID

label

requiredstring

Display label

parentUri

string · at-uri

Parent field URI

uri

requiredstring · at-uri

AT-URI of the field node

#sourceInfo

object

PDS source information for data transparency

Properties

blobUrl

string

URL to fetch associated blob

lastVerifiedAt

requiredstring · datetime

When the record was last verified

pdsEndpoint

requiredstring

URL of the source PDS

recordUrl

requiredstring

Direct URL to fetch the record

stale

requiredboolean

Whether the indexed data may be stale

#trendingEntry

object

A trending eprint entry with full metadata

Properties

authors

requiredarray
itemsref
Reference

cid

requiredstring · cid

CID of the eprint record

createdAt

requiredstring · datetime

Original creation timestamp

fields

array

Knowledge graph field classifications

itemsref
Reference

Whether this eprint matches the requested fieldUris

indexedAt

requiredstring · datetime

When Chive indexed this record

license

requiredstring

License identifier

Current metrics snapshot

Reference

paperDid

string · did

DID of the paper identity (if using paper-centric model)

rank

requiredinteger

Position in trending list

  • minimum: 1

source

requiredref

PDS source information for transparency

Reference

submittedBy

requiredstring · did

DID of the submitter

title

requiredstring

Eprint title

uri

requiredstring · at-uri

AT-URI of the eprint

velocity

integer

Rate of view increase (optional)

viewsInWindow

requiredinteger

Views within the trending window

  • minimum: 0

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.