Documentation - broken_backlinks
Contains the broken backlinks and details of the referring pages, such as anchor and page title.
Each request to broken_backlinks costs 1 row.
Each result in the response costs 5 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. |
| language | string | + | + | Language of the referring page (ISO 639-1). |
| encoding | string | + | + | Character encoding of the referring page, for example "utf8" or "iso-8859-1" (Latin-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. |
| broken_at | date | + | + | The date when the Ahrefs crawler thinks the link became broken. |
| url_from_first_seen | date | + | + | Least recent date when the Ahrefs crawler was able to visit the referring page with backlink. |
| http_code | int | + | + | The HTTP code for the Link URL. |
| error | string | + | + | The string indicating the nature of error (currently only "dns"). |
Examples
Request
https://apiv2.ahrefs.com?from=broken_backlinks&target=ahrefs.com&mode=subdomains&limit=2&order_by=broken_at%3Adesc&output=json
Response
{
"refpages": [
{
"url_from":"http://articulos.bodastodo.com/destinos/20111119-201139-Donde-ir-de-luna-de-miel-en-la-Republica-Dominicana",
"ahrefs_rank":0,
"domain_rating":0,
"ahrefs_top":0,
"ip_from":"144.76.96.182",
"links_internal":0,
"links_external":1,
"page_size":239,
"encoding":"raw",
"language":"en",
"title":"302 Found",
"url_to":"http://www.ahrefs.com/3531625.16346367-12015409.8178502",
"first_seen":"2013-08-09T11:05:34Z",
"last_visited":"2013-08-27T06:17:56Z",
"prev_visited":"2013-10-25T20:33:04Z",
"original":false,
"redirect":302,
"alt":"",
"anchor":"",
"text_pre":"",
"text_post":"",
"link_type":"redirect",
"nofollow":false,
"broken_at":"2015-04-16T19:27:38Z",
"url_from_first_seen":"2015-03-12T19:17:33Z",
"http_code":404,
"error":""
},
{
"url_from":"http://article-library.puntadeleste-property.com/",
"ahrefs_rank":0,
"domain_rating":0,
"ahrefs_top":0,
"ip_from":"178.17.172.251",
"links_internal":0,
"links_external":1,
"page_size":239,
"encoding":"raw",
"language":"en",
"title":"302 Found",
"url_to":"http://www.ahrefs.com/922604.978175804-7853172.38164507",
"first_seen":"2013-08-11T17:05:25Z",
"last_visited":"2013-08-26T05:36:42Z",
"prev_visited":"2013-09-25T10:45:38Z",
"original":false,
"redirect":302,
"alt":"",
"anchor":"",
"text_pre":"",
"text_post":"",
"link_type":"redirect",
"nofollow":false,
"broken_at":"2015-04-12T07:04:18Z",
"url_from_first_seen":"2014-01-02T02:14:22Z",
"http_code":404,
"error":""
}
]
}
