Wallpapers.com API

A free, read-only JSON API. Build apps, embeds, browser extensions, Discord bots — anything that needs wallpapers. Same data the website uses, served as JSON.

Authentication

API key is optional but recommended. Pass it via the X-API-Key request header, or as a ?key= query string for browser-only clients.

# With header (recommended):
curl -H "X-API-Key: wpc_your_key_here" \
     https://wallpapers.com/api/v1/daily-wallpaper

# With query string:
curl "https://wallpapers.com/api/v1/daily-wallpaper?key=wpc_your_key_here"

Endpoints

GET /api/v1/daily-wallpaper

Today's editor-picked wallpaper. Refreshes once every 24 hours UTC.

{
  "success": true,
  "id": 9279134,
  "title": "Anya Forger und Yor Forger",
  "alt": "Anya Forger und Yor Forger Wallpaper",
  "thumb": "https://wallpapers.com/images/thumbnail/anya-forger-...jpg",
  "high":  "https://wallpapers.com/images/high/anya-forger-...jpg",
  "webp":  "https://wallpapers.com/images/high/anya-forger-...webp",
  "url":   "https://wallpapers.com/wallpapers/anya-forger-....html",
  "credit_url":  "https://wallpapers.com/",
  "credit_text": "Wallpapers.com"
}

GET /api/v1/random

A random wallpaper. Optional filters:

Param	Default	Notes
type	wallpaper	wallpaper · background · picture · svg · png
q	—	Optional keyword slug, e.g. q=anime or q=4k

curl "https://wallpapers.com/api/v1/random?type=wallpaper&q=mountain"

GET /api/v1/keyword/<slug>

First N wallpapers for a keyword. ?limit=24 default, max 60.

curl "https://wallpapers.com/api/v1/keyword/cottagecore?limit=12"

Rate limits

Tier	Limit	Tracked
Anonymous (no key)	~30 / min / IP	Per-IP soft cap; not logged
Free key	60 / min	Per-(key, day, endpoint) counter visible at /account/api-keys/

Embeddable widget

Drop today's wallpaper on any page in two lines. No build step.

<div id="wpc-daily"></div>
<script src="https://wallpapers.com/static/widgets/wpc-of-the-day.js" async></script>

License

API responses are free to use. Wallpaper images themselves carry the license shown on each wallpaper page (most are free with attribution). Linking back to credit_url is required.

Versioning

This is API v1. New fields may be added without notice; we will not remove or rename existing fields without a major version bump (/api/v2/).