For the complete documentation index, see llms.txt. This page is also available as Markdown.

Migrate from OpenAlex or Semantic Scholar

Outcome: your existing metadata pipeline keeps working, with grounded answers added on top.

Field mapping

Their fieldOursNotes
id / paperIdid (pap_…)different namespace; map via DOI
doidoithe reliable join key
titletitle
abstract / abstractInvertedIndexabstractplain text, not inverted
tldrtldr
authorships[]authors[]flatter shape
host_venue / venuevenuetyped journal | conference
open_accessopen_access
cited_by_countcitation_count
is_retractedno direct equivalent; use it

Verify each row against the Paper object before relying on it — field names here follow the v1 design and the OpenAPI spec is authoritative.

What you gain

Grounded answers with page-level citations, extraction over your own PDFs, and 2,000+ citation styles — none of which have an equivalent in a metadata-only API.

What changes operationally

  • Auth becomes a key with scopes rather than an anonymous or polite-pool request

  • Calls are metered in credits — budget before you migrate a bulk job

  • Licensing terms differ; re-read content-licensing before rehosting anything

papers · content-licensing · pricing-and-credits

Last updated