zooomr.photos.search

Return a list of photos matching some criteria. Only photos visible to the calling user will be returned. To return private or semi-private photos, the caller must be authenticated with 'read' permissions, and have permission to view the photos. Unauthenticated calls will only return public photos.

Authentication

This method does not require authentication.

Arguments

api_key (Required)

Your API application key.

query (Required)

Either a username or a comma separated list of tags. Special tags also exist such as "license:cc=by" to get CC images requiring attribution, the by refers to the codes you can see if you look at the links from the different licenses here: http://creativecommons.org/about/licenses/meet-the-licenses

user_id (Optional)

The user id (nsid) you want to search the photos for

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)

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

Example Response

 {"photos": {"photo": [{"isfamily": 0, "title": "Me", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "4d8ddb762e", "owner": "13205@Z01", "id": 2405506}, {"isfamily": 0, "title": "Birthday Cake", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "03976bda65", "owner": "13205@Z01", "id": 2405362}, {"isfamily": 0, "title": "30boxes t-shirt", "isfriend": 0, "ispublic": 1, "server": 0, "farm": 1, "secret": "c18a40fb5b", "owner": "13205@Z01", "id": 890013}], "total": 3, "perpage": 100, "pages": 1, "page": 1}, "stat": "ok", "extras": {}}