pub.chive.claiming.searchEprints

chive.pub View official

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

No description available.

Properties

did string did Optional

Author DID if claimed

name string Required

Author name

View raw schema
{
  "properties": {
    "did": {
      "description": "Author DID if claimed",
      "format": "did",
      "type": "string"
    },
    "name": {
      "description": "Author name",
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}
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
{
  "description": "Existing Chive paper if this is a duplicate",
  "properties": {
    "authors": {
      "description": "Author list",
      "items": {
        "ref": "#existingAuthor",
        "type": "ref"
      },
      "type": "array"
    },
    "createdAt": {
      "description": "When the paper was indexed",
      "format": "datetime",
      "type": "string"
    },
    "title": {
      "description": "Paper title",
      "type": "string"
    },
    "uri": {
      "description": "AT-URI of the existing paper",
      "format": "at-uri",
      "type": "string"
    }
  },
  "required": [
    "uri",
    "title",
    "authors",
    "createdAt"
  ],
  "type": "object"
}
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
{
  "properties": {
    "affiliation": {
      "description": "Institution affiliation",
      "type": "string"
    },
    "email": {
      "description": "Email address",
      "type": "string"
    },
    "name": {
      "description": "Author name",
      "type": "string"
    },
    "orcid": {
      "description": "ORCID identifier",
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}
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
{
  "properties": {
    "abstract": {
      "description": "Abstract text",
      "type": "string"
    },
    "authors": {
      "description": "Author list",
      "items": {
        "ref": "#externalAuthor",
        "type": "ref"
      },
      "type": "array"
    },
    "categories": {
      "description": "Subject categories",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "doi": {
      "description": "DOI if assigned",
      "type": "string"
    },
    "existingChivePaper": {
      "ref": "#existingChivePaper",
      "type": "ref"
    },
    "externalId": {
      "description": "Source-specific identifier",
      "type": "string"
    },
    "pdfUrl": {
      "description": "URL to PDF",
      "format": "uri",
      "type": "string"
    },
    "publicationDate": {
      "description": "Publication date",
      "format": "datetime",
      "type": "string"
    },
    "source": {
      "description": "Source system",
      "type": "string"
    },
    "title": {
      "description": "Eprint title",
      "type": "string"
    },
    "url": {
      "description": "Full URL to the eprint",
      "format": "uri",
      "type": "string"
    }
  },
  "required": [
    "externalId",
    "url",
    "title",
    "authors",
    "source"
  ],
  "type": "object"
}
searchFacets object

No description available.

Properties

sources unknown Optional

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

View raw schema
{
  "properties": {
    "sources": {
      "description": "Result counts by source (key: source name, value: count)",
      "type": "unknown"
    }
  },
  "type": "object"
}
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
{
  "description": "Error from a specific external source during search",
  "properties": {
    "message": {
      "description": "Human-readable error message",
      "type": "string"
    },
    "source": {
      "description": "Source identifier that failed (e.g., arxiv, openreview)",
      "type": "string"
    }
  },
  "required": [
    "source",
    "message"
  ],
  "type": "object"
}

Lexicon Garden

@