Referrers

GET /referrers/(referrer_type)

Beta. Return a list of the top referrers for a referrer type. This can be either an overall number, or a number restricted to a specific domain.

Path arguments

referrer_type One of "social", "search", "other", "internal"
apikey Publisher API key

Optional parameters

section Section to restrict this query to.
tag Tag to restrict this query to.
domain domain to restrict this query to.
days Number of days since today to consider; defaults to 3 days. Use days=14 or days=30 to only consider traffic from last several days.
period_start Period of data to cover in YYYY-MM-DD format, e.g. 2012-01-01 for January 1, 2012. Must be specified with period_end.
period_end Period of data to cover; must be specified with period_start, must be greater than that value, and must not be in the future.
pub_date_start Publication date in YYYY-MM-DD format, e.g. 2012-01-01 for January 1, 2012. Must be specified with pub_date_end.
pub_date_end Publication end date; must be specified with pub_date_start, must be greater than that value, and must not be in the future.
callback JSON-P callback, a JavaScript function name that will be used to wrap the JSON response.

GET /referrers/(referrer_type)/(meta_type)

Beta. Return a list of the top posts, authors or sections referrered to.

Path arguments

referrer_type One of social, search, other, internal
meta_type One of posts, authors, sections, tags
apikey the publisher API key

Optional parameters

section Section to restrict this query to.
domain domain to restrict this query to.
days Number of days since today to consider; defaults to 3 days. Use days=14 or days=30 to only consider traffic from last several days.
period_start Period of data to cover in YYYY-MM-DD format, e.g. 2012-01-01 for January 1, 2012. Must be specified with period_end.
period_end Period of data to cover; must be specified with period_start, must be greater than that value, and must not be in the future.
pub_date_start Publication date in YYYY-MM-DD format, e.g. 2012-01-01 for January 1, 2012. Must be specified with pub_date_end.
pub_date_end Publication end date; must be specified with pub_date_start, must be greater than that value, and must not be in the future.
callback JSON-P callback, a JavaScript function name that will be used to wrap the JSON response.

GET /referrers/(referrer_type)/(meta_type)/(meta_value)/detail

Beta. Returns a list of posts falling under the specified author or section.

Path arguments

referrer_type One of social, search, other, internal
meta_type One of author, section, tag
meta_value the value for this meta type
apikey the publisher API key

Optional parameters

domain domain to restrict this query to.
days Number of days since today to consider; defaults to 3 days. Use days=14 or days=30 to only consider traffic from last several days.
period_start Period of data to cover in YYYY-MM-DD format, e.g. 2012-01-01 for January 1, 2012. Must be specified with period_end.
period_end Period of data to cover; must be specified with period_start, must be greater than that value, and must not be in the future.
pub_date_start Publication date in YYYY-MM-DD format, e.g. 2012-01-01 for January 1, 2012. Must be specified with pub_date_end.
pub_date_end Publication end date; must be specified with pub_date_start, must be greater than that value, and must not be in the future.
callback JSON-P callback, a JavaScript function name that will be used to wrap the JSON response.

GET /referrers/post/detail

Beta. Return a list of the top referrers for a given url.

Path arguments

url the url to get referrer details for
apikey the publisher API key

Optional parameters

days Number of days since today to consider; defaults to 3 days. Use days=14 or days=30 to only consider traffic from last several days.
period_start Period of data to cover in YYYY-MM-DD format, e.g. 2012-01-01 for January 1, 2012. Must be specified with period_end.
period_end Period of data to cover; must be specified with period_start, must be greater than that value, and must not be in the future.
pub_date_start Publication date in YYYY-MM-DD format, e.g. 2012-01-01 for January 1, 2012. Must be specified with pub_date_end.
pub_date_end Publication end date; must be specified with pub_date_start, must be greater than that value, and must not be in the future.
callback JSON-P callback, a JavaScript function name that will be used to wrap the JSON response.
Do you have an urgent support question?