> For AI agents: the complete documentation index is available at https://docs.halo.run/llms.txt, the full documentation bundle is available at https://docs.halo.run/llms-full.txt.

# Finder API

## Finder API

### [文章分类](/developer-guide/theme/finder-apis/category.md)

- [getByName(name)](/developer-guide/theme/finder-apis/category.md#getbynamename)
- [getByNames(names)](/developer-guide/theme/finder-apis/category.md#getbynamesnames)
- [list(page,size)](/developer-guide/theme/finder-apis/category.md#listpagesize)
- [listAll()](/developer-guide/theme/finder-apis/category.md#listall)
- [listAsTree()](/developer-guide/theme/finder-apis/category.md#listastree)
- [listAsTree(name)](/developer-guide/theme/finder-apis/category.md#listastreename)
- [getParentByName(name)](/developer-guide/theme/finder-apis/category.md#getparentbynamename)
- [getBreadcrumbs(name)](/developer-guide/theme/finder-apis/category.md#getbreadcrumbsname)
- [类型定义](/developer-guide/theme/finder-apis/category.md#类型定义)

### [文章标签](/developer-guide/theme/finder-apis/tag.md)

- [getByName(name)](/developer-guide/theme/finder-apis/tag.md#getbynamename)
- [getByNames(names)](/developer-guide/theme/finder-apis/tag.md#getbynamesnames)
- [list(page,size)](/developer-guide/theme/finder-apis/tag.md#listpagesize)
- [listAll()](/developer-guide/theme/finder-apis/tag.md#listall)
- [类型定义](/developer-guide/theme/finder-apis/tag.md#类型定义)

### [文章](/developer-guide/theme/finder-apis/post.md)

- [getByName(postName)](/developer-guide/theme/finder-apis/post.md#getbynamepostname)
- [content(postName)](/developer-guide/theme/finder-apis/post.md#contentpostname)
- [cursor(postName)](/developer-guide/theme/finder-apis/post.md#cursorpostname)
- [cursorByCategory(postName)](/developer-guide/theme/finder-apis/post.md#cursorbycategorypostname)
- [listAll()](/developer-guide/theme/finder-apis/post.md#listall)
- [random(maxSize)](/developer-guide/theme/finder-apis/post.md#randommaxsize)
- [`list({...})`](/developer-guide/theme/finder-apis/post.md#list)
- [list(page,size)](/developer-guide/theme/finder-apis/post.md#listpagesize)
- [listByCategory(page,size,categoryName)](/developer-guide/theme/finder-apis/post.md#listbycategorypagesizecategoryname)
- [listByTag(page,size,tag)](/developer-guide/theme/finder-apis/post.md#listbytagpagesizetag)
- [listByOwner(page,size,owner)](/developer-guide/theme/finder-apis/post.md#listbyownerpagesizeowner)
- [archives(page,size)](/developer-guide/theme/finder-apis/post.md#archivespagesize)
- [archives(page,size,year)](/developer-guide/theme/finder-apis/post.md#archivespagesizeyear)
- [archives(page,size,year,month)](/developer-guide/theme/finder-apis/post.md#archivespagesizeyearmonth)
- [类型定义](/developer-guide/theme/finder-apis/post.md#类型定义)

### [独立页面](/developer-guide/theme/finder-apis/single-page.md)

- [getByName(pageName)](/developer-guide/theme/finder-apis/single-page.md#getbynamepagename)
- [content(pageName)](/developer-guide/theme/finder-apis/single-page.md#contentpagename)
- [list(page,size)](/developer-guide/theme/finder-apis/single-page.md#listpagesize)
- [类型定义](/developer-guide/theme/finder-apis/single-page.md#类型定义)

### [评论](/developer-guide/theme/finder-apis/comment.md)

- [getByName(name)](/developer-guide/theme/finder-apis/comment.md#getbynamename)
- [list(ref,page,size)](/developer-guide/theme/finder-apis/comment.md#listrefpagesize)
- [listReply(commentName,page,size)](/developer-guide/theme/finder-apis/comment.md#listreplycommentnamepagesize)
- [类型定义](/developer-guide/theme/finder-apis/comment.md#类型定义)

### [作者](/developer-guide/theme/finder-apis/contributor.md)

- [getContributor(name)](/developer-guide/theme/finder-apis/contributor.md#getcontributorname)
- [getContributors(names)](/developer-guide/theme/finder-apis/contributor.md#getcontributorsnames)
- [类型定义](/developer-guide/theme/finder-apis/contributor.md#类型定义)

### [导航菜单](/developer-guide/theme/finder-apis/menu.md)

- [getByName(name)](/developer-guide/theme/finder-apis/menu.md#getbynamename)
- [getPrimary()](/developer-guide/theme/finder-apis/menu.md#getprimary)
- [类型定义](/developer-guide/theme/finder-apis/menu.md#类型定义)

### [站点统计](/developer-guide/theme/finder-apis/site-stats.md)

- [getStats()](/developer-guide/theme/finder-apis/site-stats.md#getstats)
- [类型定义](/developer-guide/theme/finder-apis/site-stats.md#类型定义)

### [主题](/developer-guide/theme/finder-apis/theme.md)

- [activation()](/developer-guide/theme/finder-apis/theme.md#activation)
- [getByName(themeName)](/developer-guide/theme/finder-apis/theme.md#getbynamethemename)
- [类型定义](/developer-guide/theme/finder-apis/theme.md#类型定义)

### [插件](/developer-guide/theme/finder-apis/plugin.md)

- [available(pluginName)](/developer-guide/theme/finder-apis/plugin.md#availablepluginname)
- [available(pluginName, requiresVersion)](/developer-guide/theme/finder-apis/plugin.md#availablepluginname-requiresversion)