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, through services provided by Mashape Inc.

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.

Terms and Conditions

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:

  • The application or service shall only provide the data and images from the API for usage by individuals for the purposes of customizing the look and feel of personal digital devices such as computers, laptops, televisions, tablets, and phones.

  • Public display or redistribution by end users, whether for commercial or non-commercial purposes, is NOT permitted.

  • The transfer of API data and images to physical media, such as but not limited to photographic prints, CDs, DVDs, apparel, whether for commercial or non-commercial purposes, is NOT permitted.

  • The application or service shall pass all end-user requests for API data directly to the API as hosted by Mashape Inc. No third-party caching or intermediary layers are permitted. The API data may NOT be stored on third-party servers.

  • The application or service shall not offer for sale individual images provided by the API nor sets of images provided by the API.

  • The application or service shall not offer or imply expanded content usage rights for the data or images provided by the API.

  • The application or service shall clearly and visibly associate the username, image title, image description, and either a content-owner URL or the content-specific InterfaceLIFT URL with each image accessed via the API.

  • The application or service shall clearly and visibly credit "InterfaceLIFT.com" as the content provider of any and all data provided by the API.

If you are concerned that the usage scenario you envision of the API by your application or service is not permitted, please contact jeff@interfacelift.com for more information and clarification. Exceptions to some of the terms and conditions outlined in this document may be granted under the appropriate circumstances.

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 and Mashape Inc. reserve 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 and/or Mashape Inc.

Last 7 days, UTC

Average Latency
121ms

Average Uptime
100.0%

Current Status
Online

  • No information
  • Outage
  • Disruption
  • Normal
Average latency determined from Mashape to API Response time

Simple & Straightforward Pricing

Pay as you go. No long-term contracts.

Freemium

$0

additional fees may apply

Downloads

750 / mo.

$0.0300 per extra

API Requests

7,500 / mo.

$0.0100 per extra

Subscribe

ultra

$99.00

per month

Downloads

5,000,000 / mo.

$0.0050 per extra

API Requests

50,000,000 / mo.

$0.0010 per extra

Subscribe

Read-Only

HTTP 200 : Camera Body GET/v1/camera/{id}/
Interchangeable-lens camera body.
						{
  "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 Body

Interchangeable-lens camera body


Test console
Description
Parameter
number

Unique identifier for the camera body.
Example: 1

id

Required

HTTP 200 : Camera Lens GET/v1/lens/{id}/
Lens for an interchangeable-lens camera.
						{
  "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
}						
Camera Lens

Interchangeable-lens for a camera body


Test console
Description
Parameter
number

Unique identifier for a camera lens
Example: 621

id

Required

HTTP 200 : Comment GET/v1/comment/{id}/
User-submitted comment about a Wallpaper featured on InterfaceLIFT.
						{
  "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"
}						
Comment

Test console
Description
Parameter
number

Unique identifier for the comment
Example: 651585

id

Required

HTTP 200 : Comment GET/v1/comments/
User-submitted comment about a Wallpaper featured on InterfaceLIFT.
						[{
  "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

A time-ordered array of comments about a specific 'Wallpaper' and/or posted by a specific 'User'.


Test console
Description
Parameter
number

Unique identifier of a Wallpaper object
Example: 3055

wallpaper_id

Optional

number

Unique identifier of a User object
Example: 10175

user_id

Optional

string

Sort the comment array in ascending or descending time order.
Example: asc

sort_order

Optional

number

Example: 0

start

Optional

number

Maximum number of comments to return
Example: 10

limit

Optional

HTTP 200 : Wallpaper GET/v1/favorites/{user_id}/
An InterfaceLIFT Wallpaper. Includes commonly-used properties from related Models. For a download link, query for a 'Wallpaper Download' object.
						[{
   "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"
}]						
Favorites

Test console
Description
Parameter
number

Unique ID of a User.
Example: 312

user_id

Required

number

Maximum number of objects to return. Default is 10 objects if not explicitly specified.
Example: 10

limit

Optional

string

If a screen resolution is provided, the resulting list will only contain 'Wallpaper' objects available in that resolution.
Example: 1920x1080

resolution

Optional

string

The attribute by which to sort 'Wallpaper' objects returned by the request. Default is 'date' if not explicitly specified.
Example: 'date', 'id', 'favorites', 'downloads', 'comments'

sort_by

Optional

string

Order the 'Wallpaper' objects by the 'sort_by' attribute' in ascending or descending order. Default is 'desc' if not explicitly specified.
Example: 'asc', 'desc'

sort_order

Optional

number

The number of objects to skip over in the result set. Pair this parameter with 'limit' in order to implement paging of results.
Example: 0

start

Optional

HTTP 200 : Submission GET/v1/submission/{id}/
A wallpaper submission uploaded by a member of InterfaceLIFT.com.
						{
  "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"
}						
Submission

Returns a wallpaper 'Submission' object.


Test console
Description
Parameter
number

Unique identifier of a wallpaper submission.
Example: 87407

id

Required

HTTP 200 : Submission Download GET/v1/submission_download/{submission_id}/
Wallpaper Submission image download. Please note that each 'Submission Download' object retrieved counts against your 'Downloads' limit regardless of whether or not the 'download_url' is accessed. For that reason, you should only request this object when the end user actually attempts a download.
						{
  "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"
}						
Submission Download

An object containing the download URL for the specified 'submission_id'.


Test console
Description
Parameter
number

Example: 87479

submission_id

Required

HTTP 200 : Submission GET/v1/submissions/
A wallpaper submission uploaded by a member of InterfaceLIFT.com.
						[{
  "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"
}]						
Submissions

Returns an array of wallpaper 'Submission' objects.


Test console
Description
Parameter
number

Maximum number of objects to return. Default is 10 objects if not explicitly specified.
Example: 10

limit

Optional

number

The number of objects to skip over in the result set. Pair this parameter with 'limit' in order to implement paging of results.
Example: 0

start

Optional

number

Example: 312

user_id

Optional

HTTP 200 : Tag GET/v1/tag/{id}/
Tag, category, or keyword describing a 'Wallpaper' object.
						{
  "id": 538,
  "tag_name": "lakeshore drive",
  "type": "Location",
  "related_searches": [
    "chicago"
  ]
}						
Tag

Tag, category, or keyword.


Test console
Description
Parameter
string

Unique identifier
Example: 538

id

Required

HTTP 200 : Tag GET/v1/tags/
Tag, category, or keyword describing a 'Wallpaper' object.
						[{
  "id": 538,
  "tag_name": "lakeshore drive",
  "type": "Location",
  "related_searches": [
    "chicago"
  ]
}]						
Tags

Array of tags/categories/keywords matching the search criteria.


Test console
Description
Parameter
string

Search keyword text
Example: Lake

search

Optional

string

Type of tag. On of: Color, 'Scene', 'Location', 'Event', 'Subject', 'Equipment', 'Medium'
Example: Location

type

Optional

HTTP 200 : User GET/v1/user/{id}/
A member of InterfaceLIFT
						{
  "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
  ]
}						
User

Test console
Description
Parameter
string

Unique ID of User.
Example: 312

id

Required

HTTP 200 : Wallpaper GET/v1/wallpaper/{id}/
An InterfaceLIFT Wallpaper. Includes commonly-used properties from related Models. For a download link, query for a 'Wallpaper Download' object.
						{
   "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

Returns a 'Wallpaper' object.


Test console
Description
Parameter
number

Unique ID of the desired 'Wallpaper' object.
Example: 3029

id

Required

HTTP 200 : Wallpaper Download GET/v1/wallpaper_download/{wallpaper_id}/{resolution}/
Wallpaper image download for a specific screen resolution. Please note that each 'Wallpaper Download' object retrieved counts against your 'Downloads' limit regardless of whether or not the 'download_url' is accessed. For that reason, you should only request this object when the end user actually attempts a download.
						{
  "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 Download

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


Test console
Description
Parameter
string

Image resolution to download.
Example: '1920x1080'

resolution

Required

number

Unique identifier for the 'Wallpaper'
Example: 3001

wallpaper_id

Required

HTTP 200 : Comment GET/v1/wallpapers/
User-submitted comment about a Wallpaper featured on InterfaceLIFT.
						[{
  "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"
}]						
Wallpapers

Array of 'Wallpaper' objects. All parameters are optional. The ten most-recent 'Wallpaper' objects are returned by default.


Test console
Description
Parameter
number

Maximum number of objects to return. Default is 10 objects if not explicitly specified.
Example: 10

limit

Optional

string

If a screen resolution is provided, the resulting list will only contain 'Wallpaper' objects available in that resolution.
Example: 1920x1080

resolution

Optional

string

The attribute by which to sort 'Wallpaper' objects returned by the request. Default is 'date' if not explicitly specified.
Example: 'date', 'id', 'favorites', 'downloads', 'comments'

sort_by

Optional

string

Order the 'Wallpaper' objects by the 'sort_by' attribute' in ascending or descending order. Default is 'desc' if not explicitly specified.
Example: 'asc', 'desc'

sort_order

Optional

number

The number of objects to skip over in the result set. Pair this parameter with 'limit' in order to implement paging of results.
Example: 0

start

Optional

number

The ID number of a wallpaper category from the 'Tags' endpoint. A value of 199 would return only wallpapers categorized as 'sunset' pictures.
Example: 199

tag_id

Optional

HTTP 200 : Wallpaper GET/v1/wallpapersByTimestamp/
An InterfaceLIFT Wallpaper. Includes commonly-used properties from related Models. For a download link, query for a 'Wallpaper Download' object.
						[{
   "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 By Timestamp

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


Test console
Description
Parameter
number

Maximum number of objects to return. Parameter is optional. If not 'limit' is set, all matching results are returned.
Example: 10

limit

Optional

string

If a screen resolution is provided, the resulting list will only contain 'Wallpaper' objects available in that resolution.
Example: 1920x1200

resolution

Optional

string

Determines whether to fetch wallpapers that are 'newer' or 'older' than the specified timestamp.
Example: newer

direction

Optional

number

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.
Example: 1346808341

timestamp

Required

string

Optional Tag identifier (see 'Tag' model), allowing you to fetch only those wallpapers tagged with a specific keyword.
Example: 300

tag_id

Optional

You must have an API key to test this API!


Mashape allows developers to find, consume, and distribute cloud APIs just like Wallpapers.

Login to your account or signup: Create Account

or
   Signup with GitHub

By signing up you agree to our terms of service.