Returns a paginated list of packages matching the query and filters. Results that are subject to a hard-enforcement label (e.g. !takedown, security:yanked) from a trusted labeller the request accepts are filtered out; other label state is hydrated on each result.
Parameters
capability
string
Optional
Optional filter: only return packages that declare this access category (e.g. 'email', 'network'). Compares against the latest release's declaredAccess top-level keys.
cursor
string
Optional
Pagination cursor from a previous response.
limit
integer
Optional
Max results to return.
q
string
Optional
Free-text search query. An exact handle, DID, or identity/slug pair searches that publisher or package. Other values match against name, description, keywords, and authors. Empty or absent returns all packages.
Output
application/jsoncursor
string
Optional
Cursor to fetch the next page. Absent when there are no more results.
packages
array
Required
No description available.
Try It
Requests are sent directly from your browser. Some servers may block requests due to CORS.
View raw schema
{
"description": "Returns a paginated list of packages matching the query and filters. Results that are subject to a hard-enforcement label (e.g. !takedown, security:yanked) from a trusted labeller the request accepts are filtered out; other label state is hydrated on each result.",
"output": {
"encoding": "application/json",
"schema": {
"properties": {
"cursor": {
"description": "Cursor to fetch the next page. Absent when there are no more results.",
"maxLength": 1024,
"type": "string"
},
"packages": {
"items": {
"ref": "com.emdashcms.experimental.aggregator.defs#packageView",
"type": "ref"
},
"maxLength": 100,
"type": "array"
}
},
"required": [
"packages"
],
"type": "object"
}
},
"parameters": {
"properties": {
"capability": {
"description": "Optional filter: only return packages that declare this access category (e.g. 'email', 'network'). Compares against the latest release's declaredAccess top-level keys.",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"cursor": {
"description": "Pagination cursor from a previous response.",
"maxLength": 1024,
"type": "string"
},
"limit": {
"default": 25,
"description": "Max results to return.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"q": {
"description": "Free-text search query. An exact handle, DID, or identity/slug pair searches that publisher or package. Other values match against name, description, keywords, and authors. Empty or absent returns all packages.",
"maxLength": 256,
"type": "string"
}
},
"type": "params"
},
"type": "query"
}