full diff

pub.chive.tag.search

From
bafyreihcnc2kbvq7hhn6zdlgjud2na2pzlrpj6iic6g6infnrgaluix7ae indexed 2026-06-18 13:14 UTC View this version
To
bafyreihcnc2kbvq7hhn6zdlgjud2na2pzlrpj6iic6g6infnrgaluix7ae indexed 2026-06-18 13:14 UTC View this version

Compatibility

backward compatible No changes detected.

Changes

11{
22 "$type": "com.atproto.lexicon.schema",
33 "defs": {
44 "main": {
55 "description": "Search for tags matching a query",
66 "errors": [],
77 "output": {
88 "encoding": "application/json",
99 "schema": {
1010 "properties": {
1111 "cursor": {
1212 "description": "Cursor for next page",
1313 "type": "string"
1414 },
1515 "hasMore": {
1616 "description": "Whether more results are available",
1717 "type": "boolean"
1818 },
1919 "tags": {
2020 "description": "Search results",
2121 "items": {
2222 "ref": "#tagSummary",
2323 "type": "ref"
2424 },
2525 "type": "array"
2626 },
2727 "total": {
2828 "description": "Total count of matching tags",
2929 "minimum": 0,
3030 "type": "integer"
3131 }
3232 },
3333 "required": [
3434 "tags",
3535 "hasMore"
3636 ],
3737 "type": "object"
3838 }
3939 },
4040 "parameters": {
4141 "properties": {
4242 "cursor": {
4343 "description": "Pagination cursor for next page",
4444 "type": "string"
4545 },
4646 "includeSpam": {
4747 "default": false,
4848 "description": "Include tags flagged as potential spam",
4949 "type": "boolean"
5050 },
5151 "limit": {
5252 "default": 50,
5353 "description": "Maximum number of results to return",
5454 "maximum": 100,
5555 "minimum": 1,
5656 "type": "integer"
5757 },
5858 "minQuality": {
5959 "description": "Minimum quality score (0-100, scaled from 0-1)",
6060 "maximum": 100,
6161 "minimum": 0,
6262 "type": "integer"
6363 },
6464 "q": {
6565 "description": "Search query",
6666 "maxLength": 100,
6767 "minLength": 2,
6868 "type": "string"
6969 }
7070 },
7171 "required": [
7272 "q"
7373 ],
7474 "type": "params"
7575 },
7676 "type": "query"
7777 },
7878 "promotionTarget": {
7979 "description": "Target of tag promotion",
8080 "properties": {
8181 "type": {
8282 "description": "Type of promotion target",
8383 "knownValues": [
8484 "facet",
8585 "authority"
8686 ],
8787 "type": "string"
8888 },
8989 "uri": {
9090 "description": "URI of the promotion target",
9191 "type": "string"
9292 }
9393 },
9494 "required": [
9595 "type",
9696 "uri"
9797 ],
9898 "type": "object"
9999 },
100100 "tagSummary": {
101101 "description": "Summary information for a tag",
102102 "properties": {
103103 "displayForms": {
104104 "description": "All display forms used for this tag",
105105 "items": {
106106 "type": "string"
107107 },
108108 "type": "array"
109109 },
110110 "isPromoted": {
111111 "description": "Whether the tag has been promoted to a facet or authority",
112112 "type": "boolean"
113113 },
114114 "normalizedForm": {
115115 "description": "Normalized tag form (lowercase, hyphenated)",
116116 "type": "string"
117117 },
118118 "promotedTo": {
119119 "description": "Promotion target if promoted",
120120 "ref": "#promotionTarget",
121121 "type": "ref"
122122 },
123123 "qualityScore": {
124124 "description": "Tag quality score (0-100, scaled from 0-1)",
125125 "maximum": 100,
126126 "minimum": 0,
127127 "type": "integer"
128128 },
129129 "usageCount": {
130130 "description": "Number of eprints tagged with this tag",
131131 "minimum": 0,
132132 "type": "integer"
133133 }
134134 },
135135 "required": [
136136 "normalizedForm",
137137 "displayForms",
138138 "usageCount",
139139 "qualityScore",
140140 "isPromoted"
141141 ],
142142 "type": "object"
143143 }
144144 },
145145 "id": "pub.chive.tag.search",
146146 "lexicon": 1,
147147 "revision": 1
148148}