Get trending eprints based on view counts within a time window
Parameters
Optional field URIs to flag matching eprints as in-field
Maximum number of results to return
Time window for trending calculation
Output
Encodingapplication/json
Whether more results are available
No description available.
Try It
Requests are sent directly from your browser. Some servers may block requests due to CORS.
Sending request...
View raw schema
{
"type": "query",
"errors": [],
"output": {
"schema": {
"type": "object",
"required": [
"trending",
"window",
"hasMore"
],
"properties": {
"cursor": {
"type": "string",
"description": "Cursor for next page"
},
"window": {
"enum": [
"24h",
"7d",
"30d"
],
"type": "string",
"description": "Time window used"
},
"hasMore": {
"type": "boolean",
"description": "Whether more results are available"
},
"trending": {
"type": "array",
"items": {
"ref": "#trendingEntry",
"type": "ref"
}
}
}
},
"encoding": "application/json"
},
"parameters": {
"type": "params",
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Maximum number of results to return"
},
"cursor": {
"type": "string",
"description": "Pagination cursor"
},
"window": {
"enum": [
"24h",
"7d",
"30d"
],
"type": "string",
"default": "7d",
"description": "Time window for trending calculation"
},
"fieldUris": {
"type": "array",
"items": {
"type": "string",
"format": "at-uri"
},
"maxLength": 50,
"description": "Optional field URIs to flag matching eprints as in-field"
}
}
},
"description": "Get trending eprints based on view counts within a time window"
}
Reference to an author with optional ATProto identity
Properties
No description available.
Avatar URL (if available)
No description available.
Author DID (if linked to ATProto identity)
ATProto handle (if resolved)
Whether this is the corresponding author
Whether to highlight this author
Author order position
minimum: 1
View raw schema
{
"type": "object",
"required": [
"name",
"order",
"affiliations",
"contributions"
],
"properties": {
"did": {
"type": "string",
"format": "did",
"description": "Author DID (if linked to ATProto identity)"
},
"name": {
"type": "string",
"description": "Display name"
},
"email": {
"type": "string",
"description": "Contact email"
},
"orcid": {
"type": "string",
"description": "ORCID identifier"
},
"order": {
"type": "integer",
"minimum": 1,
"description": "Author order position"
},
"handle": {
"type": "string",
"description": "ATProto handle (if resolved)"
},
"avatarUrl": {
"type": "string",
"description": "Avatar URL (if available)"
},
"affiliations": {
"type": "array",
"items": {
"ref": "pub.chive.defs#affiliation",
"type": "ref"
}
},
"contributions": {
"type": "array",
"items": {
"ref": "#contribution",
"type": "ref"
}
},
"isHighlighted": {
"type": "boolean",
"description": "Whether to highlight this author"
},
"isCorrespondingAuthor": {
"type": "boolean",
"description": "Whether this is the corresponding author"
}
},
"description": "Reference to an author with optional ATProto identity"
}
CRediT contribution role
Properties
Degree of contribution (lead, supporting, equal)
Human-readable contribution label
AT-URI of the contribution type node
View raw schema
{
"type": "object",
"required": [
"typeUri",
"typeId",
"typeLabel"
],
"properties": {
"degree": {
"type": "string",
"description": "Degree of contribution (lead, supporting, equal)"
},
"typeId": {
"type": "string",
"description": "Contribution type slug"
},
"typeUri": {
"type": "string",
"format": "at-uri",
"description": "AT-URI of the contribution type node"
},
"typeLabel": {
"type": "string",
"description": "Human-readable contribution label"
}
},
"description": "CRediT contribution role"
}
Current metrics for the eprint
Properties
Total download count
minimum: 0
Endorsement count
minimum: 0
Total view count
minimum: 0
View raw schema
{
"type": "object",
"required": [
"views",
"downloads"
],
"properties": {
"views": {
"type": "integer",
"minimum": 0,
"description": "Total view count"
},
"downloads": {
"type": "integer",
"minimum": 0,
"description": "Total download count"
},
"endorsements": {
"type": "integer",
"minimum": 0,
"description": "Endorsement count"
}
},
"description": "Current metrics for the eprint"
}
Reference to a knowledge graph field node
View raw schema
{
"type": "object",
"required": [
"uri",
"label"
],
"properties": {
"id": {
"type": "string",
"description": "Field ID"
},
"uri": {
"type": "string",
"format": "at-uri",
"description": "AT-URI of the field node"
},
"label": {
"type": "string",
"description": "Display label"
},
"parentUri": {
"type": "string",
"format": "at-uri",
"description": "Parent field URI"
}
},
"description": "Reference to a knowledge graph field node"
}
PDS source information for data transparency
Properties
URL to fetch associated blob
When the record was last verified
Direct URL to fetch the record
Whether the indexed data may be stale
View raw schema
{
"type": "object",
"required": [
"pdsEndpoint",
"recordUrl",
"lastVerifiedAt",
"stale"
],
"properties": {
"stale": {
"type": "boolean",
"description": "Whether the indexed data may be stale"
},
"blobUrl": {
"type": "string",
"description": "URL to fetch associated blob"
},
"recordUrl": {
"type": "string",
"description": "Direct URL to fetch the record"
},
"pdsEndpoint": {
"type": "string",
"description": "URL of the source PDS"
},
"lastVerifiedAt": {
"type": "string",
"format": "datetime",
"description": "When the record was last verified"
}
},
"description": "PDS source information for data transparency"
}
A trending eprint entry with full metadata
Properties
Rich abstract with text, formatting, and entity references
maxLength: 500 items
No description available.
Original creation timestamp
Knowledge graph field classifications
Whether this eprint matches the requested fieldUris
When Chive indexed this record
DID of the paper identity (if using paper-centric model)
Position in trending list
minimum: 1
PDS source information for transparency
Rate of view increase (optional)
Views within the trending window
minimum: 0
View raw schema
{
"type": "object",
"required": [
"uri",
"cid",
"title",
"abstract",
"authors",
"submittedBy",
"license",
"createdAt",
"indexedAt",
"source",
"viewsInWindow",
"rank"
],
"properties": {
"cid": {
"type": "string",
"format": "cid",
"description": "CID of the eprint record"
},
"uri": {
"type": "string",
"format": "at-uri",
"description": "AT-URI of the eprint"
},
"rank": {
"type": "integer",
"minimum": 1,
"description": "Position in trending list"
},
"title": {
"type": "string",
"description": "Eprint title"
},
"fields": {
"type": "array",
"items": {
"ref": "#fieldRef",
"type": "ref"
},
"description": "Knowledge graph field classifications"
},
"source": {
"ref": "#sourceInfo",
"type": "ref",
"description": "PDS source information for transparency"
},
"authors": {
"type": "array",
"items": {
"ref": "#authorRef",
"type": "ref"
}
},
"license": {
"type": "string",
"description": "License identifier"
},
"metrics": {
"ref": "#eprintMetrics",
"type": "ref",
"description": "Current metrics snapshot"
},
"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"
},
"paperDid": {
"type": "string",
"format": "did",
"description": "DID of the paper identity (if using paper-centric model)"
},
"velocity": {
"type": "integer",
"description": "Rate of view increase (optional)"
},
"createdAt": {
"type": "string",
"format": "datetime",
"description": "Original creation timestamp"
},
"indexedAt": {
"type": "string",
"format": "datetime",
"description": "When Chive indexed this record"
},
"submittedBy": {
"type": "string",
"format": "did",
"description": "DID of the submitter"
},
"inUserFields": {
"type": "boolean",
"description": "Whether this eprint matches the requested fieldUris"
},
"viewsInWindow": {
"type": "integer",
"minimum": 0,
"description": "Views within the trending window"
}
},
"description": "A trending eprint entry with full metadata"
}