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.

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

400 / Bad Request

Request parameters are incorrect.

JSON

404 / Not Found

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

JSON

500 / Internal Server Error

Server processing failed, please try again later.

JSON