WallpaperAPIGuide
Continuously updated BingWallpaper API – powered by love. Please do not abuse.
API Calls: 3,257 times

BWPAPI 2.0 Beta

BWPAPI 2.0 Beta (BingWallpaper API) is an interface that is continuously being updated to provide users with a variety of new ways to get Bing wallpapers.

If you have any questions during use, you are welcome to discuss at BingWallpaper API node.

API Interface

All 2.0 API interfaces are located under the following prefix:

  • http://wallpaperbar.com/api/
  • The interface is continuously updated, maintained with dedication, please do not abuse it.

    API Rate Limit

    By default, each IP is limited to 600 API requests per hour. You can find Rate Limit information in the HTTP header of the API response:

  • X-Rate-Limit-Limit: 600
  • X-Rate-Limit-Reset: 1409479200
  • X-Rate-Limit-Remaining: 116
  • For API requests that can be cached by the browser, the Rate Limit quota is only consumed on the first request. Subsequent identical requests will directly retrieve results from the browser cache and will not consume the quota again.

    Below are the specific interface access details.

    Today's Bing Wallpaper

    Directly retrieves today's Bing wallpaper image, default parameters: &setmkt=visitor's region, &size=1920x1080

    1. /go
    Copy

    Optional parameters:

    • setmkt - You can specify the region:cn,us,gb,jp,de,fr,br,in,it,es,ca,au
    • size - Supported values:uhd,qhd,fhd,mbl,mrk,1920x1200,1920x1080,1366x768,1280x768,1024x768,800x600,800x480,768x1280,720x1280,640x480,480x800,400x240,320x240,240x320

    Complete example:

    1. Directly outputs today's Bing wallpaper from Japan with Bing logo watermark
    Copy

    Random Bing Wallpaper Image

    Can randomly retrieve a Bing wallpaper image, default parameters: &size=1920x1080

    1. /go?rand
    Copy

    Optional parameters:

    • setmkt - You can specify the region:cn,us,gb,jp,de,fr,br,in,it,es,ca,au
    • size - Supported values:uhd,qhd,fhd,mbl,mrk,1920x1200,1920x1080,1366x768,1280x768,1024x768,800x600,800x480,768x1280,720x1280,640x480,480x800,400x240,320x240,240x320

    Complete example:

    1. Randomly outputs a Bing wallpaper from the United States with a width-to-length ratio of 720x1280
    Copy

    Bing Wallpaper for a Specific Date

    Can retrieve the Bing wallpaper image for a specified date, default parameters: &setmkt=visitor's region, &size=1920x1080

    1. /go?date=*
    Copy

    Optional parameters:

    • date - Format: 20241201 (must be in yyyyMMdd format)
    • setmkt - You can specify the region:cn,us,gb,jp,de,fr,br,in,it,es,ca,au
    • size - Supported values:uhd,qhd,fhd,mbl,mrk,1920x1200,1920x1080,1366x768,1280x768,1024x768,800x600,800x480,768x1280,720x1280,640x480,480x800,400x240,320x240,240x320

    Complete example:

    1. Outputs a 4K Bing wallpaper from India on December 1, 2024
    Copy

    Extended Usage

    1. Customize Bing wallpaper image width and height

    1. &w=*
    2. &h=*
    3. &w=*&h=*
    Copy

    How to use:

    • Append the parameters to the end of the API interface URL
    • You can define width or height individually: &w=* or &h=*, or define both width and height: &w=*&h=*.

    Note:

    • Custom width and height (&w and &h) cannot be used at the same time with &size, please choose one method.

    2. Redirect to the direct link of Bing wallpaper image

    1. &redirect
    Copy

    How to use:

    • Append the parameters to the end of the API interface URL
    • Supports all API interface calls.

    DigitalOcean

    Desktop Wallpapers, HD Backgrounds

    The images are provided for wallpaper use only

    Privacy Policy    TOP

    © 2025 WallpaperBar.com

    GMT+8, 2025-5-2 08:45 , Processed in 0.089474 second(s), 16 queries .

    返回顶部