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.
Read-only API endpoints.
Interchangeable-lens camera body.
Parameter | Required | Type | Example | Description |
id | Required | number | 1 | Unique identifier for a 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" }
Lens for an interchangeable-lens camera body.
Parameter | Required | Type | Example | Description |
id | Required | number | 1 | Unique identifier for a camera lens. |
{ "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 }
User-submitted comment.
Parameter | Required | Type | Example | Description |
id | Required | number | 1 | Unique identifier for a comment. |
{ "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" }
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.
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. |
{ "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" }
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.
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. |
{ "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" }
Returns a 'Wallpaper Submission' object.
Parameter | Required | Type | Example | Description |
id | Required | number | 87407 | Unique identifier of a 'Wallpaper Submission'. |
{ "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" }
Returns a download link for a 'Wallpaper Submission'.
Parameter | Required | Type | Example | Description |
submission_id | Required | number | 87479 | Unique identifier for a 'Wallpaper Submission' object. |
{ "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" }
Returns an array of 'Wallpaper Submission' objects. To get a download link, call the 'Wallpaper Submission Download' API using a 'submission_id' number.
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. |
[ { "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" } ]
Find the best match between an arbitrary display resolution and a supported InterfaceLIFT resolution.
Parameter | Required | Type | Example | Description |
resolution | Required | string | 1919x1079 | Display resolution. |
[ { "id": 19, "width": 1920, "height": 1080, "nearness": 1 } ]
Supported wallpaper resolutions including a count of the number of available images per image size.
[ { "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, category, or keyword. Call it what you like.
Parameter | Required | Type | Example | Description |
id | Required | number | 538 | Unique identifier for a 'Tag' object. |
{ "id": 538, "tag_name": "lakeshore drive", "type": "Location", "related_searches": [ "chicago" ] }
Tag, category, or keyword. Call it what you like.
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'. |
{ "id": 538, "tag_name": "lakeshore drive", "type": "Location", "related_searches": [ "chicago" ] }
Returns a 'User' object.
Parameter | Required | Type | Example | Description |
id | Required | number | 312 | Unique identifier for a 'User' object. |
{ "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 ] }
Returns a 'Wallpaper' object.
Parameter | Required | Type | Example | Description |
id | Required | number | 3029 | Unique identifier for a 'Wallpaper' 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" }
Returns an object containing the download URL for the specified 'wallpaper_id' and image 'resolution'.
Parameter | Required | Type | Example | Description |
resolution | Required | string | 1280x800 | Image resolution to download. |
id | Required | number | 3001 | Unique identifier for a 'Wallpaper' object. |
{ "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" }
Returns a 'Wallpaper' object.
Parameter | Required | Type | Example | Description |
id | Required | number | 3029 | Unique identifier for a 'Wallpaper' 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" }
Array of 'Wallpaper' objects. Optionally filtered by image 'resolution', a 'search' term, and/or a 'tag_id'.
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. |
[ { "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 } ]
Array of 'Wallpaper' objects. 'timestamp' is the only required parameter, all others are optional.
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. |
[[ { "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 } ]
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.
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.
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.
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.
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:
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.
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.