flickrex

{
  "arguments": {
    "argument": [
      {
        "_content": "Your API application key. <a href=\"/services/api/misc.api_keys.html\">See here</a> for more details.",
        "name": "api_key",
        "optional": 0
      },
      {
        "_content": "Stats will be returned for this date. This should be in either be in YYYY-MM-DD or unix timestamp format.\n\nA 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.",
        "name": "date",
        "optional": "0"
      },
      {
        "_content": "The domain to return referrers for. This should be a hostname (eg: \"flickr.com\") with no protocol or pathname.",
        "name": "domain",
        "optional": "0"
      },
      {
        "_content": "Number of referrers to return per page. If this argument is omitted, it defaults to 25. The maximum allowed value is 100.",
        "name": "per_page",
        "optional": "1"
      },
      {
        "_content": "The page of results to return. If this argument is omitted, it defaults to 1.",
        "name": "page",
        "optional": "1"
      }
    ]
  },
  "errors": {
    "error": [
      {
        "_content": "The user you have requested stats has not enabled stats on their account.",
        "code": "1",
        "message": "User does not have stats"
      },
      {
        "_content": "No stats are available for the date requested. Flickr only keeps stats data for the last 28 days.",
        "code": "2",
        "message": "No stats for that date"
      },
      {
        "_content": "The date provided could not be parsed",
        "code": "3",
        "message": "Invalid date"
      },
      {
        "_content": "The domain provided is not in the expected format.",
        "code": "5",
        "message": "Invalid domain"
      },
      {
        "_content": "SSL is required to access the Flickr API.",
        "code": 95,
        "message": "SSL is required"
      },
      {
        "_content": "The passed signature was invalid.",
        "code": 96,
        "message": "Invalid signature"
      },
      {
        "_content": "The call required signing but no signature was sent.",
        "code": 97,
        "message": "Missing signature"
      },
      {
        "_content": "The login details or auth token passed were invalid.",
        "code": 98,
        "message": "Login failed / Invalid auth token"
      },
      {
        "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.",
        "code": 99,
        "message": "User not logged in / Insufficient permissions"
      },
      {
        "_content": "The API key passed was not valid or has expired.",
        "code": 100,
        "message": "Invalid API Key"
      },
      {
        "_content": "The requested service is temporarily unavailable.",
        "code": 105,
        "message": "Service currently unavailable"
      },
      {
        "_content": "The requested operation failed due to a temporary issue.",
        "code": 106,
        "message": "Write operation failed"
      },
      {
        "_content": "The requested response format was not found.",
        "code": 111,
        "message": "Format \"xxx\" not found"
      },
      {
        "_content": "The requested method was not found.",
        "code": 112,
        "message": "Method \"xxx\" not found"
      },
      {
        "_content": "The SOAP envelope send in the request could not be parsed.",
        "code": 114,
        "message": "Invalid SOAP envelope"
      },
      {
        "_content": "The XML-RPC request document could not be parsed.",
        "code": 115,
        "message": "Invalid XML-RPC Method Call"
      },
      {
        "_content": "One or more arguments contained a URL that has been used for abuse on Flickr.",
        "code": 116,
        "message": "Bad URL found"
      }
    ]
  },
  "method": {
    "description": {
      "_content": "Get a list of referrers from a given domain to a user's photostream"
    },
    "explanation": {
      "_content": "<p>There is one <code>&lt;referrer&gt;</code> element for each referring page, with attributes for the url and the number of views.</p>\n\n<p>Where the referring page is a search engine and we have identified the search term it will be given in the searchterm attribute.</p>"
    },
    "name": "flickr.stats.getPhotostreamReferrers",
    "needslogin": 1,
    "needssigning": 1,
    "requiredperms": "1",
    "response": {
      "_content": "<domain page=\"1\" perpage=\"25\" pages=\"1\" total=\"3\" name=\"flickr.com\">\n\t<referrer url=\"http://flickr.com/\" views=\"11\"/>\n\t<referrer url=\"http://flickr.com/photos/friends/\" views=\"8\"/>\n\t<referrer url=\"http://flickr.com/search/?q=stats+api\" views=\"2\" searchterm=\"stats api\"/>\n</domain>"
    }
  },
  "stat": "ok"
}