本文档系统整理了微软 Bing 每日壁纸 (Bing Daily Wallpaper) 与 Windows 聚焦 (Windows Spotlight) 的核心 API 接口。涵盖接口地址、请求参数、全局区域配置、响应数据结构（Response Schema）深度解析、4K/UHD 高清原图拼接规则，以及 Spotlight V3 与 V4 版本的演进对比与技术参考。

H21. Bing Daily Wallpaper API#

微软必应搜索首页的每日壁纸归档接口，支持获取当天及往期历史壁纸（最多支持回溯最近 7~8 天）。

H31.1 接口端点与 cURL 请求 (Endpoint)#

curl -s "https://www.bing.com/HPImageArchive.aspx?format=js&idx=0&n=8"

H31.2 请求参数说明 (Request Parameters)#

H31.3 响应数据示例 (Response Example)#

{
  "images": [
    {
      "startdate": "20261030",
      "fullstartdate": "202610300700",
      "enddate": "20261031",
      "url": "/th?id=OHR.AutumnCranes_EN-US9795571462_1920x1080.jpg&rf=LaDigue_1920x1080.jpg&pid=hp",
      "urlbase": "/th?id=OHR.AutumnCranes_EN-US9795571462",
      "copyright": "Sandhill cranes, Bosque del Apache National Wildlife Refuge, New Mexico, USA (© Terry St.Louis/Getty Images)",
      "copyrightlink": "https://www.bing.com/search?q=Sandhill+Cranes&form=hpcapt&filters=HpDate%3a%2220261030_0700%22",
      "title": "Time to fly high",
      "quiz": "/search?q=Bing+homepage+quiz&filters=WQOskey:%22HPQuiz_20261030_AutumnCranes%22&FORM=HPQUIZ",
      "wp": true,
      "hsh": "5d23d8ca2501c88990d08bf23b12dd87",
      "drk": 1,
      "top": 1,
      "bot": 1,
      "hs": []
    }
  ],
  "tooltips": {
    "loading": "Loading...",
    "previous": "Previous image",
    "next": "Next image",
    "walle": "This image is not available to download as wallpaper.",
    "walls": "Download this image. Use of this image is restricted to wallpaper only."
  }
}

H31.4 响应字段深度解析 (Response Breakdown)#

响应顶层包含两个核心对象：images 数组与 tooltips 交互文案对象。

H4images[] 核心字段说明#

H4tooltips 字段说明#

包含必应首页轮播组件与交互提示的多语言本地化文案：

• loading：图片加载中文本（如 "Loading..."）。

• previous / next：切换上一张/下一张的按钮提示。

• walle：当 wp: false 时弹出的禁止下载提示文案。

• walls：当 wp: true 时的合规下载提示文案。

H4💡 获取 4K / UHD 超高清壁纸的技巧#

通过接口返回的 urlbase，可以自行组合高规格分辨率：

• 4K 超高清 (UHD)：https://www.bing.com + urlbase + _UHD.jpg

• 1080P 全高清：https://www.bing.com + urlbase + _1920x1080.jpg

• 手机竖屏尺寸：https://www.bing.com + urlbase + _1080x1920.jpg

例如，直接使用 cURL 下载 4K 原图：

curl -O "https://www.bing.com/th?id=OHR.AutumnCranes_EN-US9795571462_UHD.jpg"

H22. Windows Spotlight API (V4)#

Windows 11 及更新版本中“Windows 聚焦”（桌面与锁屏壁纸）所依赖的 Iris 服务分发端点。该版本直接分发原生 3840×2160 (4K) 的超高清壁纸资产以及丰富的景点人文背景故事介绍。

H32.1 接口端点与 cURL 请求 (Endpoint)#

curl -s "https://fd.api.iris.microsoft.com/v4/api/selection?placement=88000820&bcnt=4&country=US&locale=en-US&fmt=json"

H32.2 请求参数说明 (Request Parameters)#

H32.3 环球收割：全球常用区域与语言配置 (Global Configurations)#

Windows Spotlight 根据国家和语言区域分发差异化的壁纸内容与故事说明。常见 query 参数组合如下：

H32.4 响应数据示例 (Response Example)#

{
  "batchrsp": {
    "ver": "1.0",
    "items": [
      {
        "item": "{\"f\":\"raf\",\"v\":\"1.0\",\"rdr\":[{\"c\":\"CDMLite\",\"u\":\"DesktopSpotlightSurface\"}],\"ad\":{\"landscapeImage\":{\"asset\":\"https://res.public.onecdn.static.microsoft/creativeservice/8409803f-4105-4dea-4fbc-eac55cf5ba9a_desktop-b025_ds_hedinsfjorduriceland_shutterstock_1448551784_3840x2160.jpg\"},\"portraitImage\":{\"asset\":\"https://res.public.onecdn.static.microsoft/creativeservice/adf4bd2e-e236-f5af-e149-60f1e9de2a4f_desktop-b025_ds_hedinsfjorduriceland_shutterstock_1448551784_1080x1920.jpg\"},\"iconLabel\":\"Learn about this picture\",\"iconHoverText\":\"Héðinsfjörður, Iceland\\r\\n© Khairil Azhar Junos / Shutterstock\\r\\nRight-click to learn more\",\"title\":\"The fjord that got bored\",\"description\":\"It wasn't so long ago that the uninhabited valley of Héðinsfjörður was every bit as isolated as this shot makes it look...\",\"copyright\":\"© Khairil Azhar Junos / Shutterstock\",\"likeGlyph\":\"\",\"dislikeGlyph\":\"\",\"ctaText\":\"Learn more\",\"ctaUri\":\"microsoft-edge:https://www.bing.com/spotlight?spotlightid=DS_HedinsfjordurIceland...\",\"entityId\":\"128000000005952869\"},\"tracking\":{...},\"prm\":{...}}"
      }
    ]
  }
}

H32.5 响应数据深度解析 (Response Breakdown)#

H4⚠️ 关键解析注意事项：序列化 JSON 字符串 (Serialized String)#

外层响应结构定义如下：

• batchrsp.ver：协议版本，固定为 "1.0"。

• batchrsp.items：壁纸条目数组。

• 核心注意点：items[i].item 的值是经过转义的 JSON 字符串，并非内嵌的 JSON 对象！在代码处理时必须执行二次反序列化才能访问其内部字段：

// JavaScript 二次解析示例
const response = await fetch(url).then(r => r.json());
const wallpaperItem = JSON.parse(response.batchrsp.items[0].item);
console.log(wallpaperItem.ad.landscapeImage.asset); // 获取 4K 原图 URL

# Python 二次解析示例
import json, requests

data = requests.get(url).json()
wallpaper_item = json.loads(data["batchrsp"]["items"][0]["item"])
image_url = wallpaper_item["ad"]["landscapeImage"]["asset"]

H4内层反序列化对象字段说明#

反序列化后得到的对象包含三大模块：ad（壁纸核心内容）、tracking（上报接口）与 prm（投放追踪）：

H51. ad 对象（核心元数据与壁纸资源）#

H52. tracking 与 prm 对象（遥测与展示投放）#

• tracking.baseUri：客户端用户交互（喜欢、不喜欢、点击详情）的行为遥测打点模板 URL。

• prm._imp：曝光（Impression）上报链接，Windows 客户端在成功渲染壁纸后向 MSN/Iris 节点发送回执。

• prm._id / prm.CID / prm.BID：微软广告投放系统与聚焦内容的分发批次识别号。

H2Reference#