The Wallpaper Abyss API is an HTTP/JSON based API that allows you to build applications that interact with Wallpaper Abyss.

Terms and Branding

  • The API is free to use up to 150,000 queries/month for commercial and non commercial use :)
  • Do not create multiple API keys for any reason.
  • You need to contact us before if you think you will go over 150,000/queries in a month so we can setup billing.
  • Our current pricing above 150,000 queries/month is $0.05 for every 1000 queries, price is negotiable based on the type of site/app you are building.
  • Please include A 'Powered By Wallpaper Abyss' link that links to somewhere on pages that use our api. Place it wherever you want.
  • If you want a solution without branding, please email us at
  • 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 :)
  • Please post a feature request on our forums if you need more functionality.
  • 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.


All calls must be made by using the link, 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"
The selection of the method is done via the parameter called method and is required on all calls.

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

Public Testing

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


Only those two 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 two URLs are examples of the two types of pages you'll be pulling.

How To Get An API Key

Applications for our API are closed.