# pub.chive.eprint.searchSubmissions

> Published by [chive.pub](https://lexicon.garden/identity/did:plc:7natp5xae72bddaqlkef2t4e)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:7natp5xae72bddaqlkef2t4e/pub.chive.eprint.searchSubmissions)
- [Documentation](https://lexicon.garden/lexicon/did:plc:7natp5xae72bddaqlkef2t4e/pub.chive.eprint.searchSubmissions/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:7natp5xae72bddaqlkef2t4e/pub.chive.eprint.searchSubmissions/examples)

## Definitions

### `pub.chive.eprint.searchSubmissions`

**Type**: `query`

Search preprints with faceted filters using knowledge graph dimensions

#### Parameters

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `q` | `string` | No | Search query. If omitted, returns recent eprints (browsing mode) |
| `sort` | `string` | No | Sort order for results. 'relevance' (default) or 'recent' (newest first) |
| `limit` | `integer` | No |  |
| `author` | `string` (did) | No | Filter by author DID |
| `cursor` | `string` | No |  |
| `dateTo` | `string` (datetime) | No | Filter by submission date (to) |
| `dateFrom` | `string` (datetime) | No | Filter by submission date (from) |
| `facetUris` | `array` | No | Filter by facet node URIs (subkind=facet) |
| `fieldUris` | `array` | No | Filter by field node URIs (subkind=field) |
| `topicUris` | `array` | No | Filter by topic node URIs (subkind=topic) |
| `paperTypeUri` | `string` (at-uri) | No | Filter by paper type node URI (subkind=paper-type) |
| `publicationStatusUri` | `string` (at-uri) | No | Filter by publication status node URI (subkind=publication-status) |

#### Output

**Encoding**: `application/json`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `hits` | `array` | Yes |  |
| `total` | `integer` | No | Total number of matching documents |
| `cursor` | `string` | No |  |
| `facetAggregations` | `array` | No |  |

### `pub.chive.eprint.searchSubmissions#fieldRef`

**Type**: `object`

Reference to a knowledge graph field node

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `id` | `string` | No | UUID of the field node |
| `uri` | `string` (at-uri) | Yes | AT-URI of the field node |
| `label` | `string` | Yes | Human-readable field name |

### `pub.chive.eprint.searchSubmissions#searchHit`

**Type**: `object`

A search result hit

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `uri` | `string` (at-uri) | Yes | AT-URI of the matched eprint |
| `score` | `integer` | Yes | Relevance score (scaled by 1000 for precision) |
| `title` | `string` | No | Eprint title for display |
| `fields` | `array` | No | Knowledge graph field references |
| `authors` | `array` | No | Author summaries for display |
| `abstract` | `string` | No | Eprint abstract plain text for display |
| `createdAt` | `string` (datetime) | No | When the eprint was created |
| `highlight` | `ref` → `#highlightResult` | No |  |
| `indexedAt` | `string` (datetime) | No | When the eprint was indexed |

### `pub.chive.eprint.searchSubmissions#facetValue`

**Type**: `object`

A facet value with node reference

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `uri` | `string` (at-uri) | Yes | AT-URI of the knowledge graph node |
| `slug` | `string` | No | Node slug for URL generation |
| `count` | `integer` | Yes | Number of documents with this facet value |
| `label` | `string` | Yes | Display label |

### `pub.chive.eprint.searchSubmissions#authorSummary`

**Type**: `object`

Minimal author info for search results

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `did` | `string` (did) | No | Author DID if known |
| `name` | `string` | Yes | Display name |
| `handle` | `string` | No | Author handle (e.g., alice.bsky.social) |
| `avatarUrl` | `string` (uri) | No | Author avatar URL |

### `pub.chive.eprint.searchSubmissions#highlightResult`

**Type**: `object`

Highlighted text fragments with search matches

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `title` | `array` | No | Title fragments with <em> highlighting |
| `abstract` | `array` | No | Abstract fragments with <em> highlighting |

### `pub.chive.eprint.searchSubmissions#facetAggregation`

**Type**: `object`

Aggregation for a facet dimension

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `label` | `string` | No | Display label for the dimension |
| `values` | `array` | Yes |  |
| `subkind` | `string` | Yes | Subkind slug for the dimension's nodes |
| `dimension` | `string` | Yes | Dimension identifier (e.g., 'field', 'topic', 'paperType') |

## Raw Schema

```json
{
  "id": "pub.chive.eprint.searchSubmissions",
  "defs": {
    "main": {
      "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"
    },
    "fieldRef": {
      "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"
    },
    "searchHit": {
      "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"
    },
    "facetValue": {
      "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"
    },
    "authorSummary": {
      "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"
    },
    "highlightResult": {
      "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"
    },
    "facetAggregation": {
      "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"
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1,
  "revision": 1
}
```