Alpha Coders Content:

Submit Things, Earn Points, Have Fun.

We Have Monthly Contests and Prizes

Submissions Do Good!

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
ParameterDefaultOptions/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.
category_id no default Only get wallpapers from a specific category. The IDs for categories are in the category pages on Wallpaper Abyss. E.g. http://wall.alphacoders.com/by_category.php?id=30&name=Technology+Wallpapers - Technology is category 30

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
http://wall.alphacoders.com/api1.0/get.php?auth=YOUR_API_KEY&sort=rating&page=3&width=1920&height=1080&category_id=3

Output Parameters

Wallpapers

ParameterTypeInfo
id integer Unique. Never null.
category string May be null
sub_category string May be null
file_type string
thumb arrayContains:
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 stringSubmitter name
user_url string Contains:
url
width
votes_up int
votes_down int
rating float
featured boolean
width int
height int

Data

ParameterTypeInfo
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