Export Graph

Export a bounded slice of the citation graph, column-oriented.

Unlike /graph/subgraph, this never refuses: past the cap it truncates to the best limit matches (sort, default most-cited) and reports capped. That is the whole difference in contract — subgraph guards an interactive render, export hands back a usable slice whatever you ask for.

The corpus is ~420k nodes / ~2.2M edges; serialising all of it took ~23s and 70MB, fully buffered, which no API gateway will sit through. Hence the cap. There is deliberately no offset or cursor, so this route cannot walk the whole corpus — it answers "the interesting slice of X", not "all of X".

Two limits on what total and capped can promise:

• total is the search index match count. Meili indexes fewer rows than Postgres holds valid (417,463 vs 419,473 measured 2026-08-08), so an unindexed authority is unreachable here at every limit, and uncounted in total. Closing that gap is a re-index, and it moves /graph/subgraph identically — the two share this id selector on purpose.
• capped means "this is not the whole match set" — set when the total exceeds limit or when Postgres rejected an id Meili returned.

Neither makes capped: false a guarantee of completeness against Postgres; it is a guarantee against the index.