zooomr.favorites.getList

Returns a list of the user's favorite photos. Only photos which the calling user has permission to see are returned.

Authentication

This method requires authentication with 'read' permission.

Arguments

api_key (Required)

Your API application key

user_id (Optional)

The NSID of the user to fetch the favorites list for. If this argument is omitted, the favorites list for the calling user is returned.

extras (Optional)

A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are: license, date_upload, date_taken, owner_name, icon_server, original_format, last_update, geo, tags, machine_tags, o_dims, views, media.

per_page (Optional)

Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500.

page (Optional) NOT YET IMPLEMENTED

The page of results to return. If this argument is omitted, it defaults to 1.

Example Response

{"photos": {"photo": [{"isfamily": 0, "title": "escalating the concept", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "3cb8345c63", "owner": "14925@Z01", "id": 4778592}, {"isfamily": 0, "title": "Digg Front Page", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "02ea7d99a7", "owner": "32025@Z01", "id": 4786281}, {"isfamily": 0, "title": "I Said People", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "5d54b41aa0", "owner": "64676@Z01", "id": 4744045}, {"isfamily": 0, "title": "Spring on Balcony", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "f4deb83c2f", "owner": "55802@Z01", "id": 4742188}, {"isfamily": 0, "title": "Go Green", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "fda2aa12e5", "owner": "45969@Z01", "id": 4737809}, {"isfamily": 0, "title": "creativeCommons", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "c30dae961f", "owner": "21609@Z01", "id": 4464477}, {"isfamily": 0, "title": "080308_130324", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "2bbda12a70", "owner": "45945@Z01", "id": 4517892}, {"isfamily": 0, "title": "The Vortex", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "aa5de78ccc", "owner": "73582@Z01", "id": 4727321}, {"isfamily": 0, "title": "trafficmirror", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "9bd1285123", "owner": "33644@Z01", "id": 4714732}, {"isfamily": 0, "title": "Intent", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "5af62c16c7", "owner": "81113@Z01", "id": 4709734}, {"isfamily": 0, "title": "Sunny Flowers", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "ad1bd1a49d", "owner": "46642@Z01", "id": 4684166}, {"isfamily": 0, "title": "70", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "e9f171edcc", "owner": "46642@Z01", "id": 4684172}, {"isfamily": 0, "title": "As Real, As Real Gets", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "4a65a83bc3", "owner": "45969@Z01", "id": 4699293}, {"isfamily": 0, "title": "DANGER!", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "7b03555966", "owner": "26725@Z01", "id": 4697418}, {"isfamily": 0, "title": "", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "d13fd0924c", "owner": "70324@Z01", "id": 4667783}, {"isfamily": 0, "title": "", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "80be199832", "owner": "70324@Z01", "id": 4697654}, {"isfamily": 0, "title": "To The Top", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "74b36dd150", "owner": "17143@Z01", "id": 4678668}, {"isfamily": 0, "title": "Flying Into Focus", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "068c088ff4", "owner": "17143@Z01", "id": 4678670}, {"isfamily": 0, "title": "apx_roll22_06", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "a76919c09f", "owner": "54122@Z01", "id": 4668694}, {"isfamily": 0, "title": "apx_roll22_05", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "ca85304bd3", "owner": "54122@Z01", "id": 4668693}, {"isfamily": 0, "title": "Jordan's Shred Sled", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "d8b9d55f4f", "owner": "45969@Z01", "id": 4666513}, {"isfamily": 0, "title": "Millions of Minions", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "e246b200d1", "owner": "45969@Z01", "id": 4666484}, {"isfamily": 0, "title": "Caixa Forum Staircase", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "e73e4987a1", "owner": "36345@Z01", "id": 4667521}, {"isfamily": 0, "title": "Night 14-04-2008 032", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "8bd87bec15", "owner": "73333@Z01", "id": 4665588}, {"isfamily": 0, "title": "", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "1b7a21a9fe", "owner": "70324@Z01", "id": 4667782}, {"isfamily": 0, "title": "well", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "b3de8e1b09", "owner": "14925@Z01", "id": 4512000}, {"isfamily": 0, "title": "Backlight", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "b0a5dc721d", "owner": "26539@Z01", "id": 4658751}, {"isfamily": 0, "title": "See the Man?", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "197a4364ff", "owner": "34541@Z01", "id": 3784630}, {"isfamily": 0, "title": "Feed Me!", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "92f1249570", "owner": "34541@Z01", "id": 3793630}, {"isfamily": 0, "title": "grey lag snooze", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "b8938bac54", "owner": "23921@Z01", "id": 4645859}, {"isfamily": 0, "title": "The Gorilla-pod", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "46510b7382", "owner": "40001@Z01", "id": 4653541}, {"isfamily": 0, "title": "Either You Will or You Won't", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "88ae5a2eb9", "owner": "5652@Z01", "id": 4640182}, {"isfamily": 0, "title": "BlueSky Rainbow", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "f0b2f7a2d0", "owner": "2@Z01", "id": 4637739}, {"isfamily": 0, "title": "Caught In A Moment", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "291701fc88", "owner": "31645@Z01", "id": 4638186}, {"isfamily": 0, "title": "Far too weak to be like that", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "08d8b2f3f9", "owner": "36436@Z01", "id": 4638347}, {"isfamily": 0, "title": "stockholm 002", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "27cbb8331a", "owner": "14925@Z01", "id": 4591308}, {"isfamily": 0, "title": "nacka 217", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "a3d1266434", "owner": "14925@Z01", "id": 4591297}, {"isfamily": 0, "title": "Tears In Rain", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "34e107279e", "owner": "41516@Z01", "id": 4602765}, {"isfamily": 0, "title": "Dell XPS M1330", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "e7d2244e97", "owner": "18345@Z01", "id": 4602929}, {"isfamily": 0, "title": "For Hire", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "381b3ec15f", "owner": "73582@Z01", "id": 4572902}, {"isfamily": 0, "title": "DSC_3376", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "8c3457b1d5", "owner": "41270@Z01", "id": 4593128}, {"isfamily": 0, "title": "IMG_6678", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "4005e74925", "owner": "80212@Z01", "id": 4495111}, {"isfamily": 0, "title": "IMG_6837", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "b705ce229b", "owner": "80212@Z01", "id": 4560355}, {"isfamily": 0, "title": "", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "d1d2329d92", "owner": "75964@Z01", "id": 4594971}, {"isfamily": 0, "title": "Like an alien cure", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "0e41683ed9", "owner": "36436@Z01", "id": 4581187}, {"isfamily": 0, "title": "Unspectacular view", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "545c49ab6e", "owner": "36436@Z01", "id": 4589787}, {"isfamily": 0, "title": "Journey", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "0845cde89e", "owner": "28655@Z01", "id": 4586646}, {"isfamily": 0, "title": "Condiments", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "2175867524", "owner": "28655@Z01", "id": 4586662}, {"isfamily": 0, "title": "Katwijk Duinen 086", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "c4d297e9c4", "owner": "73333@Z01", "id": 4585963}, {"isfamily": 0, "title": "90/365 - On The Top", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "ae8e94722b", "owner": "17143@Z01", "id": 4577602}, {"isfamily": 0, "title": "Stone Circle", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "ce55a8f80c", "owner": "40229@Z01", "id": 4567404}, {"isfamily": 0, "title": "tunnel", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "738939664b", "owner": "78433@Z01", "id": 4565893}, {"isfamily": 0, "title": "Maelstrom Warnings", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "db2b85cfc0", "owner": "45969@Z01", "id": 4560716}, {"isfamily": 0, "title": "Over You", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "6c76ebf1b5", "owner": "69477@Z01", "id": 4556771}, {"isfamily": 0, "title": "Helsinki - Meilahti", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "e2ded702d1", "owner": "26668@Z01", "id": 4556287}, {"isfamily": 0, "title": "Sunset ", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "9f07c2ccf2", "owner": "46642@Z01", "id": 4553692}, {"isfamily": 0, "title": "Night Vision", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "2ace369eb9", "owner": "5652@Z01", "id": 4553438}, {"isfamily": 0, "title": "\u5e78\u559c\u3055\u3093\u3078\u306e\u5199\u771f", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "7a055726bf", "owner": "2@Z01", "id": 4555367}, {"isfamily": 0, "title": "Nikkei Electronics Article", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "ec8ae0b608", "owner": "2@Z01", "id": 4548658}, {"isfamily": 0, "title": "A Cup Of Coffee", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "9c282fcdb7", "owner": "38228@Z01", "id": 4546453}, {"isfamily": 0, "title": "blue tree", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "c9bd75b157", "owner": "18345@Z01", "id": 4521337}, {"isfamily": 0, "title": "14", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "71279768f1", "owner": "18345@Z01", "id": 4531626}, {"isfamily": 0, "title": "Out By the Fire Breathing", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "8dbada1ab9", "owner": "5652@Z01", "id": 4521255}, {"isfamily": 0, "title": "Gherkin", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "69fa9c6d04", "owner": "56866@Z01", "id": 2922532}, {"isfamily": 0, "title": "Pink Eye 2", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "677b8195a4", "owner": "56866@Z01", "id": 2922538}, {"isfamily": 0, "title": "White daisy", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "9bacf0e868", "owner": "46642@Z01", "id": 4491662}, {"isfamily": 0, "title": "rail road ties", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "3f908e1a32", "owner": "46642@Z01", "id": 4519524}, {"isfamily": 0, "title": "Hypothetically Speaking", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "fd34f739c4", "owner": "45969@Z01", "id": 4517669}, {"isfamily": 0, "title": "First Day In North Carolina -7", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "59c51e7bd4", "owner": "31645@Z01", "id": 4491846}, {"isfamily": 0, "title": "Lunar Eclipse", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "40f9f65fef", "owner": "31645@Z01", "id": 4516427}, {"isfamily": 0, "title": "Closing Down", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "619fbf36b0", "owner": "31645@Z01", "id": 4516438}, {"isfamily": 0, "title": "...20", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "23987eb361", "owner": "38228@Z01", "id": 4505946}, {"isfamily": 0, "title": "Birch Bark", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "f1481650c4", "owner": "38228@Z01", "id": 4516482}, {"isfamily": 0, "title": "Too Far From Too Little", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "735cef659d", "owner": "45969@Z01", "id": 4513914}, {"isfamily": 0, "title": "liquidity", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "ca4ebd8326", "owner": "14925@Z01", "id": 4480427}, {"isfamily": 0, "title": "sway", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "f3884de611", "owner": "14925@Z01", "id": 4495610}, {"isfamily": 0, "title": "water impersonates CGI", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "7f98f089c1", "owner": "14925@Z01", "id": 4495644}, {"isfamily": 0, "title": "waiting for the rumble under bagis", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "e36ea5ebfd", "owner": "14925@Z01", "id": 4495706}, {"isfamily": 0, "title": "walk across", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "bbad986070", "owner": "14925@Z01", "id": 4495725}, {"isfamily": 0, "title": "sit back", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "1c694a1d70", "owner": "14925@Z01", "id": 4511994}, {"isfamily": 0, "title": "there is beauty in strength and form", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "e66ce77412", "owner": "14925@Z01", "id": 4511997}, {"isfamily": 0, "title": "my cloud machine", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "5a72dc0e68", "owner": "14925@Z01", "id": 4512001}, {"isfamily": 0, "title": "hammarby 113", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "66d8e6ab98", "owner": "14925@Z01", "id": 4512007}, {"isfamily": 0, "title": "One Among The Many", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "2ce6a8c0ac", "owner": "45044@Z01", "id": 4510944}, {"isfamily": 0, "title": "157333", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "3058914e44", "owner": "73333@Z01", "id": 4506170}, {"isfamily": 0, "title": "155333", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "0834f56a56", "owner": "73333@Z01", "id": 4505799}, {"isfamily": 0, "title": "166333", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "5c9c2fd70c", "owner": "73333@Z01", "id": 4511641}, {"isfamily": 0, "title": "", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "5c27b097a8", "owner": "70324@Z01", "id": 4385211}, {"isfamily": 0, "title": "", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "60dab2b207", "owner": "70324@Z01", "id": 4417798}, {"isfamily": 0, "title": "", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "b0736a4f93", "owner": "70324@Z01", "id": 4506646}, {"isfamily": 0, "title": "red_8_", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "37ed830d19", "owner": "80155@Z01", "id": 4467539}, {"isfamily": 0, "title": "outsider", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "1efdd74b9d", "owner": "79130@Z01", "id": 4464182}, {"isfamily": 0, "title": "", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "5ca2cc626b", "owner": "79130@Z01", "id": 4464241}, {"isfamily": 0, "title": "Fossils", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "e93100fc29", "owner": "79130@Z01", "id": 4464187}, {"isfamily": 0, "title": "Mobile Photo", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "51267937e4", "owner": "2@Z01", "id": 4452864}, {"isfamily": 0, "title": "Holding On", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "d9231e0dfb", "owner": "30634@Z01", "id": 4453618}, {"isfamily": 0, "title": "Reflect", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "cd6d3dd603", "owner": "30634@Z01", "id": 4450186}, {"isfamily": 0, "title": "Making a Point", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "d7e5f9d235", "owner": "30634@Z01", "id": 4453619}, {"isfamily": 0, "title": "Coco in a daze.", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "e1f43407db", "owner": "78732@Z01", "id": 4361720}, {"isfamily": 0, "title": "perugia 167", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "acea65242a", "owner": "61623@Z01", "id": 4447765}], "total": 611, "perpage": 100, "pages": 7, "page": 1}, "stat": "ok"}