pub.chive.claiming.fetchExternalPdf Documentation (EN)

main query

Fetch external PDF through proxy to avoid CORS issues. Returns PDF binary data. Only allows fetching from trusted academic sources.

Parameters

externalId string Required

Source-specific identifier for the eprint

source string Required

External source identifier (e.g., arxiv, biorxiv, medrxiv)

Output

Encodingapplication/pdf

Errors

AuthenticationRequired Authentication is required to fetch PDFs

InvalidParameters Missing source or externalId parameter

EprintNotFound The specified eprint does not exist in the external source

PdfNotAvailable No PDF is available for this eprint

DomainNotAllowed PDF URL is not from an allowed academic domain

FetchFailed Failed to fetch PDF from external source

Try It

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

Service Endpoint Base URL for XRPC calls (e.g., https://api.bsky.social)

Parameters

externalId * Source-specific identifier for the eprint

source * External source identifier (e.g., arxiv, biorxiv, medrxiv)

View raw schema

{
  "type": "query",
  "errors": [
    {
      "name": "AuthenticationRequired",
      "description": "Authentication is required to fetch PDFs"
    },
    {
      "name": "InvalidParameters",
      "description": "Missing source or externalId parameter"
    },
    {
      "name": "EprintNotFound",
      "description": "The specified eprint does not exist in the external source"
    },
    {
      "name": "PdfNotAvailable",
      "description": "No PDF is available for this eprint"
    },
    {
      "name": "DomainNotAllowed",
      "description": "PDF URL is not from an allowed academic domain"
    },
    {
      "name": "FetchFailed",
      "description": "Failed to fetch PDF from external source"
    }
  ],
  "output": {
    "encoding": "application/pdf",
    "description": "PDF binary data with Content-Disposition header for download"
  },
  "parameters": {
    "type": "params",
    "required": [
      "source",
      "externalId"
    ],
    "properties": {
      "source": {
        "type": "string",
        "description": "External source identifier (e.g., arxiv, biorxiv, medrxiv)"
      },
      "externalId": {
        "type": "string",
        "description": "Source-specific identifier for the eprint"
      }
    }
  },
  "description": "Fetch external PDF through proxy to avoid CORS issues. Returns PDF binary data. Only allows fetching from trusted academic sources."
}