Select category:

API v1

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:

Request parameters

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

The accepted parameters are the following:

search

optional

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
https://www.mylittlewallpaper.com/c/all/api/v1/list.json?search=platform%3AMobile%2C+%3DPinkie+Pie

searchAny

optional

Search input (tags), match any.

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?searchAny=aspect%3A16%3A10%2Caspect%3A16%3A9

searchExclude

optional

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

size

optional

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
2 - equeal or greater than 1920x1080
3 - equeal or greater than 1680x1050
4 - equeal or greater than 1366x768
5 - equeal or greater than 2560x1600
6 - equeal or greater than 2560x1440

For example:

https://www.mylittlewallpaper.com/c/all/api/v1/random.json?size=5
https://www.mylittlewallpaper.com/c/all/api/v1/list.json?search=author%3Aharwicks-art%2C+Rarity&size=1

date

optional

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
https://www.mylittlewallpaper.com/c/all/api/v1/list.json?search=%3DRarity&date=2013-01-24

limit

optional

Limits the maximum number of results.

Default:

random.json - 1
list.json - 10

Max value:

random.json - 20
list.json - 100

For example:

https://www.mylittlewallpaper.com/c/all/api/v1/random.json?date=2013-01-24&limit=5
https://www.mylittlewallpaper.com/c/all/api/v1/list.json?search=%3DPrincess+Luna&limit=20

sort

optional

Not 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

offset

optional

Not 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

Response

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" } ] }

The API returns following parameters:

search_tags

always present

Tags used in search as an array.

For example:

"search_tags":["Fluttershy","Minimalistic","author:vexx3"]

amount

always present

Amount of wallpapers in result.

For example:

"amount":7

offset

always present in list.json response, never in random.json response

Offset of the listing.

For example:

"offset":80

search_total

always present in list.json response, never in random.json response

Amount of total results of the search.

For example:

"search_total":132

result

always 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" } ]

The parameters of an individual wallpaper in result array:

title

always present

Wallpaper title.

For example:

"title":"Rainbow Dash wallpaper pack"

imageid

always present

Wallpaper image identifier.

This identifier can be used to get thumbnails from the site: https://www.mylittlewallpaper.com/image.php?image=[imageid], for example

"imageid":"504726d1982d86.18038044"

downloadurl

always present

Wallpaper download URL.

For example:

"downloadurl":"http:\/\/softfang.deviantart.com\/art\/Minimalist-Wallpaper-43-Wonderbolts-287463909"

dimensions

present if applicable

Wallpaper dimensions. Not present if not applicable, like with Android live wallpapers and themes.

For example:

"dimensions":{"width":"1920","height":"1080"}

authors

always present

Wallpaper authors as an array.

For example:

"authors":["CaNoN-lb","impala99"]

clicks

always present

Amount of wallpaper download link clicks.

For example:

"clicks":"35"