Basics

All calls must be made by using the link https://api.alphacoders.com/3.0, arguments have to be passed as GET params. The response contains a JSON object, which will always contain a top-level boolean property success, in case of failure the error property will contain a short error code.

    {
        "success": true,
        "result": "the info you want"
    }

    {
        "success": false,
        "error": "en error occurred"
    }

Existing arguments and errors are defined in the documentation for the relevant method.

Public Testing

You can test our API without a key! The five URLs below will work without a key:

• https://api.alphacoders.com/3.0?type=desktop&method=highest_rated
• https://api.alphacoders.com/3.0?type=phone&method=highest_rated
• https://api.alphacoders.com/3.0?type=desktop&method=wallpaper_info&id=865098
• https://api.alphacoders.com/3.0?type=phone&method=wallpaper_info&id=692593
• https://api.alphacoders.com/3.0?method=sub_category_list&id=3&page=4

Only those five exact urls/set of parameters will work without the use of an API key. If you're wondering whether you can consume our api, the above five URLs are examples of the types of pages you'll be grabbing.

This method returns wallpapers sorted by newest

Arguments

Response

{
    "success":true,
    "wallpapers":[{"id":int,"width":int,"height":int,...},{"id":int,"width":int,"height":int,...},...]
}
                        

Errors

{
    "success":false,
    "error":string
}
                        

Example - PHP

                        
$api_result = file_get_contents("https://api.alphacoders.com/3.0?auth=YOUR_KEY&type=phone&method=newest");

$results = json_decode($api_result);

foreach($results->wallpapers as $wallpaper) {
    echo "Have wallpaper id: " . $wallpaper->id;
}

                    
                        

This method returns wallpapers sorted by their rating

Arguments

Response

{
    "success":true,
    "wallpapers":[{"id":int,"width":int,"height":int,...},{"id":int,"width":int,"height":int,...},...]
}
                        

Errors

{
    "success":false,
    "error":string
}
                        

Example - PHP

                        
$api_result = file_get_contents("https://api.alphacoders.com/3.0?auth=YOUR_KEY&type=desktop&method=highest_rated");

$results = json_decode($api_result);

foreach($results->wallpapers as $wallpaper) {
    echo "Have wallpaper id: " . $wallpaper->id;
}

                    
                        

This method returns wallpapers in a specific category

Arguments

Response

{
    "success":true,
    "wallpapers":[{"id":int,"width":int,"height":int,...},{"id":int,"width":int,"height":int,...},...]
}
                        

Errors

{
    "success":false,
    "error":string
}
                        

Example - PHP

                        
$api_result = file_get_contents("https://api.alphacoders.com/3.0?auth=YOUR_KEY&method=category&type=phone&id=3");

$results = json_decode($api_result);

foreach($results->wallpapers as $wallpaper) {
    echo "Have wallpaper id: " . $wallpaper->id;
}

                    
                        

This method returns a list of the categories on Alpha Coders

Arguments

Response

{
    "success":true,
    "categories":[{"id":int,"desktop_wallpaper_count":int,"phone_wallpaper_count":int,...},{"id":int,"desktop_wallpaper_count":int,"phone_wallpaper_count":int,...},...]
}
                        

Errors

{
    "success":false,
    "error":string
}
                        

Example - PHP

                        
$api_result = file_get_contents("https://api.alphacoders.com/3.0?auth=YOUR_KEY&method=category_list");

$results = json_decode($api_result);

foreach($results->categories as $category) {
    echo "Have category id: " . $category->id;
}

                    
                        

This method returns wallpapers in a specific sub category

Arguments

Response

{
    "success":true,
    "wallpapers":[{"id":int,"width":int,"height":int,...},{"id":int,"width":int,"height":int,...},...]
}
                        

Errors

{
    "success":false,
    "error":string
}
                        

Example - PHP

                        
$api_result = file_get_contents("https://api.alphacoders.com/3.0?auth=YOUR_KEY&method=sub_category&type=desktop&id=173812");

$results = json_decode($api_result);

foreach($results->wallpapers as $wallpaper) {
    echo "Have wallpaper id: " . $wallpaper->id;
}

                    
                        

This method returns a list of the sub categories in a given category on Alpha Coders

Arguments

Response

{
   "success":true,
   "sub_categories":[{"id":int,"name":string,"desktop_wallpaper_count":int,"phone_wallpaper_count":int,...},{"id":int,"name":string,"desktop_wallpaper_count":int,"phone_wallpaper_count":int,...},...]
}
                       

Errors

{
   "success":false,
   "error":string
}
                       

Example - PHP

                       
$api_result = file_get_contents("https://api.alphacoders.com/3.0?auth=YOUR_KEY&method=category_list");

$results = json_decode($api_result);

foreach($results->categories as $category) {
   echo "Have category id: " . $category->id;
}

                   
                       

This method returns wallpapers with a given tag

Arguments

Response

{
    "success":true,
    "wallpapers":[{"id":int,"width":int,"height":int,...},{"id":int,"width":int,"height":int,...},...]
}
                        

Errors

{
    "success":false,
    "error":string
}
                        

Example - PHP

                        
$api_result = file_get_contents("https://api.alphacoders.com/3.0?auth=YOUR_KEY&method=tag&type=phone&id=114");

$results = json_decode($api_result);

foreach($results->wallpapers as $wallpaper) {
    echo "Have wallpaper id: " . $wallpaper->id;
}

                    
                        

This method returns wallpapers matching a given search

Arguments

Response

{
    "success":true,
    "wallpapers":[{"id":int,"width":int,"height":int,...},{"id":int,"width":int,"height":int,...},...]
}
                        

Errors

{
    "success":false,
    "error":string
}
                        

Example - PHP

                        
$api_result = file_get_contents("https://api.alphacoders.com/3.0?auth=YOUR_KEY&method=search&term=star+wars&type=phone");

$results = json_decode($api_result);

foreach($results->wallpapers as $wallpaper) {
    echo "Have wallpaper id: " . $wallpaper->id;
}

                    
                        

This method returns random wallpapers

Arguments

Response

{
    "success":true,
    "wallpapers":[{"id":int,"width":int,"height":int,...},{"id":int,"width":int,"height":int,...},...]
}
                        

Errors

{
    "success":false,
    "error":string
}
                        

Example - PHP

                        
$api_result = file_get_contents("https://api.alphacoders.com/3.0?auth=YOUR_KEY&method=random&type=desktop");

$results = json_decode($api_result);

foreach($results->wallpapers as $wallpaper) {
    echo "Have wallpaper id: " . $wallpaper->id;
}

                    
                        

This method returns information about a Wallpaper

Arguments

Response

{
    "success":true,
    "wallpaper":{"id":int,"name":string,"featured":boolean,"width":int,"height":int,...},
    "tags":[{"id":int,"name":string},{"id":int,"name":string},...]
}
                        

This method returns your query count for the month

Arguments

Response

{
    "success":true,
    "count":10000
}
                        

Errors

{
    "success":false,
    "error":string
}
                        

Example - PHP

                        
$api_result = file_get_contents("https://api.alphacoders.com/3.0?auth=YOUR_KEY&method=query_count");

$results = json_decode($api_result);

echo $results->count