Build with ShareScore's open data and versioned scores—or validate the methodology and results for yourself.
Use versioned scores, researcher metrics, and repository data in your own tools.
Inspect the frozen rubric, release receipt, provenance, and coverage behind every result.
Published SHARE 2.0 scores
These API examples and the live response below use SHARE 2.0 score release active release.
Scores use the evidence frozen for the active immutable release. A zero-point signal can be absent, unsupported, not evaluable, source-missing, or failed; those states remain distinct in the release evidence. Unsupported evidence is never presented as a demonstrated absence, and support can vary by repository.
Base URL
https://api.sharescore.orgCopy and paste any command below to query live data — no setup required.
Top datasets by SHARE score
curl "https://api.sharescore.org/records?limit=5&sortBy=score&sortOrder=desc"
Top researchers by S-Index
curl "https://api.sharescore.org/authors?limit=5&sortBy=sIndex&sortOrder=desc"
Live platform metrics
curl "https://api.sharescore.org/metrics/live"
import requests
response = requests.get("https://api.sharescore.org/records", params={
"limit": 10,
"sortBy": "score",
"sortOrder": "desc"
})
payload = response.json()
for record in payload["data"]:
score = record.get("score")
title = record.get("title") or "Untitled record"
print(record["id"], title[:60], score["total"] if score else "not scored")
receipt = payload["_meta"]["scoreRelease"]
print("Release:", receipt["scoreReleaseVersion"], receipt["releaseDigest"])Record score object
Illustrative values. id is the canonical route and join key. DOI, repository label, title, and publication date are source metadata and may be null; clients should never substitute a DOI for the record ID. List rows include total, five bucket scores, and status. Detail responses also include the five evidence masks.
{
"id": "record-primary-key",
"doi": null,
"repository": null,
"title": null,
"pubDate": null,
"score": {
"total": 28,
"bucketScores": { "S": 4, "H": 8, "A": 12, "R": 0, "E": 4 },
"status": "scored",
"supportedMask": 33554431,
"evaluableMask": 33554431,
"passedMask": 16705,
"sourceMissingMask": 0,
"failedMask": 0
}
}Live API 1.5 release response
Loaded from https://api.sharescore.org/metrics/live. This is the active response, including its exact rubric, score-release digest, publication time, and reconciled coverage—not a copied sample.
Loading the active immutable release receipt…
Anonymous
100 requests / minute
No API key required. Rate tracked per IP address.
With API Key
1,000 requests / minute
Free API key. Rate tracked per key. Register below.
Each dataset receives a composite SHARE score (0-100) based on five dimensions. All five are deposit-time evidence buckets. The full S+H+A+R+E total is the dataset score used to calculate S-Index; observed reuse is reported separately.
Stewardship
Keywords, contributors, subjects
Harmonization
Description, methods, references
Access
License, access rights
Reusability
Documentation, code, manifests, inspectable files, filenames
Engagement
ORCIDs, grants, related IDs
Register for a free API key to get higher rate limits and usage tracking. Pass it via the X-API-Key header.
OpenAPI Specification
Machine-readable API spec for integration, code generation, or import into Postman. Confirm that it identifies API 1.5 and SHARE 2.0 before generating a client.