Get a list of referring domains for a collection


This method requires authentication with 'read' permission.


api_key (Required)
Your API application key. See here for more details.
date (Required)
Stats will be returned for this date. This should be in either be in YYYY-MM-DD or unix timestamp format. A day according to Flickr Stats starts at midnight GMT for all users, and timestamps will automatically be rounded down to the start of the day.
collection_id (Optional)
The id of the collection to get stats for. If not provided, stats for all collections will be returned.
per_page (Optional)
Number of domains to return per page. If this argument is omitted, it defaults to 25. The maximum allowed value is 100.
page (Optional)
The page of results to return. If this argument is omitted, it defaults to 1.

Example Response

<domains page="1" perpage="25" pages="1" total="3">
  <domain name="" views="127" />
  <domain name="" views="122" />
  <domain name="" views="70" />

There is one <domain> element for each referring domain, with attributes for the domain name and the number of views.

For details on the referrers coming from each domain listed you can call flickr.stats.getCollectionReferrers

Error Codes

1: User does not have stats
The user you have requested stats has not enabled stats on their account.
2: No stats for that date
No stats are available for the date requested. Flickr only keeps stats data for the last 28 days.
3: Invalid date
The date provided could not be parsed
4: Collection not found
The collection id was either invalid or was for a collection not owned by the calling user.
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.stats.getCollectionDomains