{
"id": "fyi.atstore.reviews.listForListing",
"defs": {
"main": {
"type": "query",
"errors": [
{
"name": "ListingNotFound"
},
{
"name": "InvalidParams"
},
{
"name": "InvalidCursor"
}
],
"output": {
"schema": {
"type": "object",
"required": [
"reviews"
],
"properties": {
"cursor": {
"type": "string",
"maxLength": 512
},
"reviews": {
"type": "array",
"items": {
"ref": "#listingReviewView",
"type": "ref"
}
}
}
},
"encoding": "application/json"
},
"parameters": {
"type": "params",
"required": [
"uri"
],
"properties": {
"uri": {
"type": "string",
"format": "at-uri",
"maxLength": 2560,
"description": "AT URI of the fyi.atstore.listing.detail record."
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"maxLength": 512
}
}
},
"description": "List reviews for a directory listing (mirrored Tap data plus profile enrichment)."
},
"listingReviewView": {
"type": "object",
"required": [
"id",
"authorDid",
"rating",
"reviewCreatedAt",
"replyCount",
"canReply"
],
"properties": {
"id": {
"type": "string",
"maxLength": 64
},
"text": {
"type": "string",
"nullable": true,
"maxLength": 8000
},
"rating": {
"type": "integer",
"maximum": 5,
"minimum": 1
},
"canReply": {
"type": "boolean"
},
"authorDid": {
"type": "string",
"format": "did",
"maxLength": 2048
},
"replyCount": {
"type": "integer"
},
"authorHandle": {
"type": "string",
"nullable": true,
"maxLength": 512
},
"authorAvatarUrl": {
"type": "string",
"nullable": true,
"maxLength": 8192
},
"reviewCreatedAt": {
"type": "string",
"format": "datetime",
"maxLength": 64
},
"authorDisplayName": {
"type": "string",
"nullable": true,
"maxLength": 640
}
}
}
},
"$type": "com.atproto.lexicon.schema",
"lexicon": 1
}