/wallpaper/api

Bing Wallpaper API

No key required. CORS enabled. Requests read upstream data in real time without KV, a database, or persistent cache.

中文EN

REQUEST BUILDER

URL builder

Choose an endpoint and its parameters to generate a ready-to-use URL.

Endpoint
Regional edition
Output size
Bing source dateOptional; enter YYYYMMDD or YYYY-MM-DD, or leave blank for today
Image response
Generated URL
Open
https://api.wallpaper.lkztools.top/api/wallpaper?mkt=en-US&resolution=UHD
GET

Today’s metadata

Return today’s metadata and URLs for every available size in real time. The response is JSON, not an image.

https://api.wallpaper.lkztools.top/api/today?mkt=en-US&resolution=UHDOpen

Query parameters

mkt
String
RequiredNo
Defaulten-US
Regional edition：zh-CN / en-US / ja-JP / en-GB
resolution
String
RequiredNo
DefaultUHD
Output size：UHD / 1920x1200 / 1920x1080 / 1366x768 / 1280x720 / 1024x768 / 800x600 / 800x480 / 768x1280 / 720x1280

Request example

curl "https://api.wallpaper.lkztools.top/api/today?mkt=en-US&resolution=UHD"

Response example

{
  "date": "20260809",
  "homepageDate": "20260810",
  "market": "en-US",
  "title": "Wallpaper title",
  "source": "bing",
  "url": "https://www.bing.com/th?id=...",
  "resolution": "UHD",
  "images": { "UHD": "https://www.bing.com/th?id=..." }
}
GET

Metadata by date

Query history by Bing startdate. homepageDate is the date shown on the selected market homepage.

https://api.wallpaper.lkztools.top/api/metadata?mkt=en-US&date=2026-06-17&resolution=UHDOpen

Query parameters

date
String
RequiredYes
Default—
Bing startdate in YYYYMMDD or YYYY-MM-DD format; omit it for today’s wallpaper
mkt
String
RequiredNo
Defaulten-US
Regional edition：zh-CN / en-US / ja-JP / en-GB
resolution
String
RequiredNo
Default1920x1080
Output size：UHD / 1920x1200 / 1920x1080 / 1366x768 / 1280x720 / 1024x768 / 800x600 / 800x480 / 768x1280 / 720x1280

Request example

curl "https://api.wallpaper.lkztools.top/api/metadata?mkt=en-US&date=2026-06-17&resolution=UHD"

Response example

{
  "date": "20260617",
  "homepageDate": "20260618",
  "market": "en-US",
  "title": "Wallpaper title",
  "copyright": "Wallpaper copyright",
  "source": "community-archive",
  "url": "https://www.bing.com/th?id=...",
  "resolution": "UHD",
  "images": { "UHD": "https://www.bing.com/th?id=..." }
}
GET

Wallpaper image

Use directly in a browser, img element, or wallpaper client. It redirects by default; proxy=1 returns the image body.

https://api.wallpaper.lkztools.top/api/wallpaper?mkt=en-US&resolution=UHDOpen

Query parameters

mkt
String
RequiredNo
Defaulten-US
Regional edition：zh-CN / en-US / ja-JP / en-GB
resolution
String
RequiredNo
Default1920x1080
Output size：UHD / 1920x1200 / 1920x1080 / 1366x768 / 1280x720 / 1024x768 / 800x600 / 800x480 / 768x1280 / 720x1280
proxy
Boolean
RequiredNo
Default0
Set to 1 to proxy the image body; the default is a 302 redirect
date
String
RequiredNo
Defaulttoday
Bing startdate in YYYYMMDD or YYYY-MM-DD format; omit it for today’s wallpaper

Request example

curl -L "https://api.wallpaper.lkztools.top/api/wallpaper?mkt=en-US&resolution=UHD&proxy=1" --output wallpaper.jpg

Response example

proxy=0
302 Found
Location: https://www.bing.com/th?id=...

proxy=1
200 OK
Content-Type: image/jpeg
GET

Wallpaper history

Aggregate metadata by month. China reaches about 2023-02; the United States reaches about 2021-02; Japan and the United Kingdom reach about 2022-04.

https://lkztools.top/api/wallpaper-history?mkt=en-US&month=2026-08Open

Query parameters

mkt
String
RequiredNo
Defaulten-US
Regional edition：zh-CN / en-US / ja-JP / en-GB
month
String
RequiredNo
Defaultlatest
Month in YYYY-MM format

Request example

curl "https://lkztools.top/api/wallpaper-history?mkt=en-US&month=2026-08"

Response example

{
  "month": "2026-08",
  "months": ["2026-08", "2026-07"],
  "items": [
    {
      "date": "2026-08-10",
      "sourceDate": "20260809",
      "title": "Wallpaper title",
      "copyright": "Wallpaper copyright",
      "source": "bing",
      "url": "https://api.wallpaper.lkztools.top/api/wallpaper?date=20260809&resolution=UHD"
    }
  ]
}
GET

Random wallpaper

Return random metadata from Bing’s eight most recent images.

https://api.wallpaper.lkztools.top/api/random?mkt=en-US&resolution=UHDOpen

Query parameters

mkt
String
RequiredNo
Defaulten-US
Regional edition：zh-CN / en-US / ja-JP / en-GB
resolution
String
RequiredNo
Default1920x1080
Output size：UHD / 1920x1200 / 1920x1080 / 1366x768 / 1280x720 / 1024x768 / 800x600 / 800x480 / 768x1280 / 720x1280

Request example

curl "https://api.wallpaper.lkztools.top/api/random?mkt=en-US&resolution=UHD"

Response example

{
  "date": "20260809",
  "homepageDate": "20260810",
  "market": "en-US",
  "title": "Wallpaper title",
  "source": "bing",
  "url": "https://www.bing.com/th?id=...",
  "resolution": "UHD"
}