pub.chive.discovery.getCitations

chive.pub

Documentation

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

main query

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

Parameters

cursor string Optional

Pagination cursor

direction string Optional

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

limit integer Optional

Maximum number of citations to return

onlyInfluential boolean Optional

Only return influential citations

uri string at-uri Required

AT-URI of the eprint

Output

Encodingapplication/json
citations array Required

No description available.

cursor string Optional

Pagination cursor for next page

eprint ref#eprintRef Required

No description available.

hasMore boolean Required

Whether more results are available

Errors

NotFound
ServiceUnavailable
Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
Pagination cursor
Citation direction: citing (papers this cites), cited-by (papers citing this), or both
Maximum number of citations to return
Only return influential citations
AT-URI of the eprint
View raw schema 
{
  "type": "query",
  "errors": [
    {
      "name": "NotFound"
    },
    {
      "name": "ServiceUnavailable"
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "eprint",
        "counts",
        "citations",
        "hasMore"
      ],
      "properties": {
        "counts": {
          "ref": "#citationCounts",
          "type": "ref"
        },
        "cursor": {
          "type": "string",
          "description": "Pagination cursor for next page"
        },
        "eprint": {
          "ref": "#eprintRef",
          "type": "ref"
        },
        "hasMore": {
          "type": "boolean",
          "description": "Whether more results are available"
        },
        "citations": {
          "type": "array",
          "items": {
            "ref": "#citation",
            "type": "ref"
          }
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "required": [
      "uri"
    ],
    "properties": {
      "uri": {
        "type": "string",
        "format": "at-uri",
        "description": "AT-URI of the eprint"
      },
      "limit": {
        "type": "integer",
        "default": 20,
        "maximum": 100,
        "minimum": 1,
        "description": "Maximum number of citations to return"
      },
      "cursor": {
        "type": "string",
        "description": "Pagination cursor"
      },
      "direction": {
        "type": "string",
        "default": "both",
        "description": "Citation direction: citing (papers this cites), cited-by (papers citing this), or both",
        "knownValues": [
          "citing",
          "cited-by",
          "both"
        ]
      },
      "onlyInfluential": {
        "type": "boolean",
        "default": false,
        "description": "Only return influential citations"
      }
    }
  },
  "description": "Get citation network data for an eprint, including papers that cite it and papers it references (within the Chive index)"
}
citation object

No description available.

Properties

citedUri string at-uri Required

AT-URI of the cited paper

citingUri string at-uri Required

AT-URI of the citing paper

discoveredAt string datetime Optional

When this citation was discovered

isInfluential boolean Optional

Whether this is an influential citation

source string Required

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

View raw schema 
{
  "type": "object",
  "required": [
    "citingUri",
    "citedUri",
    "source"
  ],
  "properties": {
    "source": {
      "type": "string",
      "description": "Source of citation data (e.g., semantic-scholar, openalex)"
    },
    "citedUri": {
      "type": "string",
      "format": "at-uri",
      "description": "AT-URI of the cited paper"
    },
    "citingUri": {
      "type": "string",
      "format": "at-uri",
      "description": "AT-URI of the citing paper"
    },
    "discoveredAt": {
      "type": "string",
      "format": "datetime",
      "description": "When this citation was discovered"
    },
    "isInfluential": {
      "type": "boolean",
      "description": "Whether this is an influential citation"
    }
  }
}
citationCounts object

No description available.

Properties

citedByCount integer Required

Number of papers citing this eprint

minimum: 0
influentialCitedByCount integer Required

Number of influential citations

minimum: 0
referencesCount integer Required

Number of papers this eprint references

minimum: 0
View raw schema 
{
  "type": "object",
  "required": [
    "citedByCount",
    "referencesCount",
    "influentialCitedByCount"
  ],
  "properties": {
    "citedByCount": {
      "type": "integer",
      "minimum": 0,
      "description": "Number of papers citing this eprint"
    },
    "referencesCount": {
      "type": "integer",
      "minimum": 0,
      "description": "Number of papers this eprint references"
    },
    "influentialCitedByCount": {
      "type": "integer",
      "minimum": 0,
      "description": "Number of influential citations"
    }
  }
}
eprintRef object

No description available.

Properties

title string Required

No description available.

uri string at-uri Required

An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).

View raw schema 
{
  "type": "object",
  "required": [
    "uri",
    "title"
  ],
  "properties": {
    "uri": {
      "type": "string",
      "format": "at-uri"
    },
    "title": {
      "type": "string"
    }
  }
}

Lexicon Garden

@