---
title: "V1 Public Co Author Graph"
method: GET
path: "/v1/authors/co-author-graph"
tags: ["v1"]
---

# V1 Public Co Author Graph

`GET /v1/authors/co-author-graph`

## 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/authors/co-author-graph`
- Auth: HTTP bearer

Co-authorship edge graph for a set of authors (TOOL-01).

For each input author, returns outgoing edges to every co-author on papers
published within the time window. Edges are deterministic and derived from
the paper_authors join table — not from any cached graph snapshot.

Returns asymmetric (from, to) edges, sorted by papers_count DESC; capped at
500 edges per request. Useful for downstream reviewer-triage and
collaboration-neighborhood workflows.

Note: this surfaces the FULL co-author neighborhood per input author. If a
symmetric subgraph restricted to {input_authors} is needed, filter the
returned edges client-side (YAGNI — not implemented server-side).

Rate limit: 20/minute per API key.

## Query parameters

- `author_ids` string, required: Comma-separated author IDs (max 25). Example: '12345,67890'.
- `window_years` integer: Only count co-authorships from the last N years (max 30).

## 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)