{
"id": "pub.chive.claiming.searchEprints",
"defs": {
"main": {
"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"
},
"sourceError": {
"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"
},
"searchFacets": {
"type": "object",
"properties": {
"sources": {
"type": "unknown",
"description": "Result counts by source (key: source name, value: count)"
}
}
},
"existingAuthor": {
"type": "object",
"required": [
"name"
],
"properties": {
"did": {
"type": "string",
"format": "did",
"description": "Author DID if claimed"
},
"name": {
"type": "string",
"description": "Author name"
}
}
},
"externalAuthor": {
"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": {
"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"
}
}
},
"existingChivePaper": {
"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"
}
},
"$type": "com.atproto.lexicon.schema",
"lexicon": 1,
"revision": 1
}