Pass a key as auth on every call. Anyone using a key counts against your usage. All of your keys share one rate limit. You can have up to 5 keys for rotation. Log in to create a personal API key, or register first. Personal starts at 30/min, 500/day, 200 pages. Premium automatically raises that to 60/min, 2,000/day, 500 pages. Need more? We can work with enterprise-level limits. Email admin@alphacoders.com.

Alpha Coders API

HTTP JSON access to family-friendly desktop wallpapers, mobile wallpapers, avatars, and gifs. All calls are GET requests to https://api.alphacoders.com/4.0. Every response has success and query_time in seconds. Failures also have a short error. Authenticated calls include X-RateLimit-Limit and remaining headers. Over the cap returns HTTP 429 with Retry-After.

{
	"query_time": 0.0123,
	"success": true
}
{
	"error": "invalid_auth",
	"query_time": 0.0123,
	"success": false
}
{
	"error": "rate_limit",
	"query_time": 0.0123,
	"success": false,
	"window": "minute"
}

Rate limits

Limits are per Alpha Coders user, not per key. Rotating keys does not reset the counters. Every method counts, including query-count. Check remaining on that endpoint or in the response headers. Daily windows use UTC.

  • Personal: 30/min, 500/day, 200 pages
  • Premium automatically raises that to 60/min, 2,000/day, 500 pages
  • Need more? We can work with enterprise-level limits. Email admin@alphacoders.com

Try without a key

These five exact URLs work without auth, so you can see a live response first. Any other combination needs a key.

Content types

Filter with content_type. desktop maps to wallpaper. phone maps to mobile_wallpaper. Results are family-friendly only, skip duplicates, and skip items that are not ready to display.

Value What you get
all Desktop wallpaper, mobile wallpaper, avatar, and gif (default)
avatar Avatar
gif Gif
mobile_wallpaper Mobile wallpaper
wallpaper Desktop wallpaper

Parameters

Shared query arguments for list endpoints.

Parameter Required Value Description
auth yes, except the five test URLs string Your key
content_type no all | wallpaper | mobile_wallpaper | avatar | gif Default all
sort no newest | highest_rated contents and search default to newest. tag defaults to highest_rated
width no int (with height) Filter by width
height no int (with width) Filter by height
operator no max | equal | min How width and height are compared. Default equal
min_ratio no float (with max_ratio) Minimum width/height
max_ratio no float (with min_ratio) Maximum width/height
page no int Default 1. 30 items per page. Personal keys: 1–200. Premium and commercial keys: 1–500. Higher returns invalid_page

List endpoints return at most 30 items. There is no total or last_page. Request the next page until contents or tags is empty, or has fewer than 30 items. That is the end of the list. Random is not paged.

Content object

file_size is bytes. thumb is always a still image, including for gifs and live wallpapers, so it is safe in an <img> tag. thumb_350 and thumb_800 are the sized original-format thumbs; for gifs they are mp4.

{
	"alt_text": "string",
	"content_id": 1,
	"content_type": "wallpaper",
	"created": "2024-01-01 00:00:00",
	"favorite_count": 0,
	"file_size": 2500000,
	"file_type": "jpg",
	"height": 1080,
	"md5_checksum": "string",
	"name": "string",
	"src": "https://images8.alphacoders.com/...",
	"submitted_by": {"id": 1, "name": "string", "url": "https://alphacoders.com/..."},
	"tags": [{"id": 1, "name": "string", "slug": "string"}],
	"thumb": "https://images8.alphacoders.com/...",
	"thumb_1920": "https://images8.alphacoders.com/...",
	"thumb_350": "https://images8.alphacoders.com/...",
	"thumb_800": "https://images8.alphacoders.com/...",
	"upvote_count": 0,
	"url_page": "https://wall.alphacoders.com/...",
	"view_count": 0,
	"width": 1920
}

GET /4.0/contents/{id}

One item by contents.id.

https://api.alphacoders.com/4.0/contents/{id}

Try in browser
curl "https://api.alphacoders.com/4.0/contents/3302856?auth=YOUR_KEY"
$api_result = file_get_contents("https://api.alphacoders.com/4.0/contents/3302856?auth=YOUR_KEY");
$results = json_decode($api_result);

echo $results->content->name;
import json
import urllib.request

with urllib.request.urlopen("https://api.alphacoders.com/4.0/contents/3302856?auth=YOUR_KEY") as response:
	results = json.loads(response.read().decode())

print(results["content"]["name"])
{
	"content": {},
	"success": true
}

GET /4.0/contents

A page of content.

https://api.alphacoders.com/4.0/contents

Try in browser
curl "https://api.alphacoders.com/4.0/contents?auth=YOUR_KEY&content_type=wallpaper&sort=newest"
$api_result = file_get_contents("https://api.alphacoders.com/4.0/contents?auth=YOUR_KEY&content_type=wallpaper&sort=newest");
$results = json_decode($api_result);

foreach($results->contents as $content) {
	echo $content->content_id;
}
import json
import urllib.request

with urllib.request.urlopen("https://api.alphacoders.com/4.0/contents?auth=YOUR_KEY&content_type=wallpaper&sort=newest") as response:
	results = json.loads(response.read().decode())

for content in results["contents"]:
	print(content["content_id"])
{
	"contents": [],
	"page": 1,
	"success": true
}

GET /4.0/query-count

This key's lifetime query count, plus the current minute and day windows and max page depth for your user.

https://api.alphacoders.com/4.0/query-count

Try in browser
curl "https://api.alphacoders.com/4.0/query-count?auth=YOUR_KEY"
$api_result = file_get_contents("https://api.alphacoders.com/4.0/query-count?auth=YOUR_KEY");
$results = json_decode($api_result);

echo $results->count;
import json
import urllib.request

with urllib.request.urlopen("https://api.alphacoders.com/4.0/query-count?auth=YOUR_KEY") as response:
	results = json.loads(response.read().decode())

print(results["count"])
{
	"count": 0,
	"day_count": 0,
	"day_limit": 500,
	"day_remaining": 500,
	"max_page": 200,
	"minute_count": 0,
	"minute_limit": 30,
	"minute_remaining": 30,
	"success": true,
	"tier": "personal"
}

GET /4.0/random

Up to 30 random items.

https://api.alphacoders.com/4.0/random

Try in browser
curl "https://api.alphacoders.com/4.0/random?auth=YOUR_KEY&content_type=avatar"
$api_result = file_get_contents("https://api.alphacoders.com/4.0/random?auth=YOUR_KEY&content_type=avatar");
$results = json_decode($api_result);

foreach($results->contents as $content) {
	echo $content->content_id;
}
import json
import urllib.request

with urllib.request.urlopen("https://api.alphacoders.com/4.0/random?auth=YOUR_KEY&content_type=avatar") as response:
	results = json.loads(response.read().decode())

for content in results["contents"]:
	print(content["content_id"])
{
	"contents": [],
	"success": true
}

GET /4.0/tags/{id}

Content for one tag.

https://api.alphacoders.com/4.0/tags/{id}

Try in browser
curl "https://api.alphacoders.com/4.0/tags/246230?auth=YOUR_KEY&content_type=mobile_wallpaper"
$api_result = file_get_contents("https://api.alphacoders.com/4.0/tags/246230?auth=YOUR_KEY&content_type=mobile_wallpaper");
$results = json_decode($api_result);

foreach($results->contents as $content) {
	echo $content->content_id;
}
import json
import urllib.request

with urllib.request.urlopen("https://api.alphacoders.com/4.0/tags/246230?auth=YOUR_KEY&content_type=mobile_wallpaper") as response:
	results = json.loads(response.read().decode())

for content in results["contents"]:
	print(content["content_id"])
{
	"contents": [],
	"page": 1,
	"success": true,
	"tag": {}
}

GET /4.0/tags

Approved tags that have wallpaper, mobile wallpaper, avatar, or gif content. Optional term prefix-matches the tag name.

https://api.alphacoders.com/4.0/tags

Try in browser
curl "https://api.alphacoders.com/4.0/tags?auth=YOUR_KEY&term=naruto"
$api_result = file_get_contents("https://api.alphacoders.com/4.0/tags?auth=YOUR_KEY&term=naruto");
$results = json_decode($api_result);

foreach($results->tags as $tag) {
	echo $tag->id;
}
import json
import urllib.request

with urllib.request.urlopen("https://api.alphacoders.com/4.0/tags?auth=YOUR_KEY&term=naruto") as response:
	results = json.loads(response.read().decode())

for tag in results["tags"]:
	print(tag["id"])
{
	"page": 1,
	"success": true,
	"tags": []
}