Skip to content

fix: source.unsplash.com/random was deprecated in 2024 (now 503s)#717

Merged
Kikobeats merged 1 commit intomicrolinkhq:masterfrom
kiluazen:fix/unsplash-random-deprecated-2026-04-22-batch4
Apr 22, 2026
Merged

fix: source.unsplash.com/random was deprecated in 2024 (now 503s)#717
Kikobeats merged 1 commit intomicrolinkhq:masterfrom
kiluazen:fix/unsplash-random-deprecated-2026-04-22-batch4

Conversation

@kiluazen
Copy link
Copy Markdown
Contributor

README.md references the deprecated source.unsplash.com/random endpoint, which Unsplash retired in mid-2024 and which now returns HTTP 503 instead of an image.


Why this is needed

source.unsplash.com/random (and the related source.unsplash.com/featured) was deprecated by Unsplash in mid-2024 and the endpoint now returns HTTP 503 instead of an image. Browsers render a broken-image icon in place of the intended visual.

Verify in any shell:

curl -sI https://source.unsplash.com/random/800x600?office | head -1
# HTTP/1.1 503 Service Unavailable

What this PR changes

Updates the README's background-image examples list so the Image URLs option documents a working URL example for the browserless API.

Replacement details

Docs-only. The README enumerates accepted inputs for a background-image parameter (hex codes, CSS gradients, Image URLs). The Image URLs example currently references a 503 endpoint, which is confusing when users test the feature with the documented URL.

Background

I'm tracking the deprecated source.unsplash.com/random endpoint across public repos as part of tteg, a tiny CLI/HTTP API I built so projects can drop in real Unsplash photos without registering an Unsplash app or managing API keys. tteg isn't introduced as a dependency by this PR — the diff is dependency-free picsum.photos. But if you want topic-matched real photos as a follow-up, the no-key HTTP API is at https://tteg-api-53227342417.asia-south1.run.app/search?q=<query>&n=1 (CORS-on, no auth).

One extra artifact you may find handy: a public scanner at https://tteg.kushalsm.com/scan?url= that highlights this same broken-URL pattern in any landing page — useful for verifying the fix lands and for finding other places source.unsplash.com/random slipped in. Source: https://github.com/kiluazen/tteg-landing/blob/main/scan.html.

Research note covering ~16,500 files across ~885 unique repos that still hotlink the deprecated endpoint: https://github.com/kiluazen/tteg/blob/research-note-autark/RESEARCH.md.

@Kikobeats
Copy link
Copy Markdown
Member

Thanks a lot 🙏

@Kikobeats Kikobeats merged commit 2a1012d into microlinkhq:master Apr 22, 2026
Kikobeats added a commit to microlinkhq/www that referenced this pull request Apr 22, 2026
Kikobeats added a commit to microlinkhq/www that referenced this pull request Apr 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants