flickr.photos.getWithGeoData

Authentication

This method requiresauthentication with 'read' permission.

Arguments

api_key (Required)

Your API application key.See here for more details.

min_upload_date (Optional)

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.

max_upload_date (Optional)

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.

min_taken_date (Optional)

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.

max_taken_date (Optional)

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.

privacy_filter (Optional)

Return photos only matching a certain privacy level. 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

sort (Optional)

The order in which to sort returned photos. Defaults to date-posted-desc. The possible values are: date-posted-asc, date-posted-desc, date-taken-asc, date-taken-desc, interestingness-desc, and interestingness-asc.

media (Optional)

Filter results by media type. Possible values areall (default),photos orvideos

extras (Optional)

A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are:description,license,date_upload,date_taken,owner_name,icon_server,original_format,last_update,geo,tags,machine_tags,o_dims,views,media,path_alias,url_sq,url_t,url_s,url_q,url_m,url_n,url_z,url_c,url_l,url_o

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

This method returns the standard photo list xml:

<photospage="2"pages="89"perpage="10"total="881"><photoid="2636"owner="47058503995@N01"secret="a123456"server="2"title="test_04"ispublic="1"isfriend="0"isfamily="0" /><photoid="2635"owner="47058503995@N01"secret="b123456"server="2"title="test_03"ispublic="0"isfriend="1"isfamily="1" /><photoid="2633"owner="47058503995@N01"secret="c123456"server="2"title="test_01"ispublic="1"isfriend="0"isfamily="0" /><photoid="2610"owner="12037949754@N01"secret="d123456"server="2"title="00_tall"ispublic="1"isfriend="0"isfamily="0" /></photos>

To map<photo> elements to urls, please read theurl documentation.

Error Codes

95: SSL is required

SSL is required to access the Flickr API.

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.

106: Write operation failed

The requested operation failed due to a temporary issue.

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.

API Explorer

API Explorer : flickr.photos.getWithGeoData