refdomains_by_type - Ahrefs API

Documentation - refdomains_by_type

Contains the referring domains that contain backlinks to the target.

Each request to refdomains_by_type costs 10 rows.
Each result in the response costs 1 row.
Using 'where' costs 10 rows.
Using 'having' costs 10 rows.

• refdomains

Column Type Where Having Description
url string + − Target of the request.
ip string + − IP address of the referring domain that links to the target.
refdomain string + + The referring domain that contains at least one link to the target.
all bool + − Set to true for referring domains that contain at least one backlink to the target.
text bool + − Set to true for referring domains that contain at least one text backlink to the target.
image bool + − Set to true for referring domains that contain at least one image backlink to the target.
nofollow bool + − Set to true for referring domains that contain at least one nofollow backlink to the target.
dofollow bool + − Set to true for referring domains that contain at least one dofollow backlink to the target.
redirect bool + − Set to true for referring domains that contain at least one redirect backlink to the target.
canonical bool + − Set to true for referring domains that contain at least one canonical backlink to the target.
gov bool + − Set to true for referring domains that contain at least one backlink to the target from a governmental refdomain.
edu bool + − Set to true for referring domains that contain at least one backlink to the target from an educational refdomain.
backlinks int + + Number of backlinks found in the referring domain that link to the target.
backlinks_dofollow int + + Number of dofollow backlinks found in the referring domain that link to the target.
refpages int + + Number of referring pages found in the referring domain that link to the target.
first_seen date + + Least recent date when the Ahrefs crawler was able to visit the backlinks in the referring domain.
last_visited date + + Most recent date when the Ahrefs crawler was able to visit the backlinks in the referring domain.
domain_rating int − + Domain Rating of the referring domain.

• stats

Column Type Where Having Description
refdomains int − − Total number of referring domains that contain at least one link to the target.
ips int − − Total number of IP addresses that link to the target.
class_c int − − Total number of referring class C networks that link to the target.
max_backlinks int − − Maximum number of backlinks that link to the target, among all of the targets.
max_refpages int − − Maximum number of refpages that link to the target, among all of the targets.
total_backlinks int − − Total number of backlinks that link to the target, among all of the targets.
total_backlinks_dofollow int − − Total number of dofollow backlinks that link to the target, among all of the targets.
all int − − Total amount of referring domains that contain at least one backlink to the target.
text int − − Total amount of referring domains that contain at least one text backlink to the target.
image int − − Total amount of referring domains that contain at least one image backlink to the target.
nofollow int − − Total amount of referring domains that contain at least one nofollow backlink to the target.
dofollow int − − Total amount of referring domains that contain at least one dofollow backlink to the target.
redirect int − − Total amount of referring domains that contain at least one redirect backlink to the target.
canonical int − − Total amount of referring domains that contain at least one canonical backlink to the target.
gov int − − Total amount of referring domains that contain at least one backlink to the target from a governmental refdomain.
edu int − − Total amount of referring domains that contain at least one backlink to the target from an educational refdomain.

• tlds

Column Type Where Having Description
tld string − − Top-level domain name for which TLD statistics are provided.
count int − − Total amount of referring domains under the given TLD.

Examples

xml json

Request

https://apiv2.ahrefs.com?from=refdomains_by_type&target=ahrefs.com&mode=domain&limit=3&where=gov%3Dtrue&output=json

Response

{
  "refdomains":[
    {
      "refdomain":"anbg.gov.au",
      "refdomain_top":"anbg.gov.au",
      "backlinks":16,
      "backlinks_dofollow":8,
      "refpages":14,
      "first_seen":"2013-05-03T17:34:57Z",
      "last_visited":"2013-05-03T17:37:25Z",
      "domain_rating":64
    },
    {
      "refdomain":"bhgtj.gov.cn",
      "refdomain_top":"bhgtj.gov.cn",
      "backlinks":1,
      "backlinks_dofollow":0,
      "refpages":1,
      "first_seen":"2014-07-01T13:41:03Z",
      "last_visited":"2014-07-01T13:41:03Z",
      "domain_rating":46
    },
    {
      "refdomain":"bjfsh.gov.cn",
      "refdomain_top":"bjfsh.gov.cn",
      "backlinks":4,
      "backlinks_dofollow":1,
      "refpages":4,
      "first_seen":"2013-05-08T01:13:29Z",
      "last_visited":"2013-05-08T01:24:43Z",
      "domain_rating":61
    }
  ],
  "stats":{
    "refdomains":5,
    "ips":5960,
    "class_c":4293,
    "max_backlinks":16,
    "max_refpages":14,
    "total_backlinks":21,
    "total_backlinks_dofollow":9,
    "all":6502,
    "text":6127,
    "image":231,
    "nofollow":1927,
    "dofollow":4515,
    "redirect":220,
    "canonical":0,
    "gov":5,
    "edu":70
  },
  "tlds":[
    {
      "tld":"cn",
      "count":2
    },
    {
      "tld":"au",
      "count":1
    },
    {
      "tld":"ph",
      "count":1
    },
    {
      "tld":"vn",
      "count":1
    }
  ]
}




Ahrefs Academy Video courses to upgrade your marketing workflows with Ahrefs tools & data
ahrefs academy Start course
Help center Suggest a feature Chat with us