Wiki

photos.get

Returns all visible photos according to the filters specified. You can use this method to find all photos that are:

Tagged with the subject specified by subj_id. For subj_id, you can pass the user's uid, event's eid, group's gid, or Page's page_id.

Contained within the album specified by aid.

Included in the list of photos specified by pids.

Any combination of these three criteria.

Parameters

Name	Type	Description
subj_id	int	Filter by photos tagged with this user. You must specify at least one of subj_id, aid or pids. The subj_id parameter has no default value, but if you pass one, it must be the user's uid (user ID), event's eid, group's gid, or Page's page_id.
aid	string	Filter by photos in this album. You must specify at least one of subj_id, aid or pids. The aid parameter has no default value. The aid cannot be longer than 50 characters.
pids	array	Filter by photos in this list. This is a comma-separated list of pids. You must specify at least one of subj_id, aid or pids. The pids parameter has no default value.
callback	string	Name of a function to call. This is primarily to enable cross-domain javascript requests using the <script> tag, sometimes known as "JSONP". This works with both XML and JSON.

Response

If no such photos are found, the method returns an empty photos_get_response element.

Note: The following size constraints on photos returned:

src - URL of photo, with max width 130px and max height 130px. May be blank.

src_big - URL of photo, with max width 604px and max height 604px. May be blank.

src_small - URL of photo, with with max width 75px and max height 225px. May be blank.

Privacy Note: Photos are visible on the Facebook Platform only if the photo owner has authorized the calling application, or the photo owner has not turned off access to the Platform.