pub.chive.review.listForAuthor

chive.pub View official

Documentation

List reviews created by a specific author with optional filtering

main query

List reviews created by a specific author with optional filtering

Parameters

cursor string Optional

Pagination cursor for next page

inlineOnly boolean Optional

Only include inline annotations with text span targets

limit integer Optional

Maximum number of results to return

motivation string Optional

Filter by W3C Web Annotation motivation

reviewerDid string did Required

DID of the reviewer

Output

Encodingapplication/json
cursor string Optional

Cursor for next page

hasMore boolean Required

Whether more results are available

reviews array Required

List of reviews by the author

total integer Optional

Total number of reviews by this author

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 for next page
Only include inline annotations with text span targets
Maximum number of results to return
Filter by W3C Web Annotation motivation
DID of the reviewer
View raw schema 
{
  "description": "List reviews created by a specific author with optional filtering",
  "errors": [],
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "cursor": {
          "description": "Cursor for next page",
          "type": "string"
        },
        "hasMore": {
          "description": "Whether more results are available",
          "type": "boolean"
        },
        "reviews": {
          "description": "List of reviews by the author",
          "items": {
            "ref": "#reviewView",
            "type": "ref"
          },
          "type": "array"
        },
        "total": {
          "description": "Total number of reviews by this author",
          "type": "integer"
        }
      },
      "required": [
        "reviews",
        "hasMore"
      ],
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "cursor": {
        "description": "Pagination cursor for next page",
        "type": "string"
      },
      "inlineOnly": {
        "default": false,
        "description": "Only include inline annotations with text span targets",
        "type": "boolean"
      },
      "limit": {
        "default": 50,
        "description": "Maximum number of results to return",
        "maximum": 100,
        "minimum": 1,
        "type": "integer"
      },
      "motivation": {
        "description": "Filter by W3C Web Annotation motivation",
        "knownValues": [
          "commenting",
          "highlighting",
          "questioning",
          "replying",
          "assessing",
          "bookmarking",
          "classifying",
          "describing",
          "editing",
          "linking",
          "moderating",
          "tagging"
        ],
        "type": "string"
      },
      "reviewerDid": {
        "description": "DID of the reviewer",
        "format": "did",
        "type": "string"
      }
    },
    "required": [
      "reviewerDid"
    ],
    "type": "params"
  },
  "type": "query"
}
authorRef object

No description available.

Properties

avatar string uri Optional

A valid URI.

did string did Required

A decentralized identifier (DID).

displayName string Optional

No description available.

handle string Optional

No description available.

View raw schema 
{
  "properties": {
    "avatar": {
      "format": "uri",
      "type": "string"
    },
    "did": {
      "format": "did",
      "type": "string"
    },
    "displayName": {
      "type": "string"
    },
    "handle": {
      "type": "string"
    }
  },
  "required": [
    "did"
  ],
  "type": "object"
}
reviewView object

View of a review/comment

Properties

author ref #authorRef Required

No description available.

body array of union Optional

Rich text body items

maxLength: 500 items
Known types:
bodyPlainText string Optional

Plain text body for search/preview

cid string Required

Content identifier

content string Required

Plain text content of the review

createdAt string datetime Required

When the review was created

eprintTitle string Optional

Title of the reviewed eprint

eprintUri string at-uri Required

AT-URI of the eprint being reviewed

indexedAt string datetime Required

When the review was indexed

motivation string Required

W3C Web Annotation motivation

Known values: commenting, highlighting, questioning, replying, assessing, bookmarking, classifying, describing, editing, linking, moderating, tagging
parentReviewUri string at-uri Optional

Parent review URI for threaded replies

replyCount integer Required

Number of direct replies

minimum: 0
target ref #textSpanTarget Optional

Target text span for inline annotations

uri string at-uri Required

Review AT-URI

View raw schema 
{
  "description": "View of a review/comment",
  "properties": {
    "author": {
      "ref": "#authorRef",
      "type": "ref"
    },
    "body": {
      "description": "Rich text body items",
      "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"
    },
    "bodyPlainText": {
      "description": "Plain text body for search/preview",
      "type": "string"
    },
    "cid": {
      "description": "Content identifier",
      "type": "string"
    },
    "content": {
      "description": "Plain text content of the review",
      "type": "string"
    },
    "createdAt": {
      "description": "When the review was created",
      "format": "datetime",
      "type": "string"
    },
    "eprintTitle": {
      "description": "Title of the reviewed eprint",
      "type": "string"
    },
    "eprintUri": {
      "description": "AT-URI of the eprint being reviewed",
      "format": "at-uri",
      "type": "string"
    },
    "indexedAt": {
      "description": "When the review was indexed",
      "format": "datetime",
      "type": "string"
    },
    "motivation": {
      "description": "W3C Web Annotation motivation",
      "knownValues": [
        "commenting",
        "highlighting",
        "questioning",
        "replying",
        "assessing",
        "bookmarking",
        "classifying",
        "describing",
        "editing",
        "linking",
        "moderating",
        "tagging"
      ],
      "type": "string"
    },
    "parentReviewUri": {
      "description": "Parent review URI for threaded replies",
      "format": "at-uri",
      "type": "string"
    },
    "replyCount": {
      "description": "Number of direct replies",
      "minimum": 0,
      "type": "integer"
    },
    "target": {
      "description": "Target text span for inline annotations",
      "ref": "#textSpanTarget",
      "type": "ref"
    },
    "uri": {
      "description": "Review AT-URI",
      "format": "at-uri",
      "type": "string"
    }
  },
  "required": [
    "uri",
    "cid",
    "author",
    "eprintUri",
    "content",
    "motivation",
    "replyCount",
    "createdAt",
    "indexedAt"
  ],
  "type": "object"
}
textPositionSelector object

W3C Text Position Selector with optional page info

Properties

end integer Required

No description available.

minimum: 0
pageNumber integer Optional

Page number in PDF

minimum: 1
start integer Required

No description available.

minimum: 0
type string Required

No description available.

View raw schema 
{
  "description": "W3C Text Position Selector with optional page info",
  "properties": {
    "end": {
      "minimum": 0,
      "type": "integer"
    },
    "pageNumber": {
      "description": "Page number in PDF",
      "minimum": 1,
      "type": "integer"
    },
    "start": {
      "minimum": 0,
      "type": "integer"
    },
    "type": {
      "const": "TextPositionSelector",
      "type": "string"
    }
  },
  "required": [
    "type",
    "start",
    "end"
  ],
  "type": "object"
}
textQuoteSelector object

W3C Text Quote Selector

Properties

exact string Required

No description available.

maxLength: 1000 bytes
prefix string Optional

No description available.

maxLength: 100 bytes
suffix string Optional

No description available.

maxLength: 100 bytes
type string Required

No description available.

View raw schema 
{
  "description": "W3C Text Quote Selector",
  "properties": {
    "exact": {
      "maxLength": 1000,
      "type": "string"
    },
    "prefix": {
      "maxLength": 100,
      "type": "string"
    },
    "suffix": {
      "maxLength": 100,
      "type": "string"
    },
    "type": {
      "const": "TextQuoteSelector",
      "type": "string"
    }
  },
  "required": [
    "type",
    "exact"
  ],
  "type": "object"
}
textSpanTarget object

Target text span for inline annotations (W3C Web Annotation compatible)

Properties

page integer Optional

Page number (deprecated, use refinedBy.pageNumber)

minimum: 1
source string at-uri Required

Eprint AT-URI

View raw schema 
{
  "description": "Target text span for inline annotations (W3C Web Annotation compatible)",
  "properties": {
    "page": {
      "description": "Page number (deprecated, use refinedBy.pageNumber)",
      "minimum": 1,
      "type": "integer"
    },
    "refinedBy": {
      "description": "Position refinement with page info",
      "ref": "#textPositionSelector",
      "type": "ref"
    },
    "selector": {
      "description": "Text quote selector",
      "ref": "#textQuoteSelector",
      "type": "ref"
    },
    "source": {
      "description": "Eprint AT-URI",
      "format": "at-uri",
      "type": "string"
    }
  },
  "required": [
    "source"
  ],
  "type": "object"
}

Lexicon Garden

@