My Little Wallpaper offers a REST API for fetching wallpaper information with download links. The current API version is 1.0.
Please note that version 2.0 with documentation will be released after My Little Wallpaper 2.0 is out of beta.
There are currently two kinds of requests:
You can give certain parameters to the calls in the URL, for example https://www.mylittlewallpaper.com/c/all/api/v1/random.json?search=Fluttershy
searchoptional | Search input (tags). This parameter takes the same input you put to the search field on the website. For example: https://www.mylittlewallpaper.com/c/all/api/v1/random.json?search=author%3Aharwicks-art%2C+Rarity |
searchAnyoptional | Search input (tags), match any. This parameter takes the same input you put to the search field on the website. For example: |
searchExcludeoptional | Search input (tags), exclude from search. This parameter takes the same input you put to the search field on the website. For example: https://www.mylittlewallpaper.com/c/all/api/v1/random.json?search=author%3Aharwicks-art%2C+Rarity |
sizeoptional | Search input (size). Used to search for size equal or greater than. Only for desktop wallpapers. Accepted values are the following: • 1 - equeal or greater than 1920x1200 For example: https://www.mylittlewallpaper.com/c/all/api/v1/random.json?size=5 |
dateoptional | Search input (date added). Searches for wallpapers added on specific date (EET/EEST). Date format YYYY-MM-DD. For example: https://www.mylittlewallpaper.com/c/all/api/v1/random.json?date=2013-01-24 |
limitoptional | Limits the maximum number of results. Default: • random.json - 1 Max value: • random.json - 20 For example: https://www.mylittlewallpaper.com/c/all/api/v1/random.json?date=2013-01-24&limit=5 |
sortoptionalNot applicable with random.json | Result sorting. Accepts only one value, which is popularity. If left empty, results are sorted by date added, newest first. For example: https://www.mylittlewallpaper.com/c/all/api/v1/list.json?date=2013-01-24&sort=popularity |
offsetoptionalNot applicable with random.json | Result offset. Define offset where the result listing starts from. For example: https://www.mylittlewallpaper.com/c/all/api/v1/list.json?date=2013-01-24&offset=10 |
The API call returns the information formatted in JSON.
Example of list.json response (indentation and line wrapping added for readability):
{ "search_tags":[], "amount":1, "offset":0, "search_total":7156, "result":[ { "title":"slumber", "imageid":"510129af5dabe3.17214352", "downloadurl":"http:\/\/rublegun.deviantart.com\/art\/slumber-347275656", "dimensions": { "width":"2000", "height":"1000" }, "authors":[ "RubleGun" ], "clicks":"0" } ] }
search_tagsalways present | Tags used in search as an array. For example: "search_tags":["Fluttershy","Minimalistic","author:vexx3"] |
amountalways present | Amount of wallpapers in result. For example: "amount":7 |
offsetalways present in list.json response, never in random.json response | Offset of the listing. For example: "offset":80 |
search_totalalways present in list.json response, never in random.json response | Amount of total results of the search. For example: "search_total":132 |
resultalways present | The list of resulted wallpapers as an array, if any. An empty array if no wallpapers found. For example (indentation and line wrapping added for readability): "result":[
{
"title":"SO SPARKLY ! - Wallpaper",
"imageid":"50a33f5d6e3d51.20451078",
"downloadurl":"http:\/\/tzolkine.deviantart.com\/art\/SO-SPARKLY-Wallpaper-337170873",
"dimensions":{"width":"1920","height":"1080"},
"authors":["LazyPixel","Tzolkine"],
"clicks":"22"
},
{
"title":"Crystal Twilight - Wallpaper",
"imageid":"50a33f3936d055.87249674",
"downloadurl":"http:\/\/tzolkine.deviantart.com\/art\/Crystal-Twilight-Wallpaper-337170887",
"dimensions":{"width":"1920","height":"1080"},
"authors":["Pony-Vectors","Tzolkine"],
"clicks":"26"
}
] |
titlealways present | Wallpaper title. For example: "title":"Rainbow Dash wallpaper pack" |
imageidalways present | Wallpaper image identifier. This identifier can be used to get thumbnails from the site: "imageid":"504726d1982d86.18038044" |
downloadurlalways present | Wallpaper download URL. For example: "downloadurl":"http:\/\/softfang.deviantart.com\/art\/Minimalist-Wallpaper-43-Wonderbolts-287463909" |
dimensionspresent if applicable | Wallpaper dimensions. Not present if not applicable, like with Android live wallpapers and themes. For example: "dimensions":{"width":"1920","height":"1080"} |
authorsalways present | Wallpaper authors as an array. For example: "authors":["CaNoN-lb","impala99"] |
clicksalways present | Amount of wallpaper download link clicks. For example: "clicks":"35" |