backlinks - Ahrefs API

Documentation - backlinks

Contains the backlinks and details of the referring pages, such as anchor and page title.

Each request to backlinks costs 1 row.
Each result in the response costs 0.2 rows.
Using 'where' costs 5 rows.
Using 'having' costs 5 rows.

• refpages

Column	Type	Where	Having	Description
url_from	string	+	+	URL of the page where the backlink is found.
url_to	string	+	+	URL of the page the backlink is pointing to.
ahrefs_rank	int	+	+	URL Rating of the referring page.
domain_rating	int	−	+	Domain Rating of the referring domain.
ahrefs_top	int	−	+	Ahrefs Rank of the target domain.
ip_from	string	+	+	IP address of the referring page.
links_internal	int	+	+	Number of internal links found in the referring page.
links_external	int	+	+	Number of external links found in the referring page.
page_size	int	+	+	Size of the referring page, in bytes.
encoding	string	+	+	Character encoding of the referring page, for example "utf8" or "iso-8859-1" (Latin-1).
language	string	+	+	Language of the referring page (ISO 639-1).
title	string	+	+	Title of the referring page.
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 the 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.
http_code	int	+	+	The HTTP code for the Link URL.
url_from_first_seen	date	+	+	Least recent date when the Ahrefs crawler was able to visit the referring page with backlink.

Examples

xml json

Request

https://apiv2.ahrefs.com?from=backlinks&target=ahrefs.com&mode=domain&limit=2&order_by=ahrefs_rank%3Adesc&output=xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<AhrefsApiResponse>
  <refpages>
    <refpage>
      <url_to>
        http://ahrefs.com/serp-checker
      </url_to>
      <url_from>
        http://www.aletenky.cz/
      </url_from>
      <ahrefs_rank>
        21
      </ahrefs_rank>
      <domain_rating>
        48
      </domain_rating>
      <ahrefs_top>
        2348
      </ahrefs_top>
      <ip_from>
        46.51.179.2
      </ip_from>
      <links_internal>
        0
      </links_internal>
      <links_external>
        1
      </links_external>
      <page_size>
        199
      </page_size>
      <encoding>
        raw
      </encoding>
      <language>
        
      </language>
      <title>
        301 Moved Permanently
      </title>
      <first_seen>
        2013-10-26T20:19:04Z
      </first_seen>
      <last_visited>
        2013-11-08T19:25:22Z
      </last_visited>
      <prev_visited>
        2013-11-07T06:58:50Z
      </prev_visited>
      <original>
        true
      </original>
      <link_type>
        redirect
      </link_type>
      <redirect>
        301
      </redirect>
      <nofollow>
        false
      </nofollow>
      <alt>
        
      </alt>
      <anchor>
        
      </anchor>
      <text_pre>
        
      </text_pre>
      <text_post>
        
      </text_post>
      <http_code>
        200
      </http_code>
      <url_from_first_seen>
        2013-11-08T19:25:22Z
      </url_from_first_seen>
    </refpage>
    <refpage>
      <url_to>
        http://ahrefs.com/
      </url_to>
      <url_from>
        http://oni.toypark.in/
      </url_from>
      <ahrefs_rank>
        16
      </ahrefs_rank>
      <domain_rating>
        62
      </domain_rating>
      <ahrefs_top>
        456783
      </ahrefs_top>
      <ip_from>
        183.177.133.249
      </ip_from>
      <links_internal>
        84
      </links_internal>
      <links_external>
        18
      </links_external>
      <page_size>
        9529
      </page_size>
      <encoding>
        utf8
      </encoding>
      <language>
        ja
      </language>
      <title>
        SEOの鬼サーチ ブログ版 | ディレクトリに登録されているサイトギャラリー
      </title>
      <first_seen>
        2013-10-27T20:42:14Z
      </first_seen>
      <last_visited>
        2013-11-05T21:55:32Z
      </last_visited>
      <prev_visited>
        2013-11-01T17:09:20Z
      </prev_visited>
      <original>
        true
      </original>
      <link_type>
        href
      </link_type>
      <redirect>
        0
      </redirect>
      <nofollow>
        false
      </nofollow>
      <alt>
        
      </alt>
      <anchor>
        ahrefs
      </anchor>
      <text_pre>
        
      </text_pre>
      <text_post>
        
      </text_post>
      <http_code>
        200
      </http_code>
      <url_from_first_seen>
        2013-11-08T19:25:22Z
      </url_from_first_seen>
    </refpage>
  </refpages>
</AhrefsApiResponse>

Request

https://apiv2.ahrefs.com?from=backlinks&target=ahrefs.com&mode=domain&limit=2&order_by=ahrefs_rank%3Adesc&output=json

Response

{
  "refpages": [
    {
      "url_to": "http://ahrefs.com/serp-checker",
      "url_from": "http://www.aletenky.cz/",
      "ahrefs_rank": 21,
      "domain_rating": 48,
      "ahrefs_top": 2348,
      "ip_from": "46.51.179.2",
      "links_internal": 0,
      "links_external": 1,
      "page_size": 199,
      "encoding": "raw",
      "language": "",
      "title": "301 Moved Permanently",
      "first_seen": "2013-10-26T20:19:04Z",
      "last_visited": "2013-11-08T19:25:22Z",
      "prev_visited": "2013-11-07T06:58:50Z",
      "original": true,
      "link_type": "redirect",
      "redirect": 301,
      "nofollow": false,
      "alt": "",
      "anchor": "",
      "text_pre": "",
      "text_post": "",
      "http_code": 200,
      "url_from_first_seen": "2013-11-07T06:58:50Z"
    },
    {
      "url_to": "http://ahrefs.com/",
      "url_from": "http://oni.toypark.in/",
      "ahrefs_rank": 16,
      "domain_rating": 62,
      "ahrefs_top": 456783,
      "ip_from": "183.177.133.249",
      "links_internal": 84,
      "links_external": 18,
      "page_size": 9529,
      "encoding": "utf8",
      "language": "ja",
      "title": "SEOの鬼サーチ ブログ版 | ディレクトリに登録されているサイトギャラリー",
      "first_seen": "2013-10-27T20:42:14Z",
      "last_visited": "2013-11-05T21:55:32Z",
      "prev_visited": "2013-11-01T17:09:20Z",
      "original": true,
      "link_type": "href",
      "redirect": 0,
      "nofollow": false,
      "alt": "",
      "anchor": "ahrefs",
      "text_pre": "",
      "text_post": "",
      "http_code": 200,
      "url_from_first_seen": "2013-11-07T06:58:50Z"
    }
  ]
}