Image

Query Bing Wallpaper History

0calls
Free

This endpoint is used to query the Bing wallpaper history list, or precisely query a specific day by date. Returns JSON in reverse chronological order by default.

GET
uapis.cn
/api/v1/image/bing-daily/history
Query parameters
4
date
string

Wallpaper date, format is YYYY-MM-DD. When passed, will query precisely by date and ignore page and page_size.

resolution
string

Target resolution of the returned image. Can pass 4k or 1080, defaults to 4k when not passed.

page
integer
Pro

Pagination page number, must be a positive integer. Defaults to 1 when not passed. Only effective when not passing date.

page_size
integer
Pro

Number of items per page, must be a positive integer. Defaults to 30 when not passed, maximum is 100. Only effective when not passing date.

Overview

  • You can pass date to precisely query a specific day, returns only 1 record when matched
  • When not passing date, returns historical list with pagination in reverse chronological order
  • You can pass resolution to make image_url directly correspond to 4k or 1080
  • You can pass page and page_size to control pagination
  • Each record is a flat JSON object containing fields such as title, subtitle, description text, copyright information, Q&A information and image address

Parameter Description

resolution defaults to 4k. page defaults to 1, page_size defaults to 30, maximum is 100. When date is passed, page and page_size are not effective.

Query parameters

date
stringoptional

Wallpaper date, format is YYYY-MM-DD. When passed, will query precisely by date and ignore page and page_size.

resolution
stringoptional

Target resolution of the returned image. Can pass 4k or 1080, defaults to 4k when not passed.

page
integeroptional

Pagination page number, must be a positive integer. Defaults to 1 when not passed. Only effective when not passing date.

page_size
integeroptional

Number of items per page, must be a positive integer. Defaults to 30 when not passed, maximum is 100. Only effective when not passing date.

Response

200 / OK

Query successful, returns historical wallpaper list and pagination information.

JSON
{
  "resolution": "1080",
  "items": [
    {
      "date": "2026-04-07",
      "market": "zh-CN",
      "title": "Beaver, Germany",
      "subtitle": "International Beaver Day",
      "headline": "A branch, a little engineering",
      "description": "Every year on April 7th, International Beaver Day aims to pay tribute to this hard-working 'little engineer'. Beavers use branches and mud to build dams, reshaping freshwater ecological environments.",
      "copyright": "Seattle, Washington, USA (© Jim Patterson/Tandem Stills + Motion)",
      "copyright_link": "https://www.bing.com/search?q=%E8%A5%BF%E9%9B%85%E5%9B%BE&form=hpcapt&mkt=zh-cn",
      "quiz_id": "HPQuiz_20260409_SeattleSunrise",
      "trivia": {
        "question": "Which feature helps beavers easily gnaw hard wood?",
        "options": [
          {
            "bullet": "A",
            "text": "Strong molars",
            "url": "https://www.bing.com/search?q=%E6%A9%99%E8%89%B2%E9%97%A8%E9%BD%BF&FORM=HPQUIZ"
          }
        ]
      },
      "resolution": "4k",
      "image_url": "https://cn.bing.com/th?id=OHR.SeattleSunrise_ZH-CN2884575647_UHD.jpg",
      "image_url_4k": "https://cn.bing.com/th?id=OHR.SeattleSunrise_ZH-CN2884575647_UHD.jpg",
      "image_url_1080": "https://cn.bing.com/th?id=OHR.SeattleSunrise_ZH-CN2884575647_UHD.jpg&pid=hp&w=1920",
      "fetched_at": "2026-04-08T18:52:39.82+08:00",
      "updated_at": "2026-04-08T19:05:05.547+08:00"
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 1,
    "total": 1888
  }
}

400 / Bad Request

Request parameters are incorrect.

JSON
{
  "error": "page_size must be a positive integer"
}

404 / Not Found

When querying precisely by date, no corresponding wallpaper was found.

JSON
{
  "error": "No Bing wallpaper found for the corresponding date"
}

500 / Internal Server Error

Server processing failed, please try again later.

JSON
{
  "error": "Failed to get Bing wallpaper"
}