Paper Citations Summary

Type: object

Summary statistics of paper-level citation lookups. Reports coverage, total citations found, and generation metadata.

No Additional Properties

total_papers Required

Type: integer

Total number of papers in the database.

Value must be greater or equal to 0

papers_found Required

Type: integer

Number of papers successfully found in citation databases.

Value must be greater or equal to 0

papers_with_errors Required

Type: integer

Number of papers that could not be looked up (errors or not found).

Value must be greater or equal to 0

new_queries Required

Type: integer

Number of new papers queried in this run.

Value must be greater or equal to 0

total_citations Required

Type: integer

Sum of citation counts across all found papers.

Value must be greater or equal to 0

coverage_pct Required

Type: number

Percentage of papers successfully resolved (0-100).

Value must be greater or equal to 0 and lesser or equal to 100

source Required

Type: string

Citation data source used.


Examples:

"scholar"

"openalex"

stopped_early Required

Type: boolean

Whether the lookup was terminated before completion (e.g. rate limits).

generated_at Required

Type: string

ISO 8601 timestamp when this summary was generated.


Example:

"2026-03-20T09:48:28Z"