pub.chive.claiming.searchEprints

chive.pub

Documentation

Search external eprint sources for papers to claim

main query

Search external eprint sources for papers to claim

Parameters

author string Optional

Author name to search for

limit integer Optional

Maximum number of results

query string Optional

Title or keyword search query

sources string Optional

Comma-separated list of sources to search

Output

Encodingapplication/json
eprints array Required

No description available.

sourceErrors array Optional

Per-source errors from sources that failed during the search

Errors

InvalidRequest
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
Author name to search for
Maximum number of results
Title or keyword search query
Comma-separated list of sources to search
View raw schema 
{
  "type": "query",
  "errors": [
    {
      "name": "InvalidRequest"
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "eprints"
      ],
      "properties": {
        "facets": {
          "ref": "#searchFacets",
          "type": "ref"
        },
        "eprints": {
          "type": "array",
          "items": {
            "ref": "#externalEprint",
            "type": "ref"
          }
        },
        "sourceErrors": {
          "type": "array",
          "items": {
            "ref": "#sourceError",
            "type": "ref"
          },
          "description": "Per-source errors from sources that failed during the search"
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "properties": {
      "limit": {
        "type": "integer",
        "default": 20,
        "maximum": 50,
        "minimum": 1,
        "description": "Maximum number of results"
      },
      "query": {
        "type": "string",
        "description": "Title or keyword search query"
      },
      "author": {
        "type": "string",
        "description": "Author name to search for"
      },
      "sources": {
        "type": "string",
        "description": "Comma-separated list of sources to search"
      }
    }
  },
  "description": "Search external eprint sources for papers to claim"
}
existingAuthor object

No description available.

Properties

did string did Optional

Author DID if claimed

name string Required

Author name

View raw schema 
{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "did": {
      "type": "string",
      "format": "did",
      "description": "Author DID if claimed"
    },
    "name": {
      "type": "string",
      "description": "Author name"
    }
  }
}
existingChivePaper object

Existing Chive paper if this is a duplicate

Properties

createdAt string datetime Required

When the paper was indexed

title string Required

Paper title

uri string at-uri Required

AT-URI of the existing paper

View raw schema 
{
  "type": "object",
  "required": [
    "uri",
    "title",
    "authors",
    "createdAt"
  ],
  "properties": {
    "uri": {
      "type": "string",
      "format": "at-uri",
      "description": "AT-URI of the existing paper"
    },
    "title": {
      "type": "string",
      "description": "Paper title"
    },
    "authors": {
      "type": "array",
      "items": {
        "ref": "#existingAuthor",
        "type": "ref"
      },
      "description": "Author list"
    },
    "createdAt": {
      "type": "string",
      "format": "datetime",
      "description": "When the paper was indexed"
    }
  },
  "description": "Existing Chive paper if this is a duplicate"
}
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"
    }
  }
}
externalEprint object

No description available.

Properties

abstract string Optional

Abstract text

categories array of string Optional

Subject categories

doi string Optional

DOI if assigned

externalId string Required

Source-specific identifier

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"
  ],
  "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"
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Subject categories"
    },
    "externalId": {
      "type": "string",
      "description": "Source-specific identifier"
    },
    "publicationDate": {
      "type": "string",
      "format": "datetime",
      "description": "Publication date"
    },
    "existingChivePaper": {
      "ref": "#existingChivePaper",
      "type": "ref"
    }
  }
}
searchFacets object

No description available.

Properties

sources unknown Optional

Result counts by source (key: source name, value: count)

View raw schema 
{
  "type": "object",
  "properties": {
    "sources": {
      "type": "unknown",
      "description": "Result counts by source (key: source name, value: count)"
    }
  }
}
sourceError object

Error from a specific external source during search

Properties

message string Required

Human-readable error message

source string Required

Source identifier that failed (e.g., arxiv, openreview)

View raw schema 
{
  "type": "object",
  "required": [
    "source",
    "message"
  ],
  "properties": {
    "source": {
      "type": "string",
      "description": "Source identifier that failed (e.g., arxiv, openreview)"
    },
    "message": {
      "type": "string",
      "description": "Human-readable error message"
    }
  },
  "description": "Error from a specific external source during search"
}

Lexicon Garden

@