Migrating from legacy clients
Drop-in swap with a handful of host changes.
Our API is wire-compatible with api.openalex.org. In most cases you change the host, keep every path, filter, and cursor identical.
Base URL
Replace https://api.openalex.org with https://scholar.citedevidence.com/v1/oa. All downstream paths (/works, /authors, etc.) remain unchanged.
Identifier handling
We accept record IDs such as W123 and A123, namespaced prefixes (doi:..., orcid:..., ror:..., issn:..., pmid:..., pmcid:..., mag:...), and full URL identifiers (https://doi.org/...) exactly like the legacy API.
What changes
- Use your API key instead of the legacy provider's. The
mailtopolite-pool parameter still works. - Our API returns the same JSON schema plus a small set of additive fields (we never remove or rename compatibility fields).
- Snapshot releases live under
/v1/oa/snapshot; per-entity manifests and per-release dates mirror the upstream layout.
Examples
- GET
/v1/oa/works?filter=publication_year:2024&per_page=50Same filter grammar as the legacy API.
- GET
/v1/oa/authors/orcid:0000-0002-1825-0097ORCID lookup works identically.
- GET
/v1/oa/works/W2741809807?select=id,title,cited_by_countField selection supported.