omnischolar / orcid

v1.0.1 2026-11-13 14:57 UTC

Requires

• php: >=8.2
• omnisense/omnischolar: ^1.0
• symfony/http-client: ^6.4|^7.0|^8.0

Requires (Dev)

• phpunit/phpunit: ^11.0

MIT

• Marco Meyer

• cv
• orcid
• publications
• scholarly
• omnischolar
• researcher

Published on Packagist.org on 2026-11-14 02:14 UTC

README

ORCID's public API for omnisense/omnischolar: who a researcher says they are - names, biography, keywords, pages - their CV - employments, education, qualifications, invited positions, distinctions, memberships, services - and the works on their record, each in the version they prefer, with its contributors. No key.

$orcid = (new OrcidSourceFactory($http))->create();
$author = $orcid->author('0000-0002-1825-0097');
$author->affiliations(Affiliation::EMPLOYMENT);          // the CV
$orcid->works('0000-0002-1825-0097');

omnischolar:
    sources:
        orcid: { factory: orcid }    # base_uri: https://pub.sandbox.orcid.org/v3.0/ for the sandbox

See docs/.

Install

composer require omnischolar/orcid

It brings the family's core, omnisense/omnischolar, and omnisense/contracts with it. No account and no key: the public API (policy.json). $http is HttpClient::create() in plain PHP.

Usage policy

Declared as data in policy.json (read at https://info.orcid.org/ufaqs/what-are-the-api-limits/ on 2026-11-10), and honoured on every request by the core: a limit reached waits when its window ends within max_wait seconds, else the request is not sent (Usage policies).

• Limits: 12 a second; 25,000 a day per client-ip.
• Licence: not stated; commercial use: contract.
• Credit: not required.
• Needs: nothing.

Responsibility

This package is an independent, unofficial client: it is not affiliated with, endorsed by or sponsored by ORCID, Inc. It reaches their service on behalf of whoever runs it, and it does not redistribute their data beyond the short excerpts recorded as test fixtures. Its MIT licence covers this package's code only and grants no right to the service or to its data.

Whoever installs and runs this package is responsible for complying with the ORCID Public API's terms (Public APIs Terms of Service), for obtaining whatever they require (an account, a key, a licence or subscription, an attribution or a citation, a rate limit to respect), and for any use made of what it returns. The authors publish it free of charge, make no commercial use of it, and accept no liability for how it is used (see LICENSE).

License: MIT since 2026-10-09; earlier versions remain published under LGPL-3.0-or-later.