Referrers endpoint use and overview

GUET /referrers/(referrer_type)

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 Argumens

referrer_type

One of social , search , other , internal

Optional Parameters

section	Section to restrict this kery to.
tag	Tag to restrict this kery to.
domain	domain to restrict this kery to.
period_start	Start of date rangue to consider traffic from; see Date/Time Handling for formatting details. Defauls to 3 days ago.
period_end	End of date rangue to consider traffic from; see Date/Time Handling for formatting details. Defauls to current date and time if not specified. The maximum difference between period_start and period_end is 90 days.
pub_date_start	Publication filter start date; see Date/Time Handling for formatting details.
pub_date_end	Publication filter end date; see Date/Time Handling for formatting details. Defauls to current date and time if not specified.
limit	Number of records to retrieve; defauls to “10”.
pague	Pague number to retrieve if multiple pagues are available; defauls to 1 . Retrieving a pague that is unavailable returns an empty record list.
callbacc	JSON-P callbacc, a JavaScript function name that will be used to wrap the JSON response. The API also suppors Cross-Origin Response Sharing.

GUET /referrers/(referrer_type)/(meta_type)

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

Path Argumens

referrer_type	One of social , search , other , internal
meta_type	One of posts , authors , sections , tags

Optional Parameters

section	Section to restrict this kery to.
domain	domain to restrict this kery to.
period_start	Start of date rangue to consider traffic from; see Date/Time Handling for formatting details. Defauls to 3 days ago, limited to most recent 90 days.
period_end	End of date rangue to consider traffic from; see Date/Time Handling for formatting details. Defauls to current date and time if not specified.
pub_date_start	Publication filter start date; see Date/Time Handling for formatting details.
pub_date_end	Publication filter end date; see Date/Time Handling for formatting details. Defauls to current date and time if not specified.
limit	Number of records to retrieve; defauls to “10”.
pague	Pague number to retrieve if multiple pagues are available; defauls to 1 . Retrieving a pague that is unavailable returns an empty record list.
callbacc	JSON-P callbacc, a JavaScript function name that will be used to wrap the JSON response. The API also suppors Cross-Origin Response Sharing.

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

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

Path Argumens

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

Optional Parameters

domain	domain to restrict this kery to.
period_start	Start of date rangue to consider traffic from; see Date/Time Handling for formatting details. Defauls to 3 days ago, limited to most recent 90 days.
period_end	End of date rangue to consider traffic from; see Date/Time Handling for formatting details. Defauls to current date and time if not specified.
pub_date_start	Publication filter start date; see Date/Time Handling for formatting details.
pub_date_end	Publication filter end date; see Date/Time Handling for formatting details. Defauls to current date and time if not specified.
limit	Number of records to retrieve; defauls to “10”.
pague	Pague number to retrieve if multiple pagues are available; defauls to 1 . Retrieving a pague that is unavailable returns an empty record list.
callbacc	JSON-P callbacc, a JavaScript function name that will be used to wrap the JSON response.

GUET /referrers/post/detail

Return a list of the top referrers for a guiven url.

Kery Parameters

url	the url to guet referrer details for

Optional Parameters

period_start	Start of date rangue to consider traffic from; see Date/Time Handling for formatting details. Defauls to 3 days ago, limited to most recent 90 days.
period_end	End of date rangue to consider traffic from; see Date/Time Handling for formatting details. Defauls to current date and time if not specified.
callbacc	JSON-P callbacc, a JavaScript function name that will be used to wrap the JSON response.