pub.chive.eprint.searchSubmissions

chive.pub

Documentation

Search preprints with faceted filters using knowledge graph dimensions

main query

Search preprints with faceted filters using knowledge graph dimensions

Parameters

author string did Optional

Filter by author DID

cursor string Optional

No description available.

dateFrom string datetime Optional

Filter by submission date (from)

dateTo string datetime Optional

Filter by submission date (to)

facetUris array of string Optional

Filter by facet node URIs (subkind=facet)

fieldUris array of string Optional

Filter by field node URIs (subkind=field)

limit integer Optional

No description available.

paperTypeUri string at-uri Optional

Filter by paper type node URI (subkind=paper-type)

publicationStatusUri string at-uri Optional

Filter by publication status node URI (subkind=publication-status)

q string Optional

Search query. If omitted, returns recent eprints (browsing mode)

sort string Optional

Sort order for results. 'relevance' (default) or 'recent' (newest first)

topicUris array of string Optional

Filter by topic node URIs (subkind=topic)

Output

Encodingapplication/json

cursor string Optional

No description available.

facetAggregations array Optional

No description available.

hits array Required

No description available.

total integer Optional

Total number of matching documents

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

author Filter by author DID

cursor

dateFrom Filter by submission date (from)

dateTo Filter by submission date (to)

facetUris Filter by facet node URIs (subkind=facet)

fieldUris Filter by field node URIs (subkind=field)

limit

paperTypeUri Filter by paper type node URI (subkind=paper-type)

publicationStatusUri Filter by publication status node URI (subkind=publication-status)

q Search query. If omitted, returns recent eprints (browsing mode)

sort Sort order for results. 'relevance' (default) or 'recent' (newest first)

topicUris Filter by topic node URIs (subkind=topic)

View raw schema

{
  "type": "query",
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "hits"
      ],
      "properties": {
        "hits": {
          "type": "array",
          "items": {
            "ref": "#searchHit",
            "type": "ref"
          }
        },
        "total": {
          "type": "integer",
          "description": "Total number of matching documents"
        },
        "cursor": {
          "type": "string"
        },
        "facetAggregations": {
          "type": "array",
          "items": {
            "ref": "#facetAggregation",
            "type": "ref"
          }
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "properties": {
      "q": {
        "type": "string",
        "description": "Search query. If omitted, returns recent eprints (browsing mode)"
      },
      "sort": {
        "type": "string",
        "description": "Sort order for results. 'relevance' (default) or 'recent' (newest first)",
        "knownValues": [
          "relevance",
          "recent"
        ]
      },
      "limit": {
        "type": "integer",
        "default": 25,
        "maximum": 100,
        "minimum": 1
      },
      "author": {
        "type": "string",
        "format": "did",
        "description": "Filter by author DID"
      },
      "cursor": {
        "type": "string"
      },
      "dateTo": {
        "type": "string",
        "format": "datetime",
        "description": "Filter by submission date (to)"
      },
      "dateFrom": {
        "type": "string",
        "format": "datetime",
        "description": "Filter by submission date (from)"
      },
      "facetUris": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "at-uri"
        },
        "description": "Filter by facet node URIs (subkind=facet)"
      },
      "fieldUris": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "at-uri"
        },
        "description": "Filter by field node URIs (subkind=field)"
      },
      "topicUris": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "at-uri"
        },
        "description": "Filter by topic node URIs (subkind=topic)"
      },
      "paperTypeUri": {
        "type": "string",
        "format": "at-uri",
        "description": "Filter by paper type node URI (subkind=paper-type)"
      },
      "publicationStatusUri": {
        "type": "string",
        "format": "at-uri",
        "description": "Filter by publication status node URI (subkind=publication-status)"
      }
    }
  },
  "description": "Search preprints with faceted filters using knowledge graph dimensions"
}

authorSummary object

Minimal author info for search results

Properties

avatarUrl string uri Optional

Author avatar URL

did string did Optional

Author DID if known

handle string Optional

Author handle (e.g., alice.bsky.social)

name string Required

Display name

View raw schema

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "did": {
      "type": "string",
      "format": "did",
      "description": "Author DID if known"
    },
    "name": {
      "type": "string",
      "description": "Display name"
    },
    "handle": {
      "type": "string",
      "description": "Author handle (e.g., alice.bsky.social)"
    },
    "avatarUrl": {
      "type": "string",
      "format": "uri",
      "description": "Author avatar URL"
    }
  },
  "description": "Minimal author info for search results"
}

facetAggregation object

Aggregation for a facet dimension

Properties

dimension string Required

Dimension identifier (e.g., 'field', 'topic', 'paperType')

label string Optional

Display label for the dimension

subkind string Required

Subkind slug for the dimension's nodes

values array of ref#facetValue Required

No description available.

View raw schema

{
  "type": "object",
  "required": [
    "dimension",
    "subkind",
    "values"
  ],
  "properties": {
    "label": {
      "type": "string",
      "description": "Display label for the dimension"
    },
    "values": {
      "type": "array",
      "items": {
        "ref": "#facetValue",
        "type": "ref"
      }
    },
    "subkind": {
      "type": "string",
      "description": "Subkind slug for the dimension's nodes"
    },
    "dimension": {
      "type": "string",
      "description": "Dimension identifier (e.g., 'field', 'topic', 'paperType')"
    }
  },
  "description": "Aggregation for a facet dimension"
}

facetValue object

A facet value with node reference

Properties

count integer Required

Number of documents with this facet value

label string Required

Display label

slug string Optional

Node slug for URL generation

uri string at-uri Required

AT-URI of the knowledge graph node

View raw schema

{
  "type": "object",
  "required": [
    "uri",
    "label",
    "count"
  ],
  "properties": {
    "uri": {
      "type": "string",
      "format": "at-uri",
      "description": "AT-URI of the knowledge graph node"
    },
    "slug": {
      "type": "string",
      "description": "Node slug for URL generation"
    },
    "count": {
      "type": "integer",
      "description": "Number of documents with this facet value"
    },
    "label": {
      "type": "string",
      "description": "Display label"
    }
  },
  "description": "A facet value with node reference"
}

fieldRef object

Reference to a knowledge graph field node

Properties

id string Optional

UUID of the field node

label string Required

Human-readable field name

uri string at-uri Required

AT-URI of the field node

View raw schema

{
  "type": "object",
  "required": [
    "uri",
    "label"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "UUID of the field node"
    },
    "uri": {
      "type": "string",
      "format": "at-uri",
      "description": "AT-URI of the field node"
    },
    "label": {
      "type": "string",
      "description": "Human-readable field name"
    }
  },
  "description": "Reference to a knowledge graph field node"
}

highlightResult object

Highlighted text fragments with search matches

Properties

abstract array of string Optional

Abstract fragments with <em> highlighting

title array of string Optional

Title fragments with <em> highlighting

View raw schema

{
  "type": "object",
  "properties": {
    "title": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Title fragments with <em> highlighting"
    },
    "abstract": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Abstract fragments with <em> highlighting"
    }
  },
  "description": "Highlighted text fragments with search matches"
}

searchHit object

A search result hit

Properties

abstract string Optional

Eprint abstract plain text for display

authors array of ref#authorSummary Optional

Author summaries for display

createdAt string datetime Optional

When the eprint was created

fields array of ref#fieldRef Optional

Knowledge graph field references

highlight ref #highlightResult Optional

No description available.

indexedAt string datetime Optional

When the eprint was indexed

score integer Required

Relevance score (scaled by 1000 for precision)

minimum: 0

title string Optional

Eprint title for display

uri string at-uri Required

AT-URI of the matched eprint

View raw schema

{
  "type": "object",
  "required": [
    "uri",
    "score"
  ],
  "properties": {
    "uri": {
      "type": "string",
      "format": "at-uri",
      "description": "AT-URI of the matched eprint"
    },
    "score": {
      "type": "integer",
      "minimum": 0,
      "description": "Relevance score (scaled by 1000 for precision)"
    },
    "title": {
      "type": "string",
      "description": "Eprint title for display"
    },
    "fields": {
      "type": "array",
      "items": {
        "ref": "#fieldRef",
        "type": "ref"
      },
      "description": "Knowledge graph field references"
    },
    "authors": {
      "type": "array",
      "items": {
        "ref": "#authorSummary",
        "type": "ref"
      },
      "description": "Author summaries for display"
    },
    "abstract": {
      "type": "string",
      "description": "Eprint abstract plain text for display"
    },
    "createdAt": {
      "type": "string",
      "format": "datetime",
      "description": "When the eprint was created"
    },
    "highlight": {
      "ref": "#highlightResult",
      "type": "ref"
    },
    "indexedAt": {
      "type": "string",
      "format": "datetime",
      "description": "When the eprint was indexed"
    }
  },
  "description": "A search result hit"
}