---
title: "V1 Get Foundational Lineage"
method: GET
path: "/v1/foundational-lineage"
tags: ["v1"]
---

# V1 Get Foundational Lineage

`GET /v1/foundational-lineage`

## Request

- Base URL: `https://api.scholarfeed.org` (the document declares no server; this is the origin it was published from)
- URL: `https://api.scholarfeed.org/v1/foundational-lineage`
- Auth: HTTP bearer

Foundational lineage for a paper's NICHE (TOOL-07, paper-anchored).

Pipeline (consensus-then-lift; no LLM, no PageRank):
  1. Resolve the anchor's stored embedding (no Gemini call — cheaper than field-orientation).
  2. Niche = pgvector k-NN neighbourhood (the `scope` knob) = "the field".
  3. One GROUP BY over the niche's out-edges → within-niche in-degree per ancestor.
  4. Demote universal landmarks by the R1 specificity ratio; split the niche-specific
     foundations into roots (above a relative consensus floor) vs field_level.
  5. Rank niche_roots by LIFT (enrichment) so the niche gems lead — not raw
     consensus, which surfaces broad pillars and buries the gems.

Returns the foundational work SPECIFIC to this paper's niche — surfacing canonical
anchors that embedding similarity misses, while universally-cited landmark papers
(e.g. Attention Is All You Need) collapse into `discipline`.

Rate limit: 20/minute per API key.

## Query parameters

- `anchor_paper_id` string, required: arXiv ID to anchor on, e.g. '2504.04704'.
- `scope` 'narrow' | 'field' | 'broad': Niche breadth: narrow≈100 nearest papers, field≈200, broad≈400.
- `generality_ceiling` boolean: Demote universally-cited landmark papers (low niche-enrichment) into a collapsed 'discipline' tier.
- `limit` integer: Max papers in each of the niche_roots and field_level tiers.

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/scholarfeed/apis/scholar-feed-api.md) · [All operations](https://skmtc.dev/scholarfeed/apis/scholar-feed-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scholarfeed/apis/scholar-feed-api/revisions/fc3200d27505?raw)