pub.chive.eprint.searchSubmissions

lexicons.governance.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.

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
Filter by author DID
Filter by submission date (from)
Filter by submission date (to)
Filter by facet node URIs (subkind=facet)
Filter by field node URIs (subkind=field)
Filter by paper type node URI (subkind=paper-type)
Filter by publication status node URI (subkind=publication-status)
Search query. If omitted, returns recent eprints (browsing mode)
Sort order for results. 'relevance' (default) or 'recent' (newest first)
Filter by topic node URIs (subkind=topic)
View raw schema 
{
  "description": "Search preprints with faceted filters using knowledge graph dimensions",
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "cursor": {
          "type": "string"
        },
        "facetAggregations": {
          "items": {
            "ref": "#facetAggregation",
            "type": "ref"
          },
          "type": "array"
        },
        "hits": {
          "items": {
            "ref": "#searchHit",
            "type": "ref"
          },
          "type": "array"
        },
        "total": {
          "description": "Total number of matching documents",
          "type": "integer"
        }
      },
      "required": [
        "hits"
      ],
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "author": {
        "description": "Filter by author DID",
        "format": "did",
        "type": "string"
      },
      "cursor": {
        "type": "string"
      },
      "dateFrom": {
        "description": "Filter by submission date (from)",
        "format": "datetime",
        "type": "string"
      },
      "dateTo": {
        "description": "Filter by submission date (to)",
        "format": "datetime",
        "type": "string"
      },
      "facetUris": {
        "description": "Filter by facet node URIs (subkind=facet)",
        "items": {
          "format": "at-uri",
          "type": "string"
        },
        "type": "array"
      },
      "fieldUris": {
        "description": "Filter by field node URIs (subkind=field)",
        "items": {
          "format": "at-uri",
          "type": "string"
        },
        "type": "array"
      },
      "limit": {
        "default": 25,
        "maximum": 100,
        "minimum": 1,
        "type": "integer"
      },
      "paperTypeUri": {
        "description": "Filter by paper type node URI (subkind=paper-type)",
        "format": "at-uri",
        "type": "string"
      },
      "publicationStatusUri": {
        "description": "Filter by publication status node URI (subkind=publication-status)",
        "format": "at-uri",
        "type": "string"
      },
      "q": {
        "description": "Search query. If omitted, returns recent eprints (browsing mode)",
        "type": "string"
      },
      "sort": {
        "description": "Sort order for results. 'relevance' (default) or 'recent' (newest first)",
        "knownValues": [
          "relevance",
          "recent"
        ],
        "type": "string"
      },
      "topicUris": {
        "description": "Filter by topic node URIs (subkind=topic)",
        "items": {
          "format": "at-uri",
          "type": "string"
        },
        "type": "array"
      }
    },
    "type": "params"
  },
  "type": "query"
}
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 
{
  "description": "Minimal author info for search results",
  "properties": {
    "avatarUrl": {
      "description": "Author avatar URL",
      "format": "uri",
      "type": "string"
    },
    "did": {
      "description": "Author DID if known",
      "format": "did",
      "type": "string"
    },
    "handle": {
      "description": "Author handle (e.g., alice.bsky.social)",
      "type": "string"
    },
    "name": {
      "description": "Display name",
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}
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 
{
  "description": "Aggregation for a facet dimension",
  "properties": {
    "dimension": {
      "description": "Dimension identifier (e.g., 'field', 'topic', 'paperType')",
      "type": "string"
    },
    "label": {
      "description": "Display label for the dimension",
      "type": "string"
    },
    "subkind": {
      "description": "Subkind slug for the dimension's nodes",
      "type": "string"
    },
    "values": {
      "items": {
        "ref": "#facetValue",
        "type": "ref"
      },
      "type": "array"
    }
  },
  "required": [
    "dimension",
    "subkind",
    "values"
  ],
  "type": "object"
}
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 
{
  "description": "A facet value with node reference",
  "properties": {
    "count": {
      "description": "Number of documents with this facet value",
      "type": "integer"
    },
    "label": {
      "description": "Display label",
      "type": "string"
    },
    "slug": {
      "description": "Node slug for URL generation",
      "type": "string"
    },
    "uri": {
      "description": "AT-URI of the knowledge graph node",
      "format": "at-uri",
      "type": "string"
    }
  },
  "required": [
    "uri",
    "label",
    "count"
  ],
  "type": "object"
}
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 
{
  "description": "Reference to a knowledge graph field node",
  "properties": {
    "id": {
      "description": "UUID of the field node",
      "type": "string"
    },
    "label": {
      "description": "Human-readable field name",
      "type": "string"
    },
    "uri": {
      "description": "AT-URI of the field node",
      "format": "at-uri",
      "type": "string"
    }
  },
  "required": [
    "uri",
    "label"
  ],
  "type": "object"
}
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 
{
  "description": "Highlighted text fragments with search matches",
  "properties": {
    "abstract": {
      "description": "Abstract fragments with <em> highlighting",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "title": {
      "description": "Title fragments with <em> highlighting",
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "type": "object"
}
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

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

Lexicon Garden

@