API Documentation

InterfaceLIFT Wallpapers.

Browse APIs using the menu above, or consult the Help Topics for answers to frequently asked questions.

For easy access to API responses within your code, check out the open-source libraries available at Unirest.io. Libraries are provided for integration with Python, PHP, Java, Ruby, Objective-C, Node.js, .NET, and Windows 8 code bases.

Unirest.io API Libraries ➚

GET

Read-only API endpoints.

Camera Body

GET /v1/camera/

Interchangeable-lens camera body.

Request Parameters:
Parameter Required Type Example Description
id Required number 1 Unique identifier for a camera body.

Example (A):

Get Data Sources (JSON)
Example Request:
/v1/camera/1/
Example Response:
{
  "id": 1,
  "brand": "Nikon",
  "model": "D700",
  "mount": "Nikon F-mount",
  "format": "FX",
  "date_introduced": "2008-07-01",
  "url_amazon": "http://www.amazon.com/gp/product/B001BTCSI6/ref=as_li_tf_tl?ie=UTF8&camp=211189&creative=373489&creativeASIN=B001BTCSI6&link_code=as3&tag=iflapi-20"
}

Camera Lens

GET /v1/lens/

Lens for an interchangeable-lens camera body.

Request Parameters:
Parameter Required Type Example Description
id Required number 1 Unique identifier for a camera lens.

Example (A):

Get Data Sources (JSON)
Example Request:
/v1/lens/621/
Example Response:
{
  "id": 621,
  "brand": "Carl Zeiss",
  "model": "Distagon T* 2,8/15 ZF.2",
  "mount": "Nikon F-mount",
  "max_format_size": "FX",
  "focal_length": 15,
  "focal_length_tele": null,
  "max_aperture": 2.8,
  "max_aperture_tele": null,
  "max_magnification": null,
  "min_focus": null,
  "filter_thread": 95,
  "reach": "Ultra-Wide Angle",
  "date_introduced": "2012-03-16",
  "url_amazon": null
}

Comment

GET /v1/comment/

User-submitted comment.

Request Parameters:
Parameter Required Type Example Description
id Required number 1 Unique identifier for a comment.

Example (A):

Get Data Sources (JSON)
Example Request:
/v1/comment/651585/
Example Response:
{
  "id": 651585,
  "wallpaper_id": 3055,
  "comment_text": "Outstanding picture. You time was spent well..thank you for sharing. Well done mate :D",
  "date": "2012-09-05 01:25:41",
  "date_text": "September 5th, 2012",
  "date_timestamp": 1346808341,
  "rating": 0,
  "user_id": 10175,
  "user_name": "golf007sd",
  "user_avatar_url": "http://interfacelift.com/account/img/10175.jpg",
  "user_avatar_size_in_bytes": 16772,
  "user_avatar_width": 360,
  "user_avatar_height": 297,
  "user_avatar_mime_type": "image/jpeg",
  "user_url_ifl_profile": "http://interfacelift.com/user/10175/golf007sd.html"
}

Comments

GET /v1/comments/

A time-ordered array of comments about a specific 'Wallpaper' and/or posted by a specific 'User'. Either a wallpaper_id must be specified, or a user_id, or both.

Request Parameters:
Parameter Required Type Example Description
limit Optional number 10 Maximum number of comments to return.
sort_order Optional string asc Sort the comment array in ascending ('asc') or descending time order ('desc').
start Optional number 0 The number of objects to skip over in the result set. Pair this parameter with 'limit' in order to implement paging of results.
user_id Optional number 10175 Unique identifier of a 'User' object.
wallpaper_id Optional number 3055 Unique identifier of a 'Wallpaper' object.

Example (A):

Get Data Sources (JSON)
Example Request:
/v1/comments/?limit=10&sort_order=asc&start=0&user_id=10175&wallpaper_id=3055
Example Response:
{
  "id": 651585,
  "wallpaper_id": 3055,
  "comment_text": "Outstanding picture. You time was spent well..thank you for sharing. Well done mate :D",
  "date": "2012-09-05 01:25:41",
  "date_text": "September 5th, 2012",
  "date_timestamp": 1346808341,
  "rating": 0,
  "user_id": 10175,
  "user_name": "golf007sd",
  "user_avatar_url": "http://interfacelift.com/account/img/10175.jpg",
  "user_avatar_size_in_bytes": 16772,
  "user_avatar_width": 360,
  "user_avatar_height": 297,
  "user_avatar_mime_type": "image/jpeg",
  "user_url_ifl_profile": "http://interfacelift.com/user/10175/golf007sd.html"
}

Favorites

GET /v1/favorites/

A list of 'Wallpaper' objects that have been marked as favorites by a specific 'User'. Optionally filtered by whether or not the 'Wallpaper' is available in a specified image resolution.

Request Parameters:
Parameter Required Type Example Description
user_id Required number 312 Unique identifier of a 'User' object.
limit Optional number 10 Maximum number of favorites to return.
resolution Optional string 1920x1080 If an image resolution is provided, the resulting list will only contain 'Wallpaper' objects available in that resolution.
sort_by Optional string date The attribute by which to sort 'Wallpaper' objects returned by the request. Default is 'date' if not explicitly specified. Allowed values include 'date', 'id', 'favorites', 'downloads', and 'comments'.
sort_order Optional string asc Order the 'Wallpaper' objects by the 'sort_by' attribute' in ascending or descending order. Default is 'desc' if not explicitly specified.
start Optional number 0 The number of objects to skip over in the result set. Pair this parameter with 'limit' in order to implement paging of results.
preview Optional string 480x270 If a value is provided for the 'preview' parameter, a custom preview image will be generated for each wallpaper in the list. Metadata will be included for the custom preview image's width, height, file size in bytes, and download URL.

Example (A):

Get Data Sources (JSON)
Example Request:
/v1/favorites/312/?limit=10&resolution=1920x1080&sort_by=date&sort_order=asc&start=0
Example Response:
{
   "id":3029,
   "user_id":109285,
   "user_name":"Youen California",
   "user_url_ifl":"http:\/\/interfacelift.com\/user\/109285\/Youen+California.html",
   "user_wallpaper_count":6,
   "title":"Lady Blue",
   "description":"This is Moraine Lake in Banff National Park. The colour of the water has a sweet and creamy look that reminds me of Havasu Falls in Arizona.\r\n\r\nEnjoy!",
   "date_featured":"2012-08-10 15:47:12",
   "date_featured_text":"August 10th,
    2012",
   "date_featured_timestamp":1344613632,
   "favorites_count":87,
   "comments_count":5,
   "url_ifl":"http:\/\/interfacelift.com\/wallpaper\/details\/3029\/Lady+Blue.html",
   "url_ifl_short":"http:\/\/ifl.cc\/a67",
   "latitude":51.327777862549,
   "longitude":-116.18055725098,
   "camera_id":6,
   "camera_brand":"Nikon",
   "camera_model":"D7000",
   "lens_id":643,
   "lens_brand":"Tamron",
   "lens_model":"SP AF 17-50mm F\/2.8 XR Di II LD Aspherical (IF)",
   "exposure_focal_length":32,
   "exposure_aperture":9,
   "exposure_shutter_speed":0.00625000009313,
   "exposure_iso":100,
   "resolutions_available_array":
      ["3840x2400",
       "3840x2160",
       "2880x1800",
       "2880x1620",
       "2560x1600",
       "2560x1440",
       "2560x1024",
       "2048x2048",
       "1920x1408",
       "1920x1200",
       "1920x1080",
       "1680x1050",
       "1600x1200",
       "1600x900",
       "1440x1280",
       "1440x900",
       "1400x1050",
       "1366x768",
       "1280x1024",
       "1280x960",
       "1280x800",
       "1280x720",
       "1080x960",
       "1024x1024",
       "1024x768",
       "1024x640",
       "1024x600",
       "960x854",
       "960x800",
       "960x544",
       "800x480",
       "768x1280",
       "720x1280",
       "640x1136",
       "640x960",
       "640x480",
       "600x1024",
       "480x800",
       "480x272",
       "360x480",
       "320x480",
       "320x400",
       "320x240"],
   "preview_width":240,
   "preview_height":150,
   "preview_size_in_bytes":28354,
   "preview_url":"http:\/\/api.ifl.cc\/v1\/previews\/03029_ladyblue.jpg",
   "preview@2x_width":480,
   "preview@2x_height":300,
   "preview@2x_size_in_bytes":60611,
   "preview@2x_url":"http:\/\/api.ifl.cc\/v1\/previews\/03029_ladyblue@2x.jpg"
}

Wallpaper Submission

GET /v1/submission/

Returns a 'Wallpaper Submission' object.

Request Parameters:
Parameter Required Type Example Description
id Required number 87407 Unique identifier of a 'Wallpaper Submission'.

Example (A):

Get Data Sources (JSON)
Example Request:
/v1/submission/87407/
Example Response:
{
  "id": 87407,
  "type": "Wallpaper",
  "title": "Peyto Lake",
  "description": "This is Peyto Lake at Banff National Park.\r\n\r\n24 July 2012",
  "equipment": null,
  "camera_id": 6,
  "camera_brand": "Nikon",
  "camera_model": "D7000",
  "lens_id": 643,
  "lens_brand": "Tamron",
  "lens_model": "SP AF 17-50mm F/2.8 XR Di II LD Aspherical (IF)",
  "location": "51°43'3\" N 116°30'27\" W",
  "date_submitted": "2012-08-22 20:30:28",
  "date_submitted_text": "August 22nd, 2012",
  "date_submitted_timestamp": 1345667428,
  "user_id": 109285,
  "user_name": "Youen California",
  "user_url_ifl_profile": "http://interfacelift.com/user/109285/Youen+California.html",
  "url_ifl": "http://interfacelift.com/wallpaper/loupe/87407/",
  "preview_small_width": 216,
  "preview_small_height": 135,
  "preview_small_size_in_bytes": 181413,
  "preview_small_url": "http://interfacelift.com/wallpaper/previews_loupe/small/109285_peytolake.png",
  "preview_large_width": 704,
  "preview_large_height": 440,
  "preview_large_size_in_bytes": 1637719,
  "preview_large_url": "http://interfacelift.com/wallpaper/previews_loupe/large/109285_peytolake.png",
  "preview_crop_width": 704,
  "preview_crop_height": 440,
  "preview_crop_size_in_bytes": 1460150,
  "preview_crop_url": "http://interfacelift.com/wallpaper/previews_loupe/crop/109285_peytolake.png"
}

Wallpaper Submission Download

GET /v1/submission/

Returns a download link for a 'Wallpaper Submission'.

Request Parameters:
Parameter Required Type Example Description
submission_id Required number 87479 Unique identifier for a 'Wallpaper Submission' object.

Example (A):

Get Data Sources (JSON)
Example Request:
/v1/submission/87407/
Example Response:
{
  "submission_id": 87479,
  "filename": "38598_13462248415794_wide.tif",
  "timestamp_current": 1346264436,
  "timestamp_expires": 1346350836,
  "download_size_in_bytes": 55329700,
  "resolution": "3840x2400",
  "width": 3840,
  "height": 2400,
  "mime_type": "image/tiff",
  "download_url": "http://api.ifl.cc/v1/submission/671155c7fb681dd9f50de2f0bcb96d13/1346350836/685497/38598_13462248415794_wide.tif"
}

Wallpaper Submissions

GET /v1/submissions/

Returns an array of 'Wallpaper Submission' objects. To get a download link, call the 'Wallpaper Submission Download' API using a 'submission_id' number.

Request Parameters:
Parameter Required Type Example Description
limit Optional number 10 Maximum number of 'Wallpaper Submission' objects to return.
start Optional number 0 The number of objects to skip over in the result set. Pair this parameter with 'limit' in order to implement paging of results.
user_id Optional number 109285 Unique identifier of a 'User' object.

Example (A):

Get Data Sources (JSON)
Example Request:
/v1/submissions/?limit=2&=0&user_id=109285
Example Response:
[
  {
    "camera_brand": "Nikon",
    "camera_id": 193,
    "camera_model": "D800E",
    "date_submitted": "2014-08-26 18:52:20",
    "date_submitted_text": "August 26th, 2014",
    "date_submitted_timestamp": 1409079140,
    "description": "I dedicace this picture to my girlfriend\r\n\r\nand it's an another picture of marron bells, without blur ;) Enjoy !",
    "equipment": null,
    "id": 91509,
    "lens_brand": "Samyang",
    "lens_id": 682,
    "lens_model": "14mm F2.8 IF ED MC Aspherical",
    "location": "39°5'54\" N 106°56'38\" W",
    "preview_crop_height": 440,
    "preview_crop_size_in_bytes": 844588,
    "preview_crop_url": "http://interfacelift.com/wallpaper/previews_loupe/crop/109285_14090791359115.png",
    "preview_crop_width": 704,
    "preview_large_height": 440,
    "preview_large_size_in_bytes": 2549552,
    "preview_large_url": "http://interfacelift.com/wallpaper/previews_loupe/large/109285_14090791359115.png",
    "preview_large_width": 704,
    "preview_small_height": 135,
    "preview_small_size_in_bytes": 291465,
    "preview_small_url": "http://interfacelift.com/wallpaper/previews_loupe/small/109285_14090791359115.png",
    "preview_small_width": 216,
    "title": "Freebird",
    "type": "Wallpaper",
    "url_ifl": "http://interfacelift.com/wallpaper/loupe/91509/",
    "user_id": 109285,
    "user_name": "Youen California",
    "user_url_ifl_profile": "http://interfacelift.com/user/109285/Youen+California.html"
  },
  {
    "camera_brand": "Nikon",
    "camera_id": 6,
    "camera_model": "D7000",
    "date_submitted": "2014-08-26 07:35:45",
    "date_submitted_text": "August 26th, 2014",
    "date_submitted_timestamp": 1409038545,
    "description": "It's my favourite lake, in canada. It's Morraine Lake, and i want to share my work with you. Taken at July 2012.\r\n\r\nI dedicate this picture To my girlfriend.",
    "equipment": null,
    "id": 91503,
    "lens_brand": "Tamron",
    "lens_id": 643,
    "lens_model": "SP AF 17-50mm F/2.8 XR Di II LD Aspherical (IF)",
    "location": "51°19'40\" N 116°10'50\" W",
    "preview_crop_height": 440,
    "preview_crop_size_in_bytes": 671031,
    "preview_crop_url": "http://interfacelift.com/wallpaper/previews_loupe/crop/109285_1409038541874.png",
    "preview_crop_width": 704,
    "preview_large_height": 440,
    "preview_large_size_in_bytes": 2076436,
    "preview_large_url": "http://interfacelift.com/wallpaper/previews_loupe/large/109285_1409038541874.png",
    "preview_large_width": 704,
    "preview_small_height": 135,
    "preview_small_size_in_bytes": 241929,
    "preview_small_url": "http://interfacelift.com/wallpaper/previews_loupe/small/109285_1409038541874.png",
    "preview_small_width": 216,
    "title": "Canadian Dream",
    "type": "Wallpaper",
    "url_ifl": "http://interfacelift.com/wallpaper/loupe/91503/",
    "user_id": 109285,
    "user_name": "Youen California",
    "user_url_ifl_profile": "http://interfacelift.com/user/109285/Youen+California.html"
  }
]

Resolution

GET /v1/resolution/

Find the best match between an arbitrary display resolution and a supported InterfaceLIFT resolution.

Request Parameters:
Parameter Required Type Example Description
resolution Required string 1919x1079 Display resolution.

Example (A):

Resolution (JSON)
Example Request:
/v1/resolution/1919x1079/
Example Response:
[
    {
        "id": 19,
        "width": 1920,
        "height": 1080,
        "nearness": 1
    }
]

Resolutions

GET /v1/resolutions/

Supported wallpaper resolutions including a count of the number of available images per image size.

Request Parameters:

Example (A):

Resolutions (JSON)
Example Request:
/v1/resolutions/?
Example Response:
[
    {
        "id": 32,
        "width": 7680,
        "height": 1600,
        "label": "Triple Monitors",
        "total_wallpapers": 7
    },
    {
        "id": 86,
        "width": 7680,
        "height": 1440,
        "label": "Triple Monitors",
        "total_wallpapers": 2
    },
    {
        "id": 27,
        "width": 5760,
        "height": 1200,
        "label": "Triple Monitors",
        "total_wallpapers": 16
    },
    {
        "id": 48,
        "width": 5760,
        "height": 1080,
        "label": "Triple Monitors",
        "total_wallpapers": 11
    },
    {
        "id": 84,
        "width": 5120,
        "height": 3200,
        "label": "Widescreen 16:10",
        "total_wallpapers": 134
    },
    {
        "id": 85,
        "width": 5120,
        "height": 2880,
        "label": "Widescreen 16:9",
        "total_wallpapers": 136
    },
    {
        "id": 28,
        "width": 5120,
        "height": 1600,
        "label": "Dual Monitors",
        "total_wallpapers": 73
    },
    {
        "id": 43,
        "width": 5120,
        "height": 1440,
        "label": "Dual Monitors",
        "total_wallpapers": 63
    },
    {
        "id": 26,
        "width": 5040,
        "height": 1050,
        "label": "Triple Monitors",
        "total_wallpapers": 70
    },
    {
        "id": 23,
        "width": 4800,
        "height": 1200,
        "label": "Triple Monitors",
        "total_wallpapers": 82
    },
    {
        "id": 62,
        "width": 4800,
        "height": 900,
        "label": "Triple Monitors",
        "total_wallpapers": 67
    },
    {
        "id": 25,
        "width": 4320,
        "height": 900,
        "label": "Triple Monitors",
        "total_wallpapers": 88
    },
    {
        "id": 60,
        "width": 4200,
        "height": 1050,
        "label": "Triple Monitors",
        "total_wallpapers": 80
    },
    {
        "id": 83,
        "width": 4096,
        "height": 2160,
        "label": "Widescreen",
        "total_wallpapers": 249
    },
    {
        "id": 21,
        "width": 4096,
        "height": 1024,
        "label": "Triple Monitors",
        "total_wallpapers": 144
    },
    {
        "id": 73,
        "width": 3840,
        "height": 2400,
        "label": "Widescreen 16:10",
        "total_wallpapers": 784
    },
    {
        "id": 76,
        "width": 3840,
        "height": 2160,
        "label": "Widescreen 16:9",
        "total_wallpapers": 781
    },
    {
        "id": 33,
        "width": 3840,
        "height": 1200,
        "label": "Dual Monitors",
        "total_wallpapers": 349
    },
    {
        "id": 42,
        "width": 3840,
        "height": 1080,
        "label": "Dual Monitors",
        "total_wallpapers": 299
    },
    {
        "id": 24,
        "width": 3840,
        "height": 1024,
        "label": "Triple Monitors",
        "total_wallpapers": 321
    },
    {
        "id": 22,
        "width": 3840,
        "height": 960,
        "label": "Triple Monitors",
        "total_wallpapers": 321
    },
    {
        "id": 54,
        "width": 3840,
        "height": 720,
        "label": "Triple Monitors",
        "total_wallpapers": 268
    },
    {
        "id": 90,
        "width": 3440,
        "height": 1440,
        "label": "Widescreen 21:9",
        "total_wallpapers": 143
    },
    {
        "id": 82,
        "width": 3360,
        "height": 2100,
        "label": "Widescreen 16:10",
        "total_wallpapers": 784
    },
    {
        "id": 15,
        "width": 3360,
        "height": 1050,
        "label": "Dual Monitors",
        "total_wallpapers": 497
    },
    {
        "id": 88,
        "width": 3200,
        "height": 1800,
        "label": "Widescreen 16:9",
        "total_wallpapers": 240
    },
    {
        "id": 16,
        "width": 3200,
        "height": 1200,
        "label": "Dual Monitors",
        "total_wallpapers": 517
    },
    {
        "id": 51,
        "width": 3072,
        "height": 768,
        "label": "Triple Monitors",
        "total_wallpapers": 400
    },
    {
        "id": 68,
        "width": 2880,
        "height": 1800,
        "label": "Widescreen 16:10",
        "total_wallpapers": 975
    },
    {
        "id": 74,
        "width": 2880,
        "height": 1620,
        "label": "Widescreen 16:9",
        "total_wallpapers": 789
    },
    {
        "id": 17,
        "width": 2880,
        "height": 900,
        "label": "Dual Monitors",
        "total_wallpapers": 519
    },
    {
        "id": 8,
        "width": 2560,
        "height": 1600,
        "label": "Widescreen 16:10",
        "total_wallpapers": 2608
    },
    {
        "id": 35,
        "width": 2560,
        "height": 1440,
        "label": "Widescreen 16:9",
        "total_wallpapers": 1945
    },
    {
        "id": 79,
        "width": 2560,
        "height": 1080,
        "label": "Widescreen 21:9",
        "total_wallpapers": 479
    },
    {
        "id": 18,
        "width": 2560,
        "height": 1024,
        "label": "Dual Monitors",
        "total_wallpapers": 1825
    },
    {
        "id": 95,
        "width": 2208,
        "height": 2208,
        "label": "Apple iPhone",
        "total_wallpapers": 350
    },
    {
        "id": 80,
        "width": 2160,
        "height": 1920,
        "label": "Google Android",
        "total_wallpapers": 496
    },
    {
        "id": 65,
        "width": 2048,
        "height": 2048,
        "label": "Apple iPad",
        "total_wallpapers": 1118
    },
    {
        "id": 69,
        "width": 1920,
        "height": 1408,
        "label": "Google Android",
        "total_wallpapers": 963
    },
    {
        "id": 6,
        "width": 1920,
        "height": 1200,
        "label": "Widescreen 16:10",
        "total_wallpapers": 3346
    },
    {
        "id": 19,
        "width": 1920,
        "height": 1080,
        "label": "Widescreen 16:9",
        "total_wallpapers": 2451
    },
    {
        "id": 7,
        "width": 1680,
        "height": 1050,
        "label": "Widescreen 16:10",
        "total_wallpapers": 3457
    },
    {
        "id": 87,
        "width": 1600,
        "height": 2560,
        "label": "Portrait Orientation",
        "total_wallpapers": 225
    },
    {
        "id": 1,
        "width": 1600,
        "height": 1200,
        "label": "Fullscreen 4:3",
        "total_wallpapers": 3491
    },
    {
        "id": 37,
        "width": 1600,
        "height": 900,
        "label": "Widescreen 16:9",
        "total_wallpapers": 1578
    },
    {
        "id": 94,
        "width": 1440,
        "height": 1440,
        "label": "Blackberry",
        "total_wallpapers": 54
    },
    {
        "id": 71,
        "width": 1440,
        "height": 1280,
        "label": "Google Android",
        "total_wallpapers": 854
    },
    {
        "id": 4,
        "width": 1440,
        "height": 900,
        "label": "Widescreen 16:10",
        "total_wallpapers": 3500
    },
    {
        "id": 30,
        "width": 1400,
        "height": 1050,
        "label": "Fullscreen 4:3",
        "total_wallpapers": 2329
    },
    {
        "id": 44,
        "width": 1366,
        "height": 768,
        "label": "Netbook",
        "total_wallpapers": 1465
    },
    {
        "id": 12,
        "width": 1280,
        "height": 1024,
        "label": "Fullscreen 5:4",
        "total_wallpapers": 2948
    },
    {
        "id": 5,
        "width": 1280,
        "height": 960,
        "label": "Fullscreen 4:3",
        "total_wallpapers": 3523
    },
    {
        "id": 13,
        "width": 1280,
        "height": 800,
        "label": "Widescreen 16:10",
        "total_wallpapers": 3504
    },
    {
        "id": 20,
        "width": 1280,
        "height": 720,
        "label": "Widescreen 16:9",
        "total_wallpapers": 2468
    },
    {
        "id": 92,
        "width": 1242,
        "height": 2208,
        "label": "Apple iPhone",
        "total_wallpapers": 349
    },
    {
        "id": 81,
        "width": 1200,
        "height": 1920,
        "label": "Portrait Orientation",
        "total_wallpapers": 472
    },
    {
        "id": 93,
        "width": 1080,
        "height": 1920,
        "label": "Portrait Orientation",
        "total_wallpapers": 349
    },
    {
        "id": 47,
        "width": 1080,
        "height": 960,
        "label": "Google Android",
        "total_wallpapers": 1198
    },
    {
        "id": 36,
        "width": 1024,
        "height": 1024,
        "label": "Apple iPad",
        "total_wallpapers": 1721
    },
    {
        "id": 3,
        "width": 1024,
        "height": 768,
        "label": "Fullscreen 4:3",
        "total_wallpapers": 3412
    },
    {
        "id": 75,
        "width": 1024,
        "height": 640,
        "label": "Widescreen 16:10",
        "total_wallpapers": 811
    },
    {
        "id": 34,
        "width": 1024,
        "height": 600,
        "label": "Netbook",
        "total_wallpapers": 2042
    },
    {
        "id": 89,
        "width": 960,
        "height": 1704,
        "label": "Other",
        "total_wallpapers": 185
    },
    {
        "id": 41,
        "width": 960,
        "height": 854,
        "label": "Google Android",
        "total_wallpapers": 1442
    },
    {
        "id": 40,
        "width": 960,
        "height": 800,
        "label": "Google Android",
        "total_wallpapers": 1448
    },
    {
        "id": 70,
        "width": 960,
        "height": 544,
        "label": "Other",
        "total_wallpapers": 932
    },
    {
        "id": 31,
        "width": 800,
        "height": 480,
        "label": "Netbook",
        "total_wallpapers": 2238
    },
    {
        "id": 77,
        "width": 768,
        "height": 1280,
        "label": "Windows Phone 7\/8",
        "total_wallpapers": 772
    },
    {
        "id": 91,
        "width": 750,
        "height": 1334,
        "label": "Apple iPhone",
        "total_wallpapers": 349
    },
    {
        "id": 78,
        "width": 720,
        "height": 1280,
        "label": "Windows Phone 7\/8",
        "total_wallpapers": 771
    },
    {
        "id": 72,
        "width": 640,
        "height": 1136,
        "label": "Apple iPhone",
        "total_wallpapers": 811
    },
    {
        "id": 38,
        "width": 640,
        "height": 960,
        "label": "Apple iPhone",
        "total_wallpapers": 1671
    },
    {
        "id": 39,
        "width": 640,
        "height": 480,
        "label": "Google Android",
        "total_wallpapers": 1449
    },
    {
        "id": 67,
        "width": 600,
        "height": 1024,
        "label": "Google Android",
        "total_wallpapers": 1057
    },
    {
        "id": 46,
        "width": 480,
        "height": 800,
        "label": "Windows Phone 7\/8",
        "total_wallpapers": 1355
    },
    {
        "id": 9,
        "width": 480,
        "height": 272,
        "label": "Other",
        "total_wallpapers": 3017
    },
    {
        "id": 49,
        "width": 360,
        "height": 480,
        "label": "Blackberry",
        "total_wallpapers": 1202
    },
    {
        "id": 29,
        "width": 320,
        "height": 480,
        "label": "Apple iPhone",
        "total_wallpapers": 2346
    },
    {
        "id": 66,
        "width": 320,
        "height": 400,
        "label": "Other",
        "total_wallpapers": 1139
    },
    {
        "id": 14,
        "width": 320,
        "height": 240,
        "label": "Blackberry",
        "total_wallpapers": 3477
    }
]

Tag

GET /v1/tag/

Tag, category, or keyword. Call it what you like.

Request Parameters:
Parameter Required Type Example Description
id Required number 538 Unique identifier for a 'Tag' object.

Example (A):

Get Data Sources (JSON)
Example Request:
/v1/tag/538/
Example Response:
{
  "id": 538,
  "tag_name": "lakeshore drive",
  "type": "Location",
  "related_searches": [
    "chicago"
  ]
}

Tags

GET /v1/tags/

Tag, category, or keyword. Call it what you like.

Request Parameters:
Parameter Required Type Example Description
search Required string Lake Search keyword text.
type Required string Location Type of tag. One of: 'Color, 'Scene', 'Location', 'Event', 'Subject', 'Equipment', or 'Medium'.

Example (A):

Get Data Sources (JSON)
Example Request:
/v1/tags/?search=Lake&type=Location
Example Response:
{
  "id": 538,
  "tag_name": "lakeshore drive",
  "type": "Location",
  "related_searches": [
    "chicago"
  ]
}

User

GET /v1/user/

Returns a 'User' object.

Request Parameters:
Parameter Required Type Example Description
id Required number 312 Unique identifier for a 'User' object.

Example (A):

Get Data Sources (JSON)
Example Request:
/v1/user/312/
Example Response:
{
  "id": 312,
  "username": "chickenwire",
  "twitter": null,
  "avatar_url": "http://interfacelift.com/account/img/312.jpg",
  "avatar_size_in_bytes": 5882,
  "avatar_width": 64,
  "avatar_height": 64,
  "avatar_mime_type": "image/jpeg",
  "bio_html": "<p>I am an amateur photographer living in downtown Washington D.C.</p>",
  "location": null,
  "occupation": null,
  "gender": "Male",
  "birthdate": "1978-10-27",
  "url_external": null,
  "url_ifl_profile": "http://interfacelift.com/user/312/chickenwire.html",
  "url_ifl_wallpapers": "http://interfacelift.com/wallpaper/artist/312/chickenwire/",
  "date_joined": "2000-07-20 00:00:00",
  "wallpaper_id_array": [
    2971,
    2913,
    2748,
    2720,
    2684,
    2678,
    2595,
    2588,
    2584,
    2459,
    2426,
    2417,
    2392,
    2378,
    2367,
    2320,
    2243,
    1833,
    1476,
    921,
    856,
    675,
    624,
    375,
    330,
    221,
    218,
    217,
    214,
    213,
    170,
    164,
    97,
    96,
    95,
    93,
    92,
    73,
    69,
    67,
    28,
    10
  ],
  "camera_id_array": [
    1
  ],
  "lens_id_array": [
    239
  ]
}

Wallpaper

GET /v1/wallpaper/

Returns a 'Wallpaper' object.

Request Parameters:
Parameter Required Type Example Description
id Required number 3029 Unique identifier for a 'Wallpaper' object.

Example (A):

Get Data Sources (JSON)
Example Request:
/v1/wallpaper/3029/
Example Response:
{
   "id":3029,
   "user_id":109285,
   "user_name":"Youen California",
   "user_url_ifl":"http:\/\/interfacelift.com\/user\/109285\/Youen+California.html",
   "user_wallpaper_count":6,
   "title":"Lady Blue",
   "description":"This is Moraine Lake in Banff National Park. The colour of the water has a sweet and creamy look that reminds me of Havasu Falls in Arizona.\r\n\r\nEnjoy!",
   "date_featured":"2012-08-10 15:47:12",
   "date_featured_text":"August 10th,
    2012",
   "date_featured_timestamp":1344613632,
   "favorites_count":87,
   "comments_count":5,
   "url_ifl":"http:\/\/interfacelift.com\/wallpaper\/details\/3029\/Lady+Blue.html",
   "url_ifl_short":"http:\/\/ifl.cc\/a67",
   "latitude":51.327777862549,
   "longitude":-116.18055725098,
   "camera_id":6,
   "camera_brand":"Nikon",
   "camera_model":"D7000",
   "lens_id":643,
   "lens_brand":"Tamron",
   "lens_model":"SP AF 17-50mm F\/2.8 XR Di II LD Aspherical (IF)",
   "exposure_focal_length":32,
   "exposure_aperture":9,
   "exposure_shutter_speed":0.00625000009313,
   "exposure_iso":100,
   "resolutions_available_array":
      ["3840x2400",
       "3840x2160",
       "2880x1800",
       "2880x1620",
       "2560x1600",
       "2560x1440",
       "2560x1024",
       "2048x2048",
       "1920x1408",
       "1920x1200",
       "1920x1080",
       "1680x1050",
       "1600x1200",
       "1600x900",
       "1440x1280",
       "1440x900",
       "1400x1050",
       "1366x768",
       "1280x1024",
       "1280x960",
       "1280x800",
       "1280x720",
       "1080x960",
       "1024x1024",
       "1024x768",
       "1024x640",
       "1024x600",
       "960x854",
       "960x800",
       "960x544",
       "800x480",
       "768x1280",
       "720x1280",
       "640x1136",
       "640x960",
       "640x480",
       "600x1024",
       "480x800",
       "480x272",
       "360x480",
       "320x480",
       "320x400",
       "320x240"],
   "preview_width":240,
   "preview_height":150,
   "preview_size_in_bytes":28354,
   "preview_url":"http:\/\/api.ifl.cc\/v1\/previews\/03029_ladyblue.jpg",
   "preview@2x_width":480,
   "preview@2x_height":300,
   "preview@2x_size_in_bytes":60611,
   "preview@2x_url":"http:\/\/api.ifl.cc\/v1\/previews\/03029_ladyblue@2x.jpg"
}

Wallpaper Download

GET /v1/wallpaper_download/

Returns an object containing the download URL for the specified 'wallpaper_id' and image 'resolution'.

Request Parameters:
Parameter Required Type Example Description
resolution Required string 1280x800 Image resolution to download.
id Required number 3001 Unique identifier for a 'Wallpaper' object.

Example (A):

Get Data Sources (JSON)
Example Request:
/v1/wallpaper_download/3001/1280x800/
Example Response:
{
  "wallpaper_id": 3001,
  "filename": "03001_amazingamalficoast_1280x800.jpg",
  "resolution": "1280x800",
  "width": 1280,
  "height": 800,
  "timestamp_current": 1345748137,
  "timestamp_expires": 1345834537,
  "download_size_in_bytes": 1403139,
  "download_url": "http://api.ifl.cc/v1/05ebaff0588e3194f4d562567b78be0e/1345834537/343540/03001_amazingamalficoast_1280x800.jpg"
}

Wallpaper

GET /v1/wallpaper/

Returns a 'Wallpaper' object.

Request Parameters:
Parameter Required Type Example Description
id Required number 3029 Unique identifier for a 'Wallpaper' object.

Example (A):

Get Data Sources (JSON)
Example Request:
/v1/wallpaper/3029/
Example Response:
{
   "id":3029,
   "user_id":109285,
   "user_name":"Youen California",
   "user_url_ifl":"http:\/\/interfacelift.com\/user\/109285\/Youen+California.html",
   "user_wallpaper_count":6,
   "title":"Lady Blue",
   "description":"This is Moraine Lake in Banff National Park. The colour of the water has a sweet and creamy look that reminds me of Havasu Falls in Arizona.\r\n\r\nEnjoy!",
   "date_featured":"2012-08-10 15:47:12",
   "date_featured_text":"August 10th,
    2012",
   "date_featured_timestamp":1344613632,
   "favorites_count":87,
   "comments_count":5,
   "url_ifl":"http:\/\/interfacelift.com\/wallpaper\/details\/3029\/Lady+Blue.html",
   "url_ifl_short":"http:\/\/ifl.cc\/a67",
   "latitude":51.327777862549,
   "longitude":-116.18055725098,
   "camera_id":6,
   "camera_brand":"Nikon",
   "camera_model":"D7000",
   "lens_id":643,
   "lens_brand":"Tamron",
   "lens_model":"SP AF 17-50mm F\/2.8 XR Di II LD Aspherical (IF)",
   "exposure_focal_length":32,
   "exposure_aperture":9,
   "exposure_shutter_speed":0.00625000009313,
   "exposure_iso":100,
   "resolutions_available_array":
      ["3840x2400",
       "3840x2160",
       "2880x1800",
       "2880x1620",
       "2560x1600",
       "2560x1440",
       "2560x1024",
       "2048x2048",
       "1920x1408",
       "1920x1200",
       "1920x1080",
       "1680x1050",
       "1600x1200",
       "1600x900",
       "1440x1280",
       "1440x900",
       "1400x1050",
       "1366x768",
       "1280x1024",
       "1280x960",
       "1280x800",
       "1280x720",
       "1080x960",
       "1024x1024",
       "1024x768",
       "1024x640",
       "1024x600",
       "960x854",
       "960x800",
       "960x544",
       "800x480",
       "768x1280",
       "720x1280",
       "640x1136",
       "640x960",
       "640x480",
       "600x1024",
       "480x800",
       "480x272",
       "360x480",
       "320x480",
       "320x400",
       "320x240"],
   "preview_width":240,
   "preview_height":150,
   "preview_size_in_bytes":28354,
   "preview_url":"http:\/\/api.ifl.cc\/v1\/previews\/03029_ladyblue.jpg",
   "preview@2x_width":480,
   "preview@2x_height":300,
   "preview@2x_size_in_bytes":60611,
   "preview@2x_url":"http:\/\/api.ifl.cc\/v1\/previews\/03029_ladyblue@2x.jpg"
}

Wallpapers

GET /v1/wallpapers/

Array of 'Wallpaper' objects. Optionally filtered by image 'resolution', a 'search' term, and/or a 'tag_id'.

Request Parameters:
Parameter Required Type Example Description
limit Optional number 10 Maximum number of objects to return. Default is 10 objects if not explicitly specified.
resolution Optional string 1920x1080 If a screen resolution is provided, the resulting list will only contain 'Wallpaper' objects available in that resolution.
search Optional string Search keyword text.
sort_by Optional string date The attribute by which to sort 'Wallpaper' objects returned by the request. Default is 'date' if not explicitly specified. Allowed values include 'date', 'id', 'favorites', 'downloads', 'comments', and 'random'.
sort_order Optional string asc Sort the comment array in ascending ('asc') or descending time order ('desc').
start Optional number 0 The number of objects to skip over in the result set. Pair this parameter with 'limit' in order to implement paging of results.
tag_id Optional number 614 Unique identifier for a 'Tag' object.
preview Optional string 480x270 If a value is provided for the 'preview' parameter, a custom preview image will be generated for each wallpaper in the list. Metadata will be included for the custom preview image's width, height, file size in bytes, and download URL.

Example (A):

Get Data Sources (JSON)
Example Request:
/v1/wallpapers/?limit=10&resolution=1920x1080&sort_by=date&sort_order=desc&start=0&tag_id=614
Example Response:
[
  {
    "camera_brand": "Canon",
    "camera_id": 283,
    "camera_model": "EOS 6D",
    "comments_count": 0,
    "date_featured": "2014-08-29 21:17:37",
    "date_featured_text": "August 29th, 2014",
    "date_featured_timestamp": 1409347057,
    "description": "Manarola... Piccolo paradiso delle 5 Terre.\r\n\r\nAdobe Photoshop CC.",
    "exposure_aperture": 16,
    "exposure_focal_length": 24,
    "exposure_iso": 400,
    "exposure_shutter_speed": 20,
    "favorites_count": 61,
    "id": 3687,
    "latitude": 0,
    "lens_brand": "Canon",
    "lens_id": 286,
    "lens_model": "EF 24-105mm f/4L IS USM",
    "longitude": 0,
    "preview_height": 150,
    "preview_height@2x": 300,
    "preview_size_in_bytes": 29124,
    "preview_size_in_bytes@2x": 57930,
    "preview_url": "http://api.ifl.cc/v1/previews/03687_manarola5terre.jpg",
    "preview_url@2x": "http://api.ifl.cc/v1/previews/03687_manarola5terre@2x.jpg",
    "preview_width": 240,
    "preview_width@2x": 480,
    "resolutions_available_array": [
      "4096x2160",
      "3840x2400",
      "3840x2160",
      "3440x1440",
      "3360x2100",
      "3200x1800",
      "2880x1800",
      "2880x1620",
      "2560x1600",
      "2560x1440",
      "2560x1080",
      "2560x1024",
      "2208x2208",
      "2160x1920",
      "2048x2048",
      "1920x1408",
      "1920x1200",
      "1920x1080",
      "1680x1050",
      "1600x2560",
      "1600x1200",
      "1600x900",
      "1440x1280",
      "1440x900",
      "1400x1050",
      "1366x768",
      "1280x1024",
      "1280x960",
      "1280x800",
      "1280x720",
      "1242x2208",
      "1200x1920",
      "1080x1920",
      "1080x960",
      "1024x1024",
      "1024x768",
      "1024x640",
      "1024x600",
      "960x1704",
      "960x854",
      "960x800",
      "960x544",
      "800x480",
      "768x1280",
      "750x1334",
      "720x1280",
      "640x1136",
      "640x960",
      "640x480",
      "600x1024",
      "480x800",
      "480x272",
      "360x480",
      "320x480",
      "320x400",
      "320x240"
    ],
    "tag_id_array": [
      51,
      96,
      3270,
      1426,
      55,
      614,
      1433,
      2510,
      2747,
      52,
      184,
      158,
      57
    ],
    "title": "Manarola 5 Terre",
    "url_ifl": "http://interfacelift.com/wallpaper/details/3687/Manarola+5+Terre.html",
    "url_ifl_short": "http://ifl.cc/ay9",
    "user_id": 119459,
    "user_name": "Samuel84",
    "user_url_ifl": "http://interfacelift.com/user/119459/Samuel84.html",
    "user_wallpaper_count": 1
  },
  {
    "camera_brand": "Nikon",
    "camera_id": 192,
    "camera_model": "D800",
    "comments_count": 3,
    "date_featured": "2014-02-26 14:08:42",
    "date_featured_text": "February 26th, 2014",
    "date_featured_timestamp": 1393423722,
    "description": "The Matterhorn is a mountain in the Pennine Alps on the border between Switzerland and Italy. Its summit is 4,478 metres (14,692 ft) high, making it one of the highest peaks in the Alps. The four steep faces, rising above the surrounding glaciers, face the four compass points.\r\n\r\nLens adapter: Fotodiox Wonderpana 145 with polarizer filter.\r\n\r\nAdobe Photoshop CS6, Adobe Camera RAW 8.",
    "exposure_aperture": 5.6,
    "exposure_focal_length": 24,
    "exposure_iso": 50,
    "exposure_shutter_speed": 0.00800000037998,
    "favorites_count": 86,
    "id": 3508,
    "latitude": 45.976390838623,
    "lens_brand": "Nikon",
    "lens_id": 218,
    "lens_model": "AF-S NIKKOR 14-24mm f/2.8G ED",
    "longitude": 7.658332824707,
    "preview_height": 150,
    "preview_height@2x": 300,
    "preview_size_in_bytes": 23531,
    "preview_size_in_bytes@2x": 47722,
    "preview_url": "http://api.ifl.cc/v1/previews/03508_matterhornssnowcone.jpg",
    "preview_url@2x": "http://api.ifl.cc/v1/previews/03508_matterhornssnowcone@2x.jpg",
    "preview_width": 240,
    "preview_width@2x": 480,
    "resolutions_available_array": [
      "3840x2400",
      "3840x2160",
      "3360x2100",
      "2880x1800",
      "2880x1620",
      "2560x1600",
      "2560x1440",
      "2560x1080",
      "2560x1024",
      "2208x2208",
      "2160x1920",
      "2048x2048",
      "1920x1408",
      "1920x1200",
      "1920x1080",
      "1680x1050",
      "1600x1200",
      "1600x900",
      "1440x1280",
      "1440x900",
      "1400x1050",
      "1366x768",
      "1280x1024",
      "1280x960",
      "1280x800",
      "1280x720",
      "1242x2208",
      "1200x1920",
      "1080x1920",
      "1080x960",
      "1024x1024",
      "1024x768",
      "1024x640",
      "1024x600",
      "960x854",
      "960x800",
      "960x544",
      "800x480",
      "768x1280",
      "750x1334",
      "720x1280",
      "640x1136",
      "640x960",
      "640x480",
      "600x1024",
      "480x800",
      "480x272",
      "360x480",
      "320x480",
      "320x400",
      "320x240"
    ],
    "tag_id_array": [
      96,
      153,
      614,
      88,
      2125,
      152,
      89,
      3446,
      158,
      103,
      223,
      1465,
      102,
      222
    ],
    "title": "Matterhorn's Snow Cone",
    "url_ifl": "http://interfacelift.com/wallpaper/details/3508/Matterhorn%27s+Snow+Cone.html",
    "url_ifl_short": "http://ifl.cc/aqs",
    "user_id": 6618,
    "user_name": "Dominic Kamp",
    "user_url_ifl": "http://interfacelift.com/user/6618/Dominic+Kamp.html",
    "user_wallpaper_count": 87
  }
]

Wallpapers By Timestamp

GET /v1/wallpapersByTimestamp/

Array of 'Wallpaper' objects. 'timestamp' is the only required parameter, all others are optional.

Request Parameters:
Parameter Required Type Example Description
direction Optional string newer Determines whether to fetch wallpapers that are 'newer' or 'older' than the specified timestamp.
limit Optional number 10 Maximum number of 'Wallpaper' objects to return.
resolution Optional string 1920x1080 If an image resolution is provided, the resulting list will only contain 'Wallpaper' objects available in that resolution.
tag_id Optional number 300 Unique identifier for a 'Tag' object.
timestamp Required number 1346808341 A date/time in the form of a UNIX Timestamp (defined as the number of seconds that have elapsed since 00:00:00 UTC, Thursday, 1 January 1970). Each wallpaper object lists the timestamp at which it was published. Use this value to fetch wallpapers that were published prior to that date or more recently than that date.
preview Optional string 480x270 If a value is provided for the 'preview' parameter, a custom preview image will be generated for each wallpaper in the list. Metadata will be included for the custom preview image's width, height, file size in bytes, and download URL.

Example (A):

Get Data Sources (JSON)
Example Request:
/v1/wallpapersByTimestamp/?direction=newer&limit=2&resolution=1920x1200&tag_id=300×tamp=1346808341
Example Response:
[[
  {
    "camera_brand": "Canon",
    "camera_id": 50,
    "camera_model": "EOS 5D Mark II",
    "comments_count": 1,
    "date_featured": "2012-09-15 16:39:58",
    "date_featured_text": "September 15th, 2012",
    "date_featured_timestamp": 1347727198,
    "description": "Taken on a secluded beach on the island of Lefkada, Greece.\r\n\r\nAdobe Photoshop Lightroom 4, Adobe Photoshop CS5.",
    "exposure_aperture": 9,
    "exposure_focal_length": 70,
    "exposure_iso": 50,
    "exposure_shutter_speed": 1,
    "favorites_count": 81,
    "id": 3068,
    "latitude": 0,
    "lens_brand": "Canon",
    "lens_id": 492,
    "lens_model": "EF 24-70mm f2.8L II USM",
    "longitude": 0,
    "preview_height": 150,
    "preview_height@2x": 300,
    "preview_size_in_bytes": 148080,
    "preview_size_in_bytes@2x": 166638,
    "preview_url": "http://api.ifl.cc/v1/previews/03068_mediterraneansun.jpg",
    "preview_url@2x": "http://api.ifl.cc/v1/previews/03068_mediterraneansun@2x.jpg",
    "preview_width": 240,
    "preview_width@2x": 480,
    "resolutions_available_array": [
      "3840x2400",
      "3840x2160",
      "3840x1200",
      "3840x1080",
      "3840x1024",
      "3840x960",
      "3840x720",
      "3360x2100",
      "3360x1050",
      "3200x1200",
      "3072x768",
      "2880x1800",
      "2880x1620",
      "2880x900",
      "2560x1600",
      "2560x1440",
      "2560x1024",
      "2048x2048",
      "1920x1408",
      "1920x1200",
      "1920x1080",
      "1680x1050",
      "1600x1200",
      "1600x900",
      "1440x1280",
      "1440x900",
      "1400x1050",
      "1366x768",
      "1280x1024",
      "1280x960",
      "1280x800",
      "1280x720",
      "1080x960",
      "1024x1024",
      "1024x768",
      "1024x640",
      "1024x600",
      "960x854",
      "960x800",
      "960x544",
      "800x480",
      "768x1280",
      "720x1280",
      "640x1136",
      "640x960",
      "640x480",
      "600x1024",
      "480x800",
      "480x272",
      "360x480",
      "320x480",
      "320x400",
      "320x240"
    ],
    "tag_id_array": [
      300,
      506,
      230,
      3031,
      184,
      129,
      158,
      103,
      199,
      1593,
      57
    ],
    "title": "Mediterranean Sun",
    "url_ifl": "http://interfacelift.com/wallpaper/details/3068/Mediterranean+Sun.html",
    "url_ifl_short": "http://ifl.cc/a7v",
    "user_id": 42369,
    "user_name": "Lowe Rehnberg",
    "user_url_ifl": "http://interfacelift.com/user/42369/Lowe+Rehnberg.html",
    "user_wallpaper_count": 24
  },
  {
    "camera_brand": "Canon",
    "camera_id": 50,
    "camera_model": "EOS 5D Mark II",
    "comments_count": 2,
    "date_featured": "2012-09-18 20:34:27",
    "date_featured_text": "September 18th, 2012",
    "date_featured_timestamp": 1348000467,
    "description": "The beach of Milos on Lefkada is only accessible by boat or a 20-minute hike over a mountain. This means you can enjoy the sunset all by yourself.\r\n\r\nAdobe Photoshop Lightroom 4, Adobe Photoshop CS5.",
    "exposure_aperture": 14,
    "exposure_focal_length": 43,
    "exposure_iso": 50,
    "exposure_shutter_speed": 0.5,
    "favorites_count": 142,
    "id": 3073,
    "latitude": 0,
    "lens_brand": "Canon",
    "lens_id": 287,
    "lens_model": "EF 24-70mm f/2.8L USM",
    "longitude": 0,
    "preview_height": 150,
    "preview_height@2x": 300,
    "preview_size_in_bytes": 174813,
    "preview_size_in_bytes@2x": 200103,
    "preview_url": "http://api.ifl.cc/v1/previews/03073_peekingsun.jpg",
    "preview_url@2x": "http://api.ifl.cc/v1/previews/03073_peekingsun@2x.jpg",
    "preview_width": 240,
    "preview_width@2x": 480,
    "resolutions_available_array": [
      "3840x2400",
      "3840x2160",
      "3840x1200",
      "3360x2100",
      "3360x1050",
      "3200x1200",
      "2880x1800",
      "2880x1620",
      "2880x900",
      "2560x1600",
      "2560x1440",
      "2560x1024",
      "2048x2048",
      "1920x1408",
      "1920x1200",
      "1920x1080",
      "1680x1050",
      "1600x1200",
      "1600x900",
      "1440x1280",
      "1440x900",
      "1400x1050",
      "1366x768",
      "1280x1024",
      "1280x960",
      "1280x800",
      "1280x720",
      "1080x960",
      "1024x1024",
      "1024x768",
      "1024x640",
      "1024x600",
      "960x854",
      "960x800",
      "960x544",
      "800x480",
      "768x1280",
      "720x1280",
      "640x1136",
      "640x960",
      "640x480",
      "600x1024",
      "480x800",
      "480x272",
      "360x480",
      "320x480",
      "320x400",
      "320x240"
    ],
    "tag_id_array": [
      96,
      300,
      506,
      230,
      3035,
      3034,
      184,
      129,
      58,
      896,
      103,
      199,
      1593,
      57,
      1631
    ],
    "title": "Peeking Sun",
    "url_ifl": "http://interfacelift.com/wallpaper/details/3073/Peeking+Sun.html",
    "url_ifl_short": "http://ifl.cc/a81",
    "user_id": 42369,
    "user_name": "Lowe Rehnberg",
    "user_url_ifl": "http://interfacelift.com/user/42369/Lowe+Rehnberg.html",
    "user_wallpaper_count": 24
  }
]

Help Topics

API Pricing

Free Basic Basic+ Pro Premium
API Requests 1,000 25,000 250,000 500,000 Unlimited
Wallpaper Downloads 100 2,500 25,000 50,000 1,000,000
Submission Downloads 10 250 2,500 10,000 200,000
Free $4/month $29/month $49/month $99/month

To start your Free Trial simply log in to our developer portal using your InterfaceLIFT account password. You will be able to create an API key and get started making requests immediately.

If you do not already have an InterfaceLIFT account, you may create one via our sign up page. Not sure what your password is? Visit our password reset page.

To sign up for a monthly plan, log in and go to the subscription page. Payment is handled as a recurring PayPal subscription. Your usage can be tracked (with a delay of just a few minutes) on your stats page.

The Free Trial is there to let you test the waters while our Basic Plan is meant for app development and testing pre-launch. The Pro Plan is meant for apps with a modest install base and the Premium Plan should cover most popular apps. If you need a custom plan, get in touch.

Authentication

API requests must be made over HTTPS and be accompanied by an API Key sent via the X-IFL-API-Key header.

Create multiple keys to track your API usage in detail. We suggest using separate keys for development, beta tests, and each version of your app. All your keys share the same allotment of credits you've subscribed to.

Revoke a key to temporarily or permanently block requests from a buggy or out-dated version of your client app. Delete a key to permanently block requests and hide it from the charts of your API usage.

Terms and Conditions

The "InterfaceLIFT Wallpapers" application programming interface, henceforth referred to as "the API", is a service provided by L-bow Grease, LLC. It is published for private and public consumption, both free and paid.

Usage of the API is governed by the terms and conditions outlined below. Please read carefully. In the event of any confusion, please contact jeff@interfacelift.com for clarification prior to beginning or continuing the usage of the API. If your usage of the API requires an alternative set of terms and conditions or guaranteed levels of service, please contact jeff@interfacelift.com for more information.

The API is provided as-is, with no warranty. Neither L-bow Grease, LLC nor its owner(s) and/or operator(s) shall be held liable for any damages incurred as the result of using or accessing the API or its data, either by the person or legal entity agreeing to these terms and conditions, or by their end-users or customers.

Copyright

The design of the API, including but not limited to the structure and nature of permissible requests, their server-side implementation thereof, and the responses provided by the API requests are copyrighted by L-bow Grease, LLC and may not be duplicated, cached, or redistributed in whole or in part by any third-party intermediary except where unavoidable by standard, general-purpose Internet infrastructure.

The images provided by the API are copyrighted by their original creators and are licensed by L-bow Grease, LLC for redistribution to end-users for personal usage only on digital devices via the InterfaceLIFT web site, the API, and associated services of L-bow Grease, LLC.

Usage

Software developers may make use of the data and images provided by the API in free or commercial applications or service offerings so long as each of the following conditions are met:

Service Level Agreement

No guarantees are made as to the availability, uptime, or performance characteristics of the API. 100% availability is the goal, but this may not be achieved in practice due to matters of practicality. L-bow Grease, LLC reserves the right to limit or restrict availability of the API without prior notice at any time.

Refunds

In the event of excessive, non-routine problems with the API such as extended downtime, extreme unreliability, anomalous output, or unusably poor performance, refunds of paid usage of the API may be made available upon request. Documentation of the extenuating circumstances is required within 30 days of the event(s). Any refunds and their amounts shall be made at the descretion of L-bow Grease, LLC.