Researchers
Principal-investigator profiles and their OpenAlex publication records.
2 endpoints · every section below is generated from the API catalog
Profile document for a researcher (principal investigator) resolved to an OpenAlex author. Use trial documents or pi_author_id results from the registry search to obtain an author id. The author id must come from a real source - there is no name-to-id resolution, so never invent one; invalid id formats return HTTP 400 and an id not in the resolved-researcher registry returns HTTP 404.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| authorId(path) | string | Yes | OpenAlex author id; prefer the flat forms A5027151969 or openalex_A5027151969 (the https URL form is accepted but gets URL-encoded on the wire). |
Example request
curl -H "x-api-key: YOUR_API_KEY" \
"https://app.caelrith.com/api/v1/researchers/{authorId}"Paginated publication list (OpenAlex works) for a researcher already resolved to an OpenAlex author: title, full DOI url, type, publication_date, publication_year, venue, cited_by_count, is_open_access. Use this for 'what has this PI published', citation-impact and publication-trend questions about one author; use Researcher Profile instead for identity metadata, h-index and trial counts. The author id must come from a real source - the Trial Full Record tool's data.researchers[].author_key, a Researcher Profile result, or the user - there is no name-to-id resolution, so never invent one. meta.totalItems is the exact count for the applied filters (quote it; never recount a page). NO abstracts are returned here (they belong to the deferred works detail endpoint) - do not claim to have abstracts from this tool.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| page | integer | No | Page number (default 1). Range: 1 to ∞ |
| limit | integer | No | Results per page (1-100, default 20). Range: 1 to 100 |
| sort | string | No | Sort field (default publication_date). cited_by_count = citation impact; publication_date = chronology. Allowed values: publication_date, cited_by_count |
| order | string | No | Sort direction (default desc). Allowed values: asc, desc |
| publication_date_from | string | No | YYYY-MM-DD; matches works published on or after this date. Must be <= publication_date_to - an inverted window returns HTTP 400. |
| publication_date_to | string | No | YYYY-MM-DD; matches works published on or before this date. |
| type | string | No | OpenAlex work type, case-insensitive (common values: article, review, preprint, conference-paper, book-chapter, editorial, letter). Unknown values are rejected with HTTP 400. |
| authorId(path) | string | Yes | OpenAlex author id of a researcher resolved by the pipeline; prefer the flat forms A5027151969 or openalex_A5027151969 (the https URL form is accepted but gets URL-encoded on the wire). |
Example request
curl -H "x-api-key: YOUR_API_KEY" \
"https://app.caelrith.com/api/v1/researchers/{authorId}/works"