CitedEvidenceResearch APIs

Scholar Metadata API

Search scholarly records and explore their relationships.

The metadata API is rooted at https://scholar.citedevidence.com/v1/oa. It supports OpenAlex-style entities, identifiers, filters, and list responses. Records can be metadata-only; use the CEDOA Files API when content access is required.

Authentication

Use your existing account key with the Metadata use case enabled. Send Authorization: Bearer $CE_API_KEY. Public metadata reads also allow anonymous access with lower limits. Follow the Quickstart for key setup.

First requests

  • GET/v1/oa

    Discover available metadata entities and routes.

  • GET/v1/oa/works?search=climate&per_page=5

    Search works. Lists return meta and results.

    curl -sS -H "Authorization: Bearer $CE_API_KEY" \
  "https://scholar.citedevidence.com/v1/oa/works?search=climate&per_page=5"
  • GET/v1/oa/works/doi:10.7717/peerj.4375

    Resolve a work by namespaced DOI without embedding a URL in the path.

  • GET/v1/oa/sources?search=medicine&per_page=5

    Find publication sources, including journals.

  • GET/v1/oa/works?filter=publication_year:2024&cursor=*&per_page=50

    Start cursor pagination. Send the returned meta.next_cursor on the next request.

  • POST/v1/oa/works/bulk

    Look up several works with a JSON body such as {"ids":["W2741809807","doi:10.7717/peerj.4375"]}.

Reference topics

Related APIs

Retrieve paper content through CEDOA Files, or connect an AI client through Research MCP. Their request parameters and response envelopes differ from the metadata API.