DocumentationSupportBlogApps

photos.get

Advanced Topics › Legacy REST API › 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

NameTypeDescription
subj_idint

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.

aidstring

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.

pidsarray

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.

callbackstring

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.

Updated over a year ago
Facebook © 2012 · English (US)
AboutCareersPlatform PoliciesPrivacy Policy