The Wallpaper Abyss API

You will need an api key to access the api. This is a simple 3 step process

1. Register an Alpha Coders account
2. Login to your account (if it isn't done automatically)
3. Request An API Key

Terms and Branding

• The API is free to use up to 5,000 queries/day for commercial and non commercial use :)
• Please include A 'Powered By Wallpaper Abyss' link that links to http://wall.alphacoders.com somewhere on pages that use our api. Place it wherever you want.
• If you need more queries/day, or want to remove the branding, please contact us at admin@alphacoders.com
• It's our goal to provide the API at cost, so rates are very low. We want you to still be able to make a living too :)
• Our current pricing above 5,000 queries/day is $0.01 for every 1000 queries. Your # of queries is not yet tracked, so it's 100% free until we enable tracking
• Please email admin@alphacoders.com if you need more functionality to use the api. It's still being built, and we can prioritize your features!
• We ask that you not store results/content for more than a 24 hour time period. If you need to cache things longer, please let us know.

Our API currently only provides JSON output

API Endpoint: Get Wallpapers

http://wall.alphacoders.com/api1.0/get.php

Parameter	Default	Options/Info
auth	No Default.	Required
sort	newest	Options: newest rating
page	1	Increment by 1 for each page.
width	no default	Get wallpapers width specific width. Requires height parameter.
height	no default	Get wallpapers width specific height. Requires width parameter.

Examples:

http://wall.alphacoders.com/api1.0/get.php?auth=YOUR_API_KEY
http://wall.alphacoders.com/api1.0/get.php?auth=YOUR_API_KEY&page=3
http://wall.alphacoders.com/api1.0/get.php?auth=YOUR_API_KEY&sort=rating&page=3&width=1920&height=1080

Output Parameters

Wallpapers

Parameter	Type	Info
id	integer	Unique. Never null.
category	string	May be null
sub_category	string	May be null
file_type	string
thumb	array	Contains: url width
thumbbig	array	Contains: url width
url	string	Full url for original wallpaper
wallpaper_abyss_url	string	Link to Wallpaper Abyss big.php page for wallpaper
thumbbig	array	Contains: url width
user	string	Submitter name
user_url	string	Contains: url width
votes_up	int
votes_down	int
rating	float
featured	boolean
width	int
height	int

Data

Parameter	Type	Info
response_time	string	Time for our server to process, retrieve, and organize data

Using the API and examples (All in PHP)

Call the api page
$test = file_get_contents("http://wall.alphacoders.com/api1.0/get.php?auth=YOUR_API_KEY");

Decode the json output
$results = json_decode($test, true);

You can view the decoded json by using print_r, and wrap it with pre tags
print_r($results);

Going through the wallpaper results is easy!
foreach($results['wallpapers'] as $wallpaper) { }

and in that foreach loop to access part of a wallpaper:
$wallpaper['id']

Example urls the API accepts