Get a list of referrers from a given domain to a photo


This method requires authentication with 'read' permission.


api_key (Required)
Your API application key. See here for more details.
date (Required)
domain (Required)
The domain to return referrers for. This should be a hostname (eg: "") with no protocol or pathname.
photo_id (Optional)
The id of the photo to get stats for. If not provided, stats for all photos will be returned.
per_page (Optional)
Number of referrers to return per page. If this argument is omitted, it defaults to 25. The maximum allowed value is 100.
page (Optional)

Example Response

<domain page="1" perpage="25" pages="1" total="3" name="">
  <referrer url="" views="11" />
  <referrer url="" views="8" />
  <referrer url="" views="2" searchterm="stats api" />

There is one <referrer> element for each referring page, with attributes for the url and the number of views.

Where the referring page is a search engine and we have identified the search term it will be given in the searchterm attribute.

Error Codes

1: User does not have stats
2: No stats for that date
3: Invalid date
The date provided could not be parsed
4: Photo not found
The photo id was either invalid or was for a photo not owned by the calling user.
5: Invalid domain
The domain provided is not in the expected format.
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
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

API Explorer

API Explorer : flickr.stats.getPhotoReferrers