Search the Scopus academic database for papers using Boolean query syntax.

Common field codes:

• TITLE-ABS-KEY(term) — search title, abstract, and keywords (most useful)

• TITLE(term) — title only

• AUTH(name) — author name, e.g. AUTH("Smith J")

• AFFIL(institution) — author affiliation

• PUBYEAR > 2020 — filter by publication year

• DOCTYPE(ar) — document type: ar=article, re=review, cp=conference paper

Boolean operators: AND, OR, AND NOT Example: TITLE-ABS-KEY("machine learning" AND cancer) AND PUBYEAR > 2020

Read the scopus://search-syntax resource for the full syntax reference.

Search for author profiles in the Scopus author index.

Query field codes:

• AUTHLASTNAME(Smith) — last name

• AUTHFIRST(John) — first name or initials

• ORCID(0000-0002-1234-5678) — ORCID identifier

• AF-ID(60027950) — affiliation ID

Example: AUTHLASTNAME(Smith) AND AUTHFIRST(J) AND AFFIL(MIT)

Use scopus_get_author with the returned author_id to fetch full metrics.

Search for institution and affiliation records in Scopus.

Query examples:

• AFFIL(MIT) — by name keyword

• AFFIL(Harvard) AND COUNTRY(United States)

• AFFIL-ID(60027950) — by Scopus affiliation ID

Returns affiliation_id needed for author searches and filtering.

Retrieve full paper details from Scopus using any supported identifier.

Identifier types:

• scopus_id — Scopus internal numeric ID (e.g. "85123456789")

• doi — Digital Object Identifier (e.g. "10.1016/j.labeco.2024.102505")

• eid — Electronic ID (e.g. "2-s2.0-85123456789")

• pubmed_id — PubMed/MEDLINE numeric ID

Returns: title, full abstract, authors with affiliations, keywords, subject areas, citation count, DOI, and open access status.

Fetch metadata/abstracts for 1–25 identifiers of the same type. Returns each record or its error in input order; access depends on Elsevier entitlements.

Retrieve a researcher's full Scopus profile by their Scopus Author ID.

Returns: h-index, total citation count, document count, current institutional affiliation, subject areas, ORCID (if available), and publication year range.

To find an author's ID, first use scopus_search_authors. Example author IDs: '7401234567' or '57209123456'.

Get the current total citation count for a paper.

Provide either a Scopus ID or a DOI — at least one is required. This endpoint is lightweight and cached; use it for quick citation lookups without fetching the full abstract.

Get a year-by-year citation timeline for a paper.

Returns how many times the paper was cited in each calendar year within the specified date range. Useful for tracking research impact and citation trends over time.

Requires a Scopus ID. Use scopus_search or scopus_get_abstract first to obtain the scopus_id.

Prefer scopus_get_citation_count when you only need one total - it is a single cheap lookup. Use this when the shape of the citation curve over time matters.

Access depends on your Elsevier endpoint entitlement. An institutional token or approved network may be required; use scopus_check_access to diagnose access before retrying authorization failures.

Test each Scopus endpoint independently using seven live requests. Uses API quota; bypasses cache. Never returns credentials. Run when access is uncertain, not before every search.

Retrieve one page of a paper's bibliography using Elsevier REF view, with FULL bibliography fallback when REF metadata is absent. Requires appropriate entitlement. Missing references are reported as unavailable, never assumed to mean no references. Follow next_start when present.

Find Scopus documents citing a paper using REFEID. This search field requires specific Elsevier access permission. Returns a paginated corpus of indexed citing documents, not a universal citation census.

Aggregate a bounded Scopus search corpus by cover year, publication source and affiliation. Defaults to 100 documents; at most 5000. Reports truncation, continuation and unknown metadata explicitly. Counts describe retrieved documents only; do not extrapolate to all literature. Each institution counts once per document.