RAhrefs (version 0.1.4)

rah_backlinks_new_lost_counters: Export new and lost backlink totals.

Description

Export new and lost backlink totals.

Usage

rah_backlinks_new_lost_counters(target,
  token = Sys.getenv("AHREFS_AUTH_TOKEN"), mode = "domain",
  metrics = NULL, limit = 1000, order_by = NULL, where = NULL,
  having = NULL)

Arguments

target

character string. Aim of a request: a domain, a directory or a URL

token

character string. Authentication token. Should be available through enviromental variables after authentication with function rah_auth()

mode

character string. Mode of operation: exact, domain, subdomains or prefix. See more in Details section

metrics

character vector of columns to select. See more in Details section

limit

integer. Number of results to return

order_by

character vector of columns to sort on. See more in Details section

where

character string - a condition created by rah_condition_set() function that generates proper "where" condition to satisfy. See more in Details section

having

character string - a condition created by rah_condition_set() function that generates proper "having" condition to satisfy. See more in Details section

Value

data frame

Details

1. available metrics - you can select which columns (metrics) you want to download and which one would be useful in filtering, BUT not all of them can always be used in "where" & "having" conditions:

Column	Type	Where	Having	Description
date	date	+	+	Date the backlink was tagged as New or Lost
type	string	+	-	Indicates whether the backlink is New or Lost.
ahrefs_rank	int	+	-	URL Rating of the referring page.
domain_rating	int	+	-	Domain Rating of the referring domain.
url_from	string	+	-	URL of the page where the backlink is found
url_to	string	+	+	URL of the page the backlink is pointing to.
links_internal	int	+	-	Number of internal links found in the referring page.
links_external	int	+	-	Number of external links found in the referring page.
encoding	string	+	-	Character encoding of the referring page, for example "utf8" or "iso-8859-1" (Latin-1).
http_code	int	+	-	HTTP code that was last returned for the referring page.
title	string	+	-	Title of the referring page.
origin	string	+	-	Either "fresh", "drop", or "recrawl".
first_seen	date	+	-	Least recent date when the Ahrefs crawler was able to visit the backlink.
last_visited	date	+	-	Most recent date when the Ahrefs crawler was able to visit the backlink.
prev_visited	date	+	-	Second to most recent date when the Ahrefs crawler was able to visit the backlink.
original	boolean	+	-	Indicates whether the backlink was present on the referring page when the Ahrefs crawler first visited it.
link_type	string	+	-	Either "href", "redirect", "frame", "form", "canonical", "rss", or "alternate".
redirect	int	+	-	For redirected links, the Redirect Code (3XX), zero otherwise.
nofollow	boolean	+	-	Indicates whether the backlink is NoFollow.
alt	string	+	-	Alternative text of the image backlink, if exists.
anchor	string	+	-	Anchor text of the backlink.
text_pre	string	+	-	Snippet before the anchor text.
text_post	string	+	-	Snippet after the anchor text.
new	int	-	+	Total number of new backlinks found to this url.
lost	int	-	+	Total number of backlinks removed to this url.
new_total	int	-	+	Total number of new backlinks found to this url when ignoring where filter.

2. "mode" parameter can take 4 different values that will affect how the results will be grouped.

Example of URL directory with folder:

• Example URL: ahrefs.com/api/

• exact: ahrefs.com/api/

• domain: ahrefs.com/*

• subdomains: *ahrefs.com/*

• prefix: ahrefs.com/api/*

Example of URL directory with subdomain:

• Example URL: apiv2.ahrefs.com

• exact: apiv2.ahrefs.com/

• domain: apiv2.ahrefs.com/*

• subdomains: *apiv2.ahrefs.com/*

• prefix: apiv2.ahrefs.com/*

3. "order_by" parameter is a character string that forces sorting of the results. Structure:

• Structure: "column_name:asc|desc"

• Single column example: "first_seen:asc" ~ this sorts results by first_seen column in ascending order

• Multi column example: "last_seen:desc,first_seen:asc" ~ this sorts results by 1) last_seen column in descending order, and next by 2) first_seen column in ascending order

4. "where" & "having" are EXPERIMENTAL parameters of condition sets (character strings) that control filtering the results. To create arguments:

1. use rah_condition() function to create a single condition, for example: cond_1 <- rah_condition(column_name = "links", operator = "GREATER_THAN", value = "10")

2. use rah_condition_set() function to group single conditions into final condition string, for example: fin_cond <- rah_condition_set(cond_1, cond_2)

3. provide final condition to proper report function as a parameter, for example: RAhrefs::rah_backlinks_new_lost_counters(target = "ahrefs.com", token = "0123456789", mode = "domain", metrics = NULL, limit = 1000, where = fin_cond, order_by = "first_seen:asc")

See Also

Other Ahrefs reports: rah_ahrefs_rank, rah_anchors_refdomains, rah_anchors, rah_backlinks_new_lost, rah_backlinks_one_per_domain, rah_backlinks, rah_broken_backlinks, rah_broken_links, rah_domain_rating, rah_linked_anchors, rah_linked_domains_by_type, rah_linked_domains, rah_metrics_extended, rah_metrics, rah_pages_extended, rah_pages_info, rah_pages, rah_refdomains_by_type, rah_refdomains_new_lost_counters, rah_refdomains_new_lost, rah_refdomains, rah_refips, rah_subscription_info

Examples

# NOT RUN {
# creating single conditions for 'where' parameter
# let's see anchors of all backlinks detected in 2018
cond_1 <- RAhrefs::rah_condition(
   column_name = "links_internal",
   operator    = "GREATER_OR_EQUAL",
   value       = "5")

cond_2 <- RAhrefs::rah_condition(
   column_name = "links_external",
   operator    = "LESS_OR_EQUAL",
   value       = "5")

# joining conditions into one condition set
cond_where <- RAhrefs::rah_condition_set(cond_1, cond_2)

# downloading
b <- RAhrefs::rah_backlinks_new_lost_counters(
  target   = "ahrefs.com",
  limit    = 2,
  where    = cond_where,
  order_by = "links_external:desc")
# }