Image

Get Bing Daily Wallpaper

0calls
Free

This endpoint can get the latest or specified date Bing wallpaper. By default, it returns the image directly, or you can pass format=json to get metadata, or pass format=redirect to jump directly to the final image address.

Overview

  • When no parameters are passed, returns the current day's wallpaper image binary by default
  • You can pass date to query wallpaper for a specified date
  • You can pass resolution to select 4k or 1080
  • You can pass format to control return of image, JSON or 302 redirect
  • When passing format=json, returns 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. format defaults to image.

Query parameters

date
stringoptional

Wallpaper date, format is YYYY-MM-DD. Returns current day's wallpaper when not passed.

random
booleanoptional

Whether to randomly return a historical wallpaper on each request. Takes effect when passing true; cannot be used with date. Keeps default current day/specified date logic when not passed or passing false.

resolution
stringoptional

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

format
stringoptional

Response format. Can pass image, json or redirect. Defaults to image when not passed.

Response

200 / OK

Request successful. format=image returns image binary, format=json returns wallpaper metadata.

Format 1format=imageimage/jpeg
Format 2format=jsonapplication/json
JSON

302 /

When format=redirect, this endpoint will redirect to the final image address via the Location response header.

400 / Bad Request

Request parameters are incorrect.

JSON

404 / Not Found

No corresponding wallpaper found for the specified date.

JSON

500 / Internal Server Error

Server processing failed, please try again later.

JSON