pub.chive.graph.browseFaceted

chive.pub View official

Documentation

Browse eprints using dynamic faceted classification from the knowledge graph

main query

Browse eprints using dynamic faceted classification from the knowledge graph

Parameters

cursor string Optional

Pagination cursor

facets string Optional

JSON-encoded facet filters keyed by facet slug (e.g., {"methodology":["meta-analysis"]})

limit integer Optional

Maximum results to return

q string Optional

Optional text query

Output

Encodingapplication/json
cursor string Optional

Pagination cursor for next page

facets array Required

Available facet refinements

hasMore boolean Required

Whether more results exist

hits array Required

Matching eprints

impressionId string Optional

Impression ID for click tracking

total integer Required

Total count of matching eprints

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
Pagination cursor
JSON-encoded facet filters keyed by facet slug (e.g., {"methodology":["meta-analysis"]})
Maximum results to return
Optional text query
View raw schema 
{
  "description": "Browse eprints using dynamic faceted classification from the knowledge graph",
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "cursor": {
          "description": "Pagination cursor for next page",
          "type": "string"
        },
        "facets": {
          "description": "Available facet refinements",
          "items": {
            "ref": "#facetDefinition",
            "type": "ref"
          },
          "type": "array"
        },
        "hasMore": {
          "description": "Whether more results exist",
          "type": "boolean"
        },
        "hits": {
          "description": "Matching eprints",
          "items": {
            "ref": "#eprintSummary",
            "type": "ref"
          },
          "type": "array"
        },
        "impressionId": {
          "description": "Impression ID for click tracking",
          "type": "string"
        },
        "total": {
          "description": "Total count of matching eprints",
          "type": "integer"
        }
      },
      "required": [
        "hits",
        "facets",
        "hasMore",
        "total"
      ],
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "cursor": {
        "description": "Pagination cursor",
        "type": "string"
      },
      "facets": {
        "description": "JSON-encoded facet filters keyed by facet slug (e.g., {\"methodology\":[\"meta-analysis\"]})",
        "type": "string"
      },
      "limit": {
        "default": 20,
        "description": "Maximum results to return",
        "maximum": 100,
        "minimum": 1,
        "type": "integer"
      },
      "q": {
        "description": "Optional text query",
        "type": "string"
      }
    },
    "type": "params"
  },
  "type": "query"
}
authorRef object

Author reference with contributions

Properties

avatarUrl string Optional

Avatar image URL

did string did Optional

Author DID

email string Optional

Contact email

handle string Optional

ATProto handle

isCorrespondingAuthor boolean Optional

Whether this is the corresponding author

isHighlighted boolean Optional

Whether this author should be highlighted

name string Required

Display name

orcid string Optional

ORCID identifier

order integer Required

Author order (1-based)

View raw schema 
{
  "description": "Author reference with contributions",
  "properties": {
    "affiliations": {
      "description": "Author affiliations",
      "items": {
        "ref": "pub.chive.defs#affiliation",
        "type": "ref"
      },
      "type": "array"
    },
    "avatarUrl": {
      "description": "Avatar image URL",
      "type": "string"
    },
    "contributions": {
      "description": "CRediT contributions",
      "items": {
        "ref": "#contributionRef",
        "type": "ref"
      },
      "type": "array"
    },
    "did": {
      "description": "Author DID",
      "format": "did",
      "type": "string"
    },
    "email": {
      "description": "Contact email",
      "type": "string"
    },
    "handle": {
      "description": "ATProto handle",
      "type": "string"
    },
    "isCorrespondingAuthor": {
      "description": "Whether this is the corresponding author",
      "type": "boolean"
    },
    "isHighlighted": {
      "description": "Whether this author should be highlighted",
      "type": "boolean"
    },
    "name": {
      "description": "Display name",
      "type": "string"
    },
    "orcid": {
      "description": "ORCID identifier",
      "type": "string"
    },
    "order": {
      "description": "Author order (1-based)",
      "type": "integer"
    }
  },
  "required": [
    "name",
    "order",
    "affiliations",
    "contributions"
  ],
  "type": "object"
}
contributionRef object

CRediT contribution

Properties

degree string Optional

Degree of contribution

Known values: lead, equal, supporting
typeId string Required

Contribution type identifier

typeLabel string Required

Contribution type label

typeUri string at-uri Required

AT-URI of contribution type node

View raw schema 
{
  "description": "CRediT contribution",
  "properties": {
    "degree": {
      "description": "Degree of contribution",
      "knownValues": [
        "lead",
        "equal",
        "supporting"
      ],
      "type": "string"
    },
    "typeId": {
      "description": "Contribution type identifier",
      "type": "string"
    },
    "typeLabel": {
      "description": "Contribution type label",
      "type": "string"
    },
    "typeUri": {
      "description": "AT-URI of contribution type node",
      "format": "at-uri",
      "type": "string"
    }
  },
  "required": [
    "typeUri",
    "typeId",
    "typeLabel"
  ],
  "type": "object"
}
eprintSummary object

Eprint summary for faceted browse results

Properties

abstract array of union Required

Rich abstract with text, formatting, and entity references

maxLength: 500 items
Known types:
authors array of ref#authorRef Required

All authors with contributions

cid string Required

CID of indexed version

createdAt string datetime Required

Creation timestamp

fields array of ref#fieldRef Optional

Subject fields

highlights unknown Optional

Search highlights keyed by field

indexedAt string datetime Required

Index timestamp

keywords array of string Optional

Keywords

license string Required

License identifier

paperDid string did Optional

Paper DID if paper has its own PDS

score integer Optional

Relevance score (scaled by 1000 for 0.0-1.0 range)

minimum: 0maximum: 1000
source ref #sourceInfo Required

Source PDS information

submittedBy string did Required

DID of human user who submitted

title string Required

Eprint title

uri string at-uri Required

Eprint AT-URI

View raw schema 
{
  "description": "Eprint summary for faceted browse results",
  "properties": {
    "abstract": {
      "description": "Rich abstract with text, formatting, and entity references",
      "items": {
        "refs": [
          "pub.chive.richtext.defs#textItem",
          "pub.chive.richtext.defs#nodeRefItem",
          "pub.chive.richtext.defs#wikidataRefItem",
          "pub.chive.richtext.defs#fieldRefItem",
          "pub.chive.richtext.defs#facetRefItem",
          "pub.chive.richtext.defs#eprintRefItem",
          "pub.chive.richtext.defs#annotationRefItem",
          "pub.chive.richtext.defs#authorRefItem",
          "pub.chive.richtext.defs#mentionItem",
          "pub.chive.richtext.defs#linkItem",
          "pub.chive.richtext.defs#tagItem",
          "pub.chive.richtext.defs#latexItem",
          "pub.chive.richtext.defs#codeBlockItem",
          "pub.chive.richtext.defs#headingItem",
          "pub.chive.richtext.defs#listItem",
          "pub.chive.richtext.defs#blockquoteItem"
        ],
        "type": "union"
      },
      "maxLength": 500,
      "type": "array"
    },
    "authors": {
      "description": "All authors with contributions",
      "items": {
        "ref": "#authorRef",
        "type": "ref"
      },
      "type": "array"
    },
    "cid": {
      "description": "CID of indexed version",
      "type": "string"
    },
    "createdAt": {
      "description": "Creation timestamp",
      "format": "datetime",
      "type": "string"
    },
    "fields": {
      "description": "Subject fields",
      "items": {
        "ref": "#fieldRef",
        "type": "ref"
      },
      "type": "array"
    },
    "highlights": {
      "description": "Search highlights keyed by field",
      "type": "unknown"
    },
    "indexedAt": {
      "description": "Index timestamp",
      "format": "datetime",
      "type": "string"
    },
    "keywords": {
      "description": "Keywords",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "license": {
      "description": "License identifier",
      "type": "string"
    },
    "paperDid": {
      "description": "Paper DID if paper has its own PDS",
      "format": "did",
      "type": "string"
    },
    "score": {
      "description": "Relevance score (scaled by 1000 for 0.0-1.0 range)",
      "maximum": 1000,
      "minimum": 0,
      "type": "integer"
    },
    "source": {
      "description": "Source PDS information",
      "ref": "#sourceInfo",
      "type": "ref"
    },
    "submittedBy": {
      "description": "DID of human user who submitted",
      "format": "did",
      "type": "string"
    },
    "title": {
      "description": "Eprint title",
      "type": "string"
    },
    "uri": {
      "description": "Eprint AT-URI",
      "format": "at-uri",
      "type": "string"
    }
  },
  "required": [
    "uri",
    "cid",
    "title",
    "abstract",
    "authors",
    "submittedBy",
    "license",
    "createdAt",
    "indexedAt",
    "source"
  ],
  "type": "object"
}
facetDefinition object

Facet definition from the knowledge graph

Properties

description string Optional

Facet description

label string Required

Display label

slug string Required

Facet slug identifier

values array of ref#facetValue Required

Available values with counts

View raw schema 
{
  "description": "Facet definition from the knowledge graph",
  "properties": {
    "description": {
      "description": "Facet description",
      "type": "string"
    },
    "label": {
      "description": "Display label",
      "type": "string"
    },
    "slug": {
      "description": "Facet slug identifier",
      "type": "string"
    },
    "values": {
      "description": "Available values with counts",
      "items": {
        "ref": "#facetValue",
        "type": "ref"
      },
      "type": "array"
    }
  },
  "required": [
    "slug",
    "label",
    "values"
  ],
  "type": "object"
}
facetValue object

Facet value with count

Properties

count integer Required

Number of eprints with this value

label string Optional

Display label

value string Required

Facet value

View raw schema 
{
  "description": "Facet value with count",
  "properties": {
    "count": {
      "description": "Number of eprints with this value",
      "type": "integer"
    },
    "label": {
      "description": "Display label",
      "type": "string"
    },
    "value": {
      "description": "Facet value",
      "type": "string"
    }
  },
  "required": [
    "value",
    "count"
  ],
  "type": "object"
}
fieldRef object

Subject field reference

Properties

id string Optional

Field identifier

label string Required

Field label

parentUri string at-uri Optional

Parent field AT-URI

uri string at-uri Required

Field AT-URI

View raw schema 
{
  "description": "Subject field reference",
  "properties": {
    "id": {
      "description": "Field identifier",
      "type": "string"
    },
    "label": {
      "description": "Field label",
      "type": "string"
    },
    "parentUri": {
      "description": "Parent field AT-URI",
      "format": "at-uri",
      "type": "string"
    },
    "uri": {
      "description": "Field AT-URI",
      "format": "at-uri",
      "type": "string"
    }
  },
  "required": [
    "uri",
    "label"
  ],
  "type": "object"
}
sourceInfo object

Source PDS information

Properties

blobUrl string Optional

Blob URL

lastVerifiedAt string datetime Optional

Last verification timestamp

pdsEndpoint string Required

PDS endpoint URL

recordUrl string Optional

Direct record URL

stale boolean Optional

Whether data is potentially stale

View raw schema 
{
  "description": "Source PDS information",
  "properties": {
    "blobUrl": {
      "description": "Blob URL",
      "type": "string"
    },
    "lastVerifiedAt": {
      "description": "Last verification timestamp",
      "format": "datetime",
      "type": "string"
    },
    "pdsEndpoint": {
      "description": "PDS endpoint URL",
      "type": "string"
    },
    "recordUrl": {
      "description": "Direct record URL",
      "type": "string"
    },
    "stale": {
      "description": "Whether data is potentially stale",
      "type": "boolean"
    }
  },
  "required": [
    "pdsEndpoint"
  ],
  "type": "object"
}

Lexicon Garden

@