Integration documentation for editorial and journal management systems
Scholvet Integration Documentation

API

Reviewer search

A search compares the article with confidential reviewer profiles and returns reviewer codes ranked by a match score. Scholvet never returns names at this stage.

POST /v1/reviewer-searches

Finds suitable reviewers for one article. Returns 201 Created with the search.

Request body

Field Type Description
articleRef required string Your stable identifier for the article, up to 80 characters. It comes back in invitations and webhooks.
title required string Article title, up to 600 characters.
abstract string Abstract, up to 6,000 characters. It improves the match but is not stored.
keywords required string[] 1 to 30 keywords. They carry the most weight in the match.
authors object[] Up to 50 authors. Used only to exclude reviewers with a conflict of interest.
authors[].orcid string ORCID iD, with or without https://orcid.org/. Excludes the author themself and their co-authors of the last five years.
authors[].institution string Institution name. Reviewers from the same institution are excluded; English and Turkish names of a university are treated as the same.
authors[].rorId string ROR identifier of the institution. Preferred over the name when both sides have one.
maxResults integer Number of reviewers to return, 1 to 50. Default 10.
Request
curl -X POST https://api.scholvet.com/v1/reviewer-searches \
  -H "X-Api-Key: $SCHOLVET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "articleRef": "JMIR-2026-0104",
    "title": "Deep learning for tumour detection in brain MRI",
    "abstract": "We evaluate convolutional neural networks for tumour detection...",
    "keywords": ["deep learning", "medical imaging", "derin öğrenme", "tıbbi görüntüleme"],
    "authors": [
      { "orcid": "0000-0002-1825-0097", "institution": "Hacettepe University" },
      { "institution": "Başkent University", "rorId": "https://ror.org/02v9bqx10" }
    ],
    "maxResults": 10
  }'

Response body

Field Type Description
searchId required uuid Identifier of the search. Invitations must refer to it.
expiresAt required date-time Until when invitations can be sent from this search (30 days).
results[].reviewerCode required string Pseudonym of the reviewer for your journal, for example SV-7KQ2MX4P.
results[].rank required integer Position in the list, starting at 1.
results[].score required number Match score from 0 to 100: expertise, adjusted for workload, punctuality, rest time and recent declines.
results[].matchedTerms required string[] Up to five terms from your article that matched the profile, as you wrote them.
results[].academicTitle string | null Academic title, if the reviewer gave one.
results[].verifiedReviews required integer Verified reviews the reviewer has done: through Scholvet, confirmed by journals, or recorded on ORCID by a publisher or review service. A count only; it reveals no journal or date.
excludedCount required integer Reviewers left out because of a conflict of interest, workload or availability.
Response
HTTP/1.1 201 Created
Location: /v1/reviewer-searches/0b4f6c1e-5c1a-4a7e-9d0f-7f1c2a9e3b55

{
  "searchId": "0b4f6c1e-5c1a-4a7e-9d0f-7f1c2a9e3b55",
  "expiresAt": "2026-11-27T09:14:02Z",
  "results": [
    {
      "reviewerCode": "SV-7KQ2MX4P",
      "rank": 1,
      "score": 95.2,
      "matchedTerms": ["derin öğrenme", "medical imaging", "convolutional neural networks"],
      "academicTitle": "Prof. Dr.",
      "verifiedReviews": 23
    },
    {
      "reviewerCode": "SV-JRWAM9F8",
      "rank": 2,
      "score": 58.0,
      "matchedTerms": ["deep learning", "detection"],
      "academicTitle": "Assoc. Prof.",
      "verifiedReviews": 4
    }
  ],
  "excludedCount": 3
}

Good to know

Next: Invitations →