Return photos from the given user's photostream. Only photos visible to the calling user will be returned. This method must be authenticated; to return public photos for a user, use flickr.people.getPublicPhotos.
This method requires authentication with 'read' permission.
- Your API application key. See here for more details.
- The NSID of the user who's photos to return. A value of "me" will return the calling user's photos.
- Safe search setting:
- 1 for safe.
- 2 for moderate.
- 3 for restricted.
- Minimum upload date. Photos with an upload date greater than or equal to this value will be returned. The date should be in the form of a unix timestamp.
- Maximum upload date. Photos with an upload date less than or equal to this value will be returned. The date should be in the form of a unix timestamp.
- Minimum taken date. Photos with an taken date greater than or equal to this value will be returned. The date should be in the form of a mysql datetime.
- Maximum taken date. Photos with an taken date less than or equal to this value will be returned. The date should be in the form of a mysql datetime.
- Content Type setting:
- 1 for photos only.
- 2 for screenshots only.
- 3 for 'other' only.
- 4 for photos and screenshots.
- 5 for screenshots and 'other'.
- 6 for photos and 'other'.
- 7 for photos, screenshots, and 'other' (all).
- Return photos only matching a certain privacy level. This only applies when making an authenticated call to view photos you own. Valid values are:
- 1 public photos
- 2 private photos visible to friends
- 3 private photos visible to family
- 4 private photos visible to friends & family
- 5 completely private photos
- A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are:
- Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500.
- The page of results to return. If this argument is omitted, it defaults to 1.
This method returns the standard photo list xml:
<photos page="2" pages="89" perpage="10" total="881"> <photo id="2636" owner="47058503995@N01" secret="a123456" server="2" title="test_04" ispublic="1" isfriend="0" isfamily="0" /> <photo id="2635" owner="47058503995@N01" secret="b123456" server="2" title="test_03" ispublic="0" isfriend="1" isfamily="1" /> <photo id="2633" owner="47058503995@N01" secret="c123456" server="2" title="test_01" ispublic="1" isfriend="0" isfamily="0" /> <photo id="2610" owner="12037949754@N01" secret="d123456" server="2" title="00_tall" ispublic="1" isfriend="0" isfamily="0" /> </photos>
<photo> elements to urls, please read the url documentation.
1: Required arguments missing
2: Unknown user
- A user_id was passed which did not match a valid flickr user.
96: Invalid signature
- The passed signature was invalid.
97: Missing signature
- The call required signing but no signature was sent.
98: Login failed / Invalid auth token
- The login details or auth token passed were invalid.
99: User not logged in / Insufficient permissions
- The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100: Invalid API Key
- The API key passed was not valid or has expired.
105: Service currently unavailable
- The requested service is temporarily unavailable.
111: Format "xxx" not found
- The requested response format was not found.
112: Method "xxx" not found
- The requested method was not found.
114: Invalid SOAP envelope
- The SOAP envelope send in the request could not be parsed.
115: Invalid XML-RPC Method Call
- The XML-RPC request document could not be parsed.
116: Bad URL found
- One or more arguments contained a URL that has been used for abuse on Flickr.