pub.chive.discovery.getCitations

Get citation network data for an eprint, including papers that cite it and papers it references (within the Chive index)

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

Query

query · GET

Parameters

query string

cursor

string

Pagination cursor

direction

string

Citation direction: citing (papers this cites), cited-by (papers citing this), or both

  • default: "both"
  • knownValues: citing | cited-by | both

limit

integer

Maximum number of citations to return

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

Only return influential citations

  • default: false

uri

requiredstring · at-uri

AT-URI of the eprint

Output

application/json

citations

requiredarray
itemsref
Reference

counts

requiredref
Reference

cursor

string

Pagination cursor for next page

eprint

requiredref
Reference

hasMore

requiredboolean

Whether more results are available

papers

array

Every eprint appearing at either end of the returned citations, once each. A lookup rather than metadata repeated on each edge: a densely connected paper would otherwise carry the same author list dozens of times in one response.

itemsref
Reference

Errors

NotFound

No description in schema.

ServiceUnavailable

No description in schema.

#citation

object

Properties

citedUri

requiredstring · at-uri

AT-URI of the cited paper

citingUri

requiredstring · at-uri

AT-URI of the citing paper

discoveredAt

string · datetime

When this citation was discovered

Whether this is an influential citation

source

requiredstring

Source of citation data (e.g., semantic-scholar, openalex)

#citationCounts

object

Properties

citedByCount

requiredinteger

Number of papers citing this eprint

  • minimum: 0

Number of influential citations

  • minimum: 0

referencesCount

requiredinteger

Number of papers this eprint references

  • minimum: 0

#eprintRef

object

An eprint named well enough to identify it on sight. The citation graph stores only URIs on its nodes, so an edge read back from it carries nothing a reader could recognise.

Properties

authors

array

Author names in record order. A citation is identified by who wrote it as much as by its title.

itemsstring
  • maxLength: 256

title

requiredstring

uri

requiredstring · at-uri

venue

string

Journal or proceedings the eprint appeared in, when known.

  • maxLength: 512

year

integer

Publication year, when the eprint records a published version.

Similar lexicons

semantic match

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