Unsplash Photo Search API：照片检索与链接

Unsplash 官方文档提供照片检索 GET API，需注册应用并使用 access key；公开检索无需终端用户登录。结果含照片摘要与动态图片 URL，要求 hotlink 和署名。demo 50次/小时、生产审批后1000次/小时；仅文档核对。

根据公开资料整理 · 尚未被提供者认领。提交者名称和样例测试不是提供者授权、本站认证或持续可用承诺。

整理进度：已整理 · 语义分类：图片素材／Unsplash 关键词照片检索 API · 证据等级：公开文档，未实测。

公开来源正文附件（安全文本） · 5743c139b1119ed0881d31e05a32b037da09c5f98ebcdf2c9a31281e2046610c

本卡以 GET /search/photos 关键词检索为例，返回分页照片摘要、作者及图片 URL，单图完整详情另读对应资源。应用开发者仍需账号和 key，不能把公开检索误当无认证接口。本次未注册应用、获取密钥、调用搜索或下载图片。

NavoNavo 是公共能力目录，保留来源、适用条件与使用说明。继续按条件查找 · 认识目录与机器入口

固定版本的深度资料

名片 cap-e23c21242585f849d4cd3197 · 版本 2 · 保存此版本引用

尚未深检；没有深度profile，条件保持未知，不表示不支持。

资料与来源声明不等于本站实测；未列出的条件仍未知。

结构化配方只按公开声明检查约束与接口，不执行任务或授予权限；缺失记录保持未知，接口兼容不证明实际成功。

稳定标识: cap-e23c21242585f849d4cd3197
名片版本: 2
资料更新: 2026-10-24T18:11:53.0144639+00:00
原作者 / 提供者: Unsplash
可用状态: 未知；收录不代表正在接单或有实时库存。
本站收费: 免费；第三方条件另行核对。

输入

query 搜索词；page 默认1，per_page 默认10、全局最大30。
可选 order_by=latest/relevant、collections、color、orientation=landscape/portrait/squarish、content_filter=low/high。
lang 为需另申请的 beta 参数，不能默认所有应用可用。

输出

搜索 JSON 含 total、total_pages、results；photo 为摘要对象，含 id、尺寸、描述、blur_hash、user、urls 和 links 等。
urls 提供 raw/full/regular/small/thumb 等动态图片地址，可用 w/h/fm/q/fit/dpr 等受支持参数变换并保留 ixid。
响应 header 包含分页 Link 与 X-Ratelimit-Limit/Remaining；图片二进制由返回的 CDN URL 获取，搜索本身返回 JSON。

使用方式

类型: HTTP 接口
入口: 原使用入口
HTTP 方法: GET

鉴权：API 密钥。公开检索需应用 access key，官方用 Client-ID header 或 client_id query 传递；终端用户无需登录。用户私有/个性化或代用户操作另需 OAuth 用户授权，本次没有任何凭据。

运行前提

开发者需加入 Unsplash 并注册应用，初始 demo 配额；生产额度需审核。
遵守 API guidelines，给摄影师与 Unsplash 署名，直接使用/嵌入返回图片 URL（hotlink）。
调整图片 URL 时保留 ixid；图片使用不等于自由复制、移除归因或不限用途。
建议 Accept-Version:v1；不安装 SDK、不调用 download tracking 或抓取图像。

公开请求示例

{
  "headers": {
    "Accept-Version": "v1"
  },
  "method": "GET",
  "notes": "\u4F9D\u636E\u672C\u6279\u68C0\u7D22\u6587\u6863\u6574\u7406\uFF0C\u53E6\u9700\u5E94\u7528 access key\uFF1B\u672A\u6267\u884C\u3002",
  "query": {
    "page": 1,
    "per_page": 10,
    "query": "office"
  },
  "url": "https://api.unsplash.com/search/photos"
}

代码仓库不是正在运行的 API；网页可打开不证明业务成功。外部命令仅为资料，执行、资料分享和付费需另行授权。

第三方价格与条款

未知。页面标题称 Free HD Photo API，正文明确 demo/production 请求额度与审批，但未列完整费用或超额/特殊使用计费条款；保留价格边界未知。

价格来源 · 未知

资料去向

提供者服务器。应用 key 与检索词由 Unsplash API 处理，hotlink/ixid 用于照片浏览统计；本页未说明请求日志或保留期限。本次未查询、注册、授权或下载。

限制

官方文档 demo 50次/小时、生产获批1000次/小时；只有 api.unsplash.com JSON 请求计入该额度，图片文件请求不计入。
图片必须 hotlink 并符合署名/API guidelines；完整条款页未包含，不能由 Free 标题推断任意用途许可。
GET /photos/:id/download 是下载统计 endpoint，不是嵌图地址；不要将其返回流程混同图片展示。
content_filter=high 不能保证移除所有不适宜内容；列表为摘要，完整对象需单独获取。

仍需核对

真实应用审批/权限、当前配额执行、完整费用条款和 SLA 未验证。
完整 API guidelines/使用条款及日志保留政策不在本附件；没有实测图像与搜索结果。

提交者报告的验证

仅查阅资料 · 未测试

仅读取公开来源；未调用所述工具。

日期: 2026-10-24T18:10:49.1619235+00:00
软件版本: 未知

实际检查

来源HTTPS响应可读取

未验证范围

功能、鉴权、安装、输出质量、长期可用性均未由本站测试。

公开证据

这是有条件的提交者观察。HTTP、安装、执行、输出核对和用户验收分别判断；不计算总体成功率或商业收入。

来源与贡献者

主要公开来源

Unsplash API Documentation | Free HD Photo API | Unsplash · 官方文档 · 2026-10-25T02:10:49.1619235+08:00

提交者自述：NAVONAVO public material importer。名称未经身份核验，不等于原作者或执行方。

本次来源读取范围

{
  "url": "https://unsplash.com/documentation",
  "final_url": "https://unsplash.com/documentation",
  "status_code": 200,
  "title": "Unsplash API Documentation | Free HD Photo API | Unsplash",
  "description": "Documentation for the world",
  "checked_at": "2026-10-24T18:10:49.1619235\u002B00:00",
  "warnings": [
    "\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
  ]
}

公开使用观察

暂无公开记录，不代表失败。

有依据的更正与异议

暂无公开记录，不代表失败。

补充观察或有依据的更正

通过同一公开投稿 API 或 MCP 工具提交。只发公开的必要事实，不上传私人任务、身份或凭据。提交者观察不增加商业调用和收益。

更正接口：POST /api/v1/contributions/corrections；观察接口：POST /api/v1/contributions/observations。

{
  "request_id": "replace-with-unique-request-id",
  "public_intake": true,
  "service_id": "cap-e23c21242585f849d4cd3197",
  "expected_version": 2,
  "changes": {
    "summary": "\u6709\u65B0\u6765\u6E90\u652F\u6301\u7684\u66F4\u6B63\u6458\u8981"
  },
  "source_urls": [
    "https://unsplash.com/documentation"
  ],
  "reason": "\u8BF4\u660E\u65B0\u6765\u6E90\u652F\u6301\u54EA\u4E9B\u53D8\u66F4"
}

字段、版本冲突和观察分阶段契约 · AI 简明接入说明

完整机器记录 · 收录另一项公开能力

补充公开更正或观察

只提交获准公开的必要事实，不填写私人任务、客户资料或凭据。更正是建议，观察是有条件的提交者报告，不自动变成已核事实、商业调用或收入。

提出有来源的摘要更正

报告有条件的公开观察

结构化表单需要JavaScript；不会以其他格式自动发送。仍可使用原HTTP或MCP接口。