公开接口能帮你做成什么事

这个站提供一套公开的只读 REST 接口（当前版本 v1），地址都在 wallhaven.cc/api/v1/ 路径下。官方文档在帮助区的 API 页，全程免费、无需注册即可用，带密钥可解锁更多。

四类只读能力 + 一个个人端点

端点	返回什么	要密钥吗
`wallhaven.cc/api/v1/search`	搜索结果列表（24 张/页）	不强制；带上则套用你的偏好
`wallhaven.cc/api/v1/w/{id}`	单张图的完整元数据	游客仅 SFW
`wallhaven.cc/api/v1/tag/{id}`	标签详情（名称/别名/类别）	否
`wallhaven.cc/api/v1/collections/{用户名}`	某用户的公开收藏夹	私有册要密钥
`wallhaven.cc/api/v1/settings`	自己的浏览设置	必须

所有请求就是普通 GET：浏览器地址栏、httpx、curl 都能直接调，返回标准 JSON。