bing-wallpaper-api

A RESTful API for Bing wallpaper that redirects to the image directly

Based on the project: https://github.com/zenghongtu/bing-wallpaper

Built with Hono and deployed on Cloudflare Workers.

<img src="https://bing-wallpaper-api.jcolladosp.workers.dev/?width=800"/>

Usage

API

Endpoint: https://bing-wallpaper-api.jcolladosp.workers.dev

Parameters

resolution

The resolution of wallpaper image. Default is 1920x1080.

Option values:

• UHD
• 1920x1200
• 1920x1080
• 1366x768
• 1280x768
• 1024x768
• 800x600
• 800x480
• 768x1280
• 720x1280
• 640x480
• 480x800
• 400x240
• 320x240
• 240x320

format

The response format, can be json. If not set, it will be redirected to the wallpaper image directly.

index

The index of wallpaper, starts from 0. By default, 0 means to get today's image, 1 means to get the image of yesterday, and so on. Negative number is reverse sort, -1 will get the earliest wallpaper. Or you can specify it as random to choose a random index.

date

Get wallpaper by date, from 20190309 to today (format is YYYYMMDD).

width

The width of the wallpaper.

height

The height of the wallpaper.

quality

The quality of wallpaper, from 0 to 100.

Example

• Request

https://bing-wallpaper-api.jcolladosp.workers.dev/?resolution=UHD&index=random&width=1000&format=json

• Response

{
  "startdate": "20220105",
  "copyright": "Plate-billed mountain toucan in Bellavista Cloud Forest Reserve, Ecuador (© Tui De Roy/Minden Pictures)",
  "urlbase": "/th?id=OHR.MountainToucan_EN-US7120632569",
  "title": "A plate-billed mountain toucan",
  "url": "https://www.bing.com/th?id=OHR.MountainToucan_EN-US7120632569_UHD.jpg&w=1000"
}

CSS background image

You can also use this API to set CSS background image:

background-image: url(https://bing-wallpaper-api.jcolladosp.workers.dev/?index=random);
height: 100%;
background-position: center;
background-repeat: no-repeat;
background-size: cover;