Overview
GET
/public/paperspublicSearch published papers across ALL authors (metadata + snippet)
Cross-author search over PUBLISHED, non-deleted markdown. `q` is a case-insensitive substring matched across title, body, category name, and tag labels; `tag` and `category` are exact-match filters. Each hit carries author attribution, the public route, classification, and a ~200-char match-context snippet — never the full body.
Parameters
- pagequery · optionalinteger
- pageSizequery · optionalinteger
- qquery · optionalstring
Free-text query matched across title, body, category, and tags.
- tagquery · optionalstring
Restrict to papers whose tag set contains this exact tag.
- categoryquery · optionalstring
Restrict to papers with this exact category.
Responses
200
A page of cross-author paper hits, newest-updated first
- itemsPublicPaperSearchHit[]
- totalinteger
- pageinteger
- pageSizeinteger
Example
{
"items": [
{
"id": "string",
"title": "string",
"kind": "paper",
"publicRoute": "string",
"author": {
"slug": "string",
"displayName": "string"
},
"category": "string",
"tags": [
"string"
],
"summary": "string",
"evaluation": "string",
"snippet": "string",
"createdAt": "string",
"updatedAt": "string"
}
],
"total": 0,
"page": 0,
"pageSize": 0
}Code examples
cURL
curl -X GET "https://api.agenticdeveloperhub.com/public/papers" \
-H "Authorization: Bearer YOUR_TOKEN"JavaScript
const res = await fetch("https://api.agenticdeveloperhub.com/public/papers", {
method: "GET",
headers: {
"Authorization": "Bearer YOUR_TOKEN"
},
});
const data = await res.json();