pub.chive.claiming.getSuggestions

chive.pub

Documentation

Get suggested papers for the authenticated user to claim based on their profile

main query

Get suggested papers for the authenticated user to claim based on their profile

Parameters

limit integer Optional

Maximum number of suggestions to return

Output

Encodingapplication/json
papers array Required

Suggested papers sorted by match score

Errors

AuthenticationRequired
Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
Maximum number of suggestions to return
View raw schema 
{
  "type": "query",
  "errors": [
    {
      "name": "AuthenticationRequired"
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "papers",
        "profileUsed"
      ],
      "properties": {
        "papers": {
          "type": "array",
          "items": {
            "ref": "#suggestedPaper",
            "type": "ref"
          },
          "description": "Suggested papers sorted by match score"
        },
        "profileUsed": {
          "ref": "#profileMetadata",
          "type": "ref"
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "properties": {
      "limit": {
        "type": "integer",
        "default": 20,
        "maximum": 50,
        "minimum": 1,
        "description": "Maximum number of suggestions to return"
      }
    }
  },
  "description": "Get suggested papers for the authenticated user to claim based on their profile"
}
externalAuthor object

No description available.

Properties

affiliation string Optional

Institution affiliation

email string Optional

Email address

name string Required

Author name

orcid string Optional

ORCID identifier

View raw schema 
{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Author name"
    },
    "email": {
      "type": "string",
      "description": "Email address"
    },
    "orcid": {
      "type": "string",
      "description": "ORCID identifier"
    },
    "affiliation": {
      "type": "string",
      "description": "Institution affiliation"
    }
  }
}
profileMetadata object

Profile data used for matching

Properties

displayName string Optional

User display name

hasExternalIds boolean Required

Whether user has external authority IDs

hasOrcid boolean Required

Whether user has ORCID linked

nameVariants array of string Required

Name variants used for matching

View raw schema 
{
  "type": "object",
  "required": [
    "nameVariants",
    "hasOrcid",
    "hasExternalIds"
  ],
  "properties": {
    "hasOrcid": {
      "type": "boolean",
      "description": "Whether user has ORCID linked"
    },
    "displayName": {
      "type": "string",
      "description": "User display name"
    },
    "nameVariants": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Name variants used for matching"
    },
    "hasExternalIds": {
      "type": "boolean",
      "description": "Whether user has external authority IDs"
    }
  },
  "description": "Profile data used for matching"
}
suggestedPaper object

No description available.

Properties

abstract string Optional

Abstract text

categories array of string Optional

Subject categories

chiveUri string Optional

AT-URI of the paper in Chive's index (present when source is 'chive')

doi string Optional

DOI if assigned

externalId string Required

Source-specific identifier

matchReason string Required

Human-readable match reason

matchScore integer Required

Match confidence score (0-100)

minimum: 0maximum: 100
pdfUrl string uri Optional

URL to PDF

publicationDate string datetime Optional

Publication date

source string Required

Source system

title string Required

Eprint title

url string uri Required

Full URL to the eprint

View raw schema 
{
  "type": "object",
  "required": [
    "externalId",
    "url",
    "title",
    "authors",
    "source",
    "matchScore",
    "matchReason"
  ],
  "properties": {
    "doi": {
      "type": "string",
      "description": "DOI if assigned"
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Full URL to the eprint"
    },
    "title": {
      "type": "string",
      "description": "Eprint title"
    },
    "pdfUrl": {
      "type": "string",
      "format": "uri",
      "description": "URL to PDF"
    },
    "source": {
      "type": "string",
      "description": "Source system"
    },
    "authors": {
      "type": "array",
      "items": {
        "ref": "#externalAuthor",
        "type": "ref"
      },
      "description": "Author list"
    },
    "abstract": {
      "type": "string",
      "description": "Abstract text"
    },
    "chiveUri": {
      "type": "string",
      "description": "AT-URI of the paper in Chive's index (present when source is 'chive')"
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Subject categories"
    },
    "externalId": {
      "type": "string",
      "description": "Source-specific identifier"
    },
    "matchScore": {
      "type": "integer",
      "maximum": 100,
      "minimum": 0,
      "description": "Match confidence score (0-100)"
    },
    "matchReason": {
      "type": "string",
      "description": "Human-readable match reason"
    },
    "publicationDate": {
      "type": "string",
      "format": "datetime",
      "description": "Publication date"
    }
  }
}

Lexicon Garden

@