About ahrefs API

Use Our Database

API makes it possible to use data from our index in your applications. API developing will still be in process in accordance with your suggestions.

If you feel that API lacks some functions needed for reaching your goal - contact us through support@ahrefs.com,
describing your need, and if only this is possible, we are sure to add such features to our API.

You are not allowed to white label our data without our agreement.
You are not allowed to white label our rating. If you show our rating to the third-party, you cannot change its name.

Your users should know that backlinks info is provided by ahrefs.com

If you want to show our data to the third-party, don't start integration without conditioning the rules of usage with us.

API Units

Each API function has its price, it is estimated in API Units and depends on the average limits of computer powers for this command processing.

Subscription plans, apart from other features, contain additional API Units, which will be enough for personal usage.
API units can be accumulated - if you hadn't used something during the previous month, you will able to use remaining units next month.

Near each function we've indicated the amount of API Units it requires.
In future prices for API Units may be changed.

Ask Anytime

If you need large volumes, say thousands or even millions of requests per day - you may buy API Units in necessary amounts.

For this contact us through support@ahrefs.com.

ChangeLog

Short description of API additions.
Version 1.0 on 22 Dec '2011 ›

What you can do now:

Access API with your personal AhrefsKey
— it's available only for registered users.

Buy API Units. Current price: 1$ for 100 Units

Parameters used in API functions:

target= aim of our request, this may be domain, directory or URL;
e.g.: http://ahrefs.com, ahrefs.com, http://ahrefs.com/api/, ahrefs.com/api/ , api.ahrefs.com.

mode= can acquire the following meanings: exact, domain, subdomains and prefix.
By parameters target and mode we determine our analysis aim.
How these parameters are interpreted you may see in a table below:

URL	exact	domain	subdomains	prefix
ahrefs.com/api/	ahrefs.com/api/	ahrefs.com/*	ahrefs.com/	ahrefs.com/api/*
api.ahrefs.com	api.ahrefs.com/	api.ahrefs.com/*	api.ahrefs.com/	api.ahrefs.com/*

count= how many results should be returned
offset= starting from what position results should be returned.
Value of offset parameter cannot be more than 100'000
output= format of returning results. Available variants: xml, json, php.
date= from which date results should be returned.

API enables you:

to get total count of backlinks for a domain, directory or URL
to get total count of backlinks with types details for a domain, directory or URL
to get total count of referring domains, IPs, class C subnets, .gov and .edu domains for a domain, directory or URL
to get referring pages (backlinks) for the indicated domain, directory or URL
to get crawled pages for a domain or in a directory

to get the list of referring domains for a domain, directory or URL
to get the list of anchors for a domain, directory or URL
to get the number of backlinks with specified anchor on URL
to get the number of API Units left

1. To get total count of backlinks for a domain, directory or URL

Per request cost: 0.1 API units

Query example:

http://api.ahrefs.com/get_backlinks_count.php?target=ahrefs.com&mode=domain&output=json&AhrefsKey={Your Ahrefs Key}

Mandatory parameters: AhrefsKey, target, mode, output

Example of an answer›

{ "Result" : { "Backlinks" : 7474,
      "RefPages" : 7449
    } }

2. To get total count of backlinks with types details for a domain, directory or URL

Per request cost: 0.2 API units

Query example:

http://api.ahrefs.com/get_backlinks_count_ext.php?target=ahrefs.com&mode=domain&output=json&AhrefsKey={Your Ahrefs Key}

Mandatory parameters: AhrefsKey, target, mode, output

Example of an answer ›

{ "Result" : { "Backlinks" : 7385,
      "Edu" : 0,
      "Form" : 0,
      "Frame" : 0,
      "Gov" : 0,
      "Image" : 7057,
      "NoFollow" : 56,
      "Pages" : 936,
      "Redirect" : 3,
      "RefPages" : 7364
    } }

3. To get total count of referring domains, IPs, class C subnets, .gov and .edu domains for a domain, directory or URL

Per request cost: 1 API units

Query example:

http://api.ahrefs.com/get_ref_domains_ips_count.php?target=ahrefs.com&mode=domain&output=json&AhrefsKey={Your Ahrefs Key}

Mandatory parameters: AhrefsKey, target, mode, output

Example of an answer ›

{ "Result" : { "ClassC" : 83,
      "Domains" : 93,
      "Edu" : 0,
      "Gov" : 0,
      "Ips" : 85
    } }

4. To get referring pages (backlinks) for the indicated domain, directory or URL

Per item cost: 0.01 API units The total request cost is: per item cost * number of items but not less then 1 API Unit.

Query example:

http://api.ahrefs.com/get_backlinks.php?target=ahrefs.com&count=4&mode=domain&output=json&AhrefsKey={Your Ahrefs Key}

Mandatory parameters: AhrefsKey, target, mode, output, count
Optional parameter: offset

Example of an answer ›

{ "Result" : [ { "IpFrom" : "91.144.248.195",
        "Links" : [ { "Anchor" : "http://ahrefs.com/",
              "Flag" : [  ],
              "Type" : "Text",
              "UrlTo" : "http://ahrefs.com/"
            } ],
        "Rating" : 42.617322999999999,
        "Title" : "",
        "UrlFrom" : "http://www.danalight.dk/",
        "Visited" : 1323533909
      },
      { "IpFrom" : "91.144.248.195",
        "Links" : [ { "Anchor" : "http://ahrefs.com/",
              "Flag" : [  ],
              "Type" : "Text",
              "UrlTo" : "http://ahrefs.com/"
            } ],
        "Rating" : 37.321091000000003,
        "Title" : "",
        "UrlFrom" : "http://loftfashion.dk/?lang=en",
        "Visited" : 1323528537
      },
      { "IpFrom" : "69.163.155.111",
        "Links" : [ { "Anchor" : "http://ahrefs.com/robot/",
              "Flag" : [ "nf" ],
              "Type" : "Text",
              "UrlTo" : "http://ahrefs.com/robot/"
            } ],
        "Rating" : 12.554166,
        "Title" : "What's  My User  Agent?",
        "UrlFrom" : "http://whatsmyua.com/",
        "Visited" : 1324523505
      },
      { "IpFrom" : "91.144.248.195",
        "Links" : [ { "Anchor" : "http://ahrefs.com/",
              "Flag" : [  ],
              "Type" : "Text",
              "UrlTo" : "http://ahrefs.com/"
            } ],
        "Rating" : 9.1883909999999993,
        "Title" : "",
        "UrlFrom" : "http://www.cubcadet.dk/",
        "Visited" : 1324216542
      }
    ] }

5. To get crawled pages for a domain or in a directory

Per item cost: 0.01 API units The total request cost is: per item cost * number of items but not less then 1 API Unit.

Query example:

http://api.ahrefs.com/get_pages.php?target=ahrefs.com&count=4&mode=domain&output=json&AhrefsKey={Your Ahrefs Key}

Mandatory parameters: AhrefsKey, target, mode, output, count
Optional parameter: offset

Example of an answer ›

{ "Result" : [ { "HttpCode" : 200,
        "LinksExternal" : 2,
        "LinksInternal" : 20,
        "Rating" : 653.22931900000003,
        "Size" : 8550,
        "Title" : "Ahrefs  - Backlinks & SERPs Research  Tool",
        "Url" : "http://ahrefs.com/",
        "Visited" : 1324527835
      },
      { "HttpCode" : 200,
        "LinksExternal" : 2,
        "LinksInternal" : 19,
        "Rating" : 108.169044,
        "Size" : 5176,
        "Title" : "www.newsru.com/  backlinks report - Ahrefs  ",
        "Url" : "http://ahrefs.com/site-explorer/exact/www.newsru.com",
        "Visited" : 1324163855
      },
      { "HttpCode" : 302,
        "LinksExternal" : 0,
        "LinksInternal" : 1,
        "Rating" : 95.064715000000007,
        "Redirect" : "http://ahrefs.com/serps/positions/",
        "Size" : 20,
        "Title" : "",
        "Url" : "http://ahrefs.com/serps/",
        "Visited" : 1324468202
      },
      { "HttpCode" : 200,
        "LinksExternal" : 2,
        "LinksInternal" : 30,
        "Rating" : 93.388529000000005,
        "Size" : 2526,
        "Title" : "News  - Ahrefs",
        "Url" : "http://ahrefs.com/news/",
        "Visited" : 1324526088
      }
    ] }

6. To get the list of referring domains for a domain, directory or URL

Per item cost: 0.05 API units The total request cost is: per item cost * number of items but not less then 1 API Unit.

Query example:

http://api.ahrefs.com/get_ref_domains.php?target=ahrefs.com&count=4&mode=domain&output=json&AhrefsKey={Your Ahrefs Key}

Mandatory parameters: AhrefsKey, target, mode, output, count
Optional parameter: offset

Example of an answer ›

{ "Result" : [ { "Backlinks" : 1,
        "Domain" : "webrankinfo.com",
        "Rating" : 15580341.7915,
        "RefPages" : 1
      },
      { "Backlinks" : 1,
        "Domain" : "wikimedia.org",
        "Rating" : 1078603.6710099999,
        "RefPages" : 1
      },
      { "Backlinks" : 1,
        "Domain" : "habrahabr.ru",
        "Rating" : 712507.59948500001,
        "RefPages" : 1
      },
      { "Backlinks" : 1,
        "Domain" : "surfandbiz.com",
        "Rating" : 455502.14677799999,
        "RefPages" : 1
      }
    ] }

7. To get the list of anchors for a domain, directory or URL

Per item cost: 0.1 API units The total request cost is: per item cost * number of items but not less then 5 API Units.

Query example:

http://api.ahrefs.com/get_anchors_of_backlinks.php?target=ahrefs.com&count=4&mode=domain&output=json&AhrefsKey={Your Ahrefs Key}

Mandatory parameters: AhrefsKey, target, mode, output, count
Optional parameter: offset

Example of an answer ›

{ "Result" : [ { "Backlinks" : 7056,
        "RefPages" : 7056,
        "Text" : ""
      },
      { "Backlinks" : 125,
        "RefPages" : 125,
        "Text" : "here"
      },
      { "Backlinks" : 47,
        "RefPages" : 47,
        "Text" : "ahrefs"
      },
      { "Backlinks" : 44,
        "RefPages" : 44,
        "Text" : "http://ahrefs.com/"
      }
    ] }

8. To get the number of backlinks with specified anchor on domain, directory or URL

Per request cost: 0.5 API units

Query example:

http://api.ahrefs.com/get_backlinks_count_with_anchor.php?target=ahrefs.com&output=json&mode=domain&anchor=ahrefs&AhrefsKey={Your Ahrefs Key}

Mandatory parameters: AhrefsKey, target, mode, output, count, anchor

Example of an answer ›

{ "Result" : { "Backlinks" : 47,
      "RefPages" : 47
    } }

9. To get the number of API Units left

Per request cost: 0.01 API units

Query example:

http://api.ahrefs.com/get_units_left.php?output=json&AhrefsKey={Your Ahrefs Key}

Mandatory parameters: AhrefsKey, output

Example of an answer ›

{ "apiresponse" : { "api_units_left" : 19253.130000000001 } }

About ahrefs API

Use Our Database

API Units

Ask Anytime

ChangeLog

Version 1.1 — API Prices changed
6 Mar '2012

Version 1.0 — Completely revised & extended API
22 Dec '2011

Version 0.4 – more information in results
06 Sep '11

Version 0.3 – Requests with `type=inlinks` or `type=pages` cost less if result set is empty.
01 Aug '2011

Version 0.2 – API resource consumption calculation in API Units is added.
28 Jul '2011

Version 0.1 – Two new functions:
15 Jul '2011

What you can do now:

Buy API Units. Current price: 1$ for 100 Units

Parameters used in API functions:

API enables you:

1. To get total count of backlinks for a domain, directory or URL

2. To get total count of backlinks with types details for a domain, directory or URL

3. To get total count of referring domains, IPs, class C subnets, .gov and .edu domains for a domain, directory or URL

4. To get referring pages (backlinks) for the indicated domain, directory or URL

5. To get crawled pages for a domain or in a directory

6. To get the list of referring domains for a domain, directory or URL

7. To get the list of anchors for a domain, directory or URL

8. To get the number of backlinks with specified anchor on domain, directory or URL

9. To get the number of API Units left

About ahrefs API

Use Our Database

API Units

Ask Anytime

ChangeLog

Version 1.1 — API Prices changed 6 Mar '2012

Version 1.0 — Completely revised & extended API 22 Dec '2011

Version 0.4 – more information in results 06 Sep '11

Version 0.3 – Requests with type=inlinks or type=pages cost less if result set is empty. 01 Aug '2011

Version 0.2 – API resource consumption calculation in API Units is added. 28 Jul '2011

Version 0.1 – Two new functions: 15 Jul '2011

What you can do now:

Buy API Units. Current price: 1$ for 100 Units

Parameters used in API functions:

API enables you:

1. To get total count of backlinks for a domain, directory or URL

2. To get total count of backlinks with types details for a domain, directory or URL

3. To get total count of referring domains, IPs, class C subnets, .gov and .edu domains for a domain, directory or URL

4. To get referring pages (backlinks) for the indicated domain, directory or URL

5. To get crawled pages for a domain or in a directory

6. To get the list of referring domains for a domain, directory or URL

7. To get the list of anchors for a domain, directory or URL

8. To get the number of backlinks with specified anchor on domain, directory or URL

9. To get the number of API Units left

Version 1.1 — API Prices changed
6 Mar '2012

Version 1.0 — Completely revised & extended API
22 Dec '2011

Version 0.4 – more information in results
06 Sep '11

Version 0.3 – Requests with `type=inlinks` or `type=pages` cost less if result set is empty.
01 Aug '2011

Version 0.2 – API resource consumption calculation in API Units is added.
28 Jul '2011

Version 0.1 – Two new functions:
15 Jul '2011