Requires a Scite premium subscription. Counts reflect Scite’s index coverage, so say so when you report them.
citation_graph
citation_graph traverses citations from up to 10 seed DOIs. Each edge is {s, t, d}: the citing paper s, the cited paper t, and d, the hop distance from a seed.
The response carries
edges, a papers map of every DOI to its title, year, and any editorialNotices, and truncated when max_edges was hit.
Edge type is supporting, contradicting, or mentioning. contradicting here is the stance search_literature reports as contrasting. Snippet text returns only for open-access and unrestricted sources; closed-publisher edges still carry type and section.
Seeds expand automatically to their linked preprint and published versions, so a paper split across an arXiv DOI and a journal DOI traverses as one work.
Check coverage first
seed_coverage maps each seed to how many of its edges resolved at hop 1, and low_coverage_seeds lists seeds with too few to be reliable. arXiv-heavy fields, such as machine learning, often under-resolve. A thin graph means missing edges, not a poorly connected paper; fall back to search_literature for low-coverage seeds.
Analyses you can derive from edges
The edge list answers the classic citation-analysis questions without extra calls:- Common references: traverse
outfrom several seeds and keep DOIs that appear astfor every seed. - Common citers: traverse
inand keep DOIs that appear assfor every seed. These are often surveys. - Bibliographic coupling: traverse
bothat depth 2, so the second hop reaches other papers that cite the seed’s references. Rank those papers by how many reference targets they share with the seed. - Co-citation: rank papers frequently cited by the same citers.
- Citation classics: rank DOIs by in-degree.
include_intent first to filter any of these to supporting or contradicting edges.
The claim graph
Passclaim instead of seeds and the tool runs check_claim for you. The response adds claim_check, with the verbatim supporting, contradicting, and stating passages, and builds the graph from the papers that state the claim, always with intent on the edges.
From there, call read_fulltext on claim_check.readNext (the stating papers) and claim_check.readNextCiting (the papers holding the counterexamples and evidence) to read the experiments, assumptions, and proofs behind each node.
get_citation_statements
get_citation_statements lists the Smart Citation statements that cite one paper, with paging. Unlike citation_graph, it pages cleanly through papers with tens of thousands of citers.
The response carries
total and hasMore. Stance uses Scite’s expert label when one exists, else the classifier’s; confidence is the classifier’s 0–1 score. snippet is verbatim for open-access and licensed sources; otherwise contentDenied is true and only type, section, and confidence return.
For very heavily cited papers approximate is true: total counts a bounded slice, offset is capped (capped: true when yours was past it), and hasMore turns false at the last reachable page. Narrow with type or term rather than paging further.
bibliometrics
bibliometrics computes field-level citation analytics in one aggregation pass. It counts citations received by the papers in scope and returns no paper text.
Scope
Pass at least one filter:dois (up to 2,000), term, title, abstract, journal (word match) or journals (exact keys), author, affiliation, publisher, topic, paper_type, year, date_from, date_to, citation_types, sections, has_tally, and the editorial filters has_retraction, has_concern, has_correction, has_erratum, and has_withdrawn.
term matches title, abstract, and full text, and every word must match. Check total_papers and tighten with quotes, AND/OR, dates, topic, or journals.
Grouping
group_by sets the bucket dimension: year (default), journal, author, affiliation, topic, mesh, paper_type, oa_status, editorial_notice, citation_type, or citation_section. order_by ranks buckets by papers, citations, supporting, contrasting, or mentioning; year buckets are always chronological. limit caps buckets at up to 100.
What it returns
contrast_rate is contrasting ÷ (supporting + contrasting). Most fields sit around 0.05–0.08; a bucket well above that is worth reading.
Normalized and custom indices
Passbaseline, an object with the same filters describing the field, to get normalized: mncs (1.0 = field average), tncs, and Leiden pp_top1, pp_top10, and pp_top50.
Pass custom_indices to compute your own h, g, or at-least indices over any tally field. For example, {"type": "h", "field": "contrasting", "name": "negative_h"} returns the number of papers each disputed by at least that many contradicting citations.
Set include_raw: true (with raw_limit up to 1,000) to get per-paper rows for computing other indices yourself.
citation_dynamics
citation_dynamics analyzes when and how a set of papers was cited. Pass up to 100 DOIs, or up to 500 with summary_only: true. The DOIs usually come from bibliometrics (top_papers or include_raw), search_literature, or citation_graph.
Per paper, it returns citation timing (
first_citation_year, peak_year, cited_half_life, within_1y/within_3y/within_5y, delayed_recognition), self_citation_rate, stance counts, editorial notices with citations_after_notice and stance_after_notice, and reference-list measures (mean_reference_age, price_index, journal_insularity).
The aggregate adds citations_by_citing_year, cohorts (cited year × citing year), stance_by_citing_year, references_by_year, and top_cited_references.
Common uses:
- Journal citation-rate estimates. Pass one journal’s papers from years Y-1 and Y-2 (from
bibliometricswithjournals,year, andinclude_raw). Then (cohorts[Y-1][Y]+cohorts[Y-2][Y]) ÷ papers approximates a two-year impact factor, andcohorts[Y][Y]÷ papers approximates immediacy for year-Y papers. These are estimates from Scite’s index, not official Journal Impact Factors: the denominator counts every paper supplied rather than citable items only. Above 500 papers,summary_onlycovers only the 500 most-cited, so the value overstates the rate. - Post-retraction citation.
stance_after_noticestill showing supporting citations means papers kept citing the work as valid. - Shifting stance. A rising contradicting share in
stance_by_citing_yearis a signal to read the contradicting passages, not a verdict that the finding is weakening. - Fair comparisons. Use
within_3yinstead of all-time counts, and quoteself_citation_ratebeside any individual index.
Related
- Verification tools:
check_claim, which feeds the claim graph - Literature tools:
read_fulltextfor the papers you find in the graph - Citation model: how statements, tallies, and citing publications relate
