Returns a paginated list of papers, either browsed by publication date or matched against a text query. Call it to find papers by keyword, boolean expression, category, or date window. Combining a search with any sort other than relevance returns HTTP 400; invalid query parameters also return 400, and unexpected failures return 500.
Rate limit: papersApiCallsPerDay · Free plan: 10/day
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| search | string | No | Free-text phrase to match against papers. |
| boolean_search | string | No | Boolean query expression; when supplied it takes precedence over search. |
| category | string | No | Category to restrict results to. |
| date_from | string | No | Start of the publication date window, as an ISO date (YYYY-MM-DD). |
| date_to | string | No | End of the publication date window, as an ISO date (YYYY-MM-DD). |
| page | number | No | Min 1; default 1 (min 1; default 1) Range: 1 to ∞ |
| limit | number | No | Range 1-100; default 20 (range 1-100; default 20) Range: 1 to 100 |
| sort | string | No | Result ordering; relevance is only valid together with a search. Allowed values: published_date, relevance |
| order | string | No | Default desc (default desc) Allowed values: asc, desc |
Example request
curl -H "x-api-key: YOUR_API_KEY" \ "https://app.caelrith.com/api/v1/papers"
Returns a single paper record identified by DOI, arXiv/OSF-prefixed id, sanitized key, or PMID. Call it when you already have one paper identifier and need its full record. Returns 404 if no paper matches, 400 for an invalid query, and 500 on an internal failure.
Rate limit: papersApiCallsPerDay · Free plan: 10/day
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| doi | string | Yes | minimum length 1 |
Example request
curl -H "x-api-key: YOUR_API_KEY" \ "https://app.caelrith.com/api/v1/papers/detail?doi=your_doi"
Returns a preview list of the five most recently published papers, ordered newest first, along with a sample size and a note. Call it to show a quick recent-papers preview without specifying any filters. Fails with 500 if the request cannot be completed, or with a not-ready response when the service is unavailable.
Rate limit: papersApiCallsPerDay · Free plan: 10/day
Parameters
No parameters.
Example request
curl -H "x-api-key: YOUR_API_KEY" \ "https://app.caelrith.com/api/v1/papers/sample"