Backlinks API
List of backlinks
The method allows to get a list of a website’s backlinks.
Request format
GET /backlinks/{site_id}?limit=100&offset=100 Request parameters
| Name | Required | Description |
| limit | No | Total number of links. Max number of links – 1000 |
| offset | No | Offset value |
Result
If successful, the server returns a list of the specified website’s backlinks.
Example
[
{
“anchor”: “SE Ranking”,
“category”: “”,
“charge_period”: null,
“charge_start”: null,
“date_added”: “2018-06-11”,
“date_lost”: “2021-10-10”,
“date_placement”: “2018-10-11”,
“domain”: “highpoweredseo.com”,
“duration”: “”,
“fb_likes”: “2”,
“from_domainid”: “4630”,
“from_url”: “http://highpoweredseo.com/how-to-become-a-better”,
“gin_index”: “11”,
“gin_index_check_date”: “2018-10-05”,
“http_status”: “1”,
“id”: “53”,
“is_blocked_meta”: “1”,
“is_blocked_robotstxt”: “1”,
“is_disavow”: “0”,
“is_forced_status”: “0”,
“is_image”: “1”,
“is_link_not_found”: “1”,
“is_nofollow”: “1”,
“is_redir”: “1”,
“is_sponsored”: “0”,
“last_crawler_visit”: “2018-10-05”,
“link_manager”: “”,
“link_type”: “”,
“mozda”: null,
“notes”: “ghjg”,
“num_links”: 10,
“price”: null,
“source”: null,
“src_domain_country”: “USA”,
“src_domain_inlink_rank”: null,
“src_domain_ip”: “184.168.221.40”,
“src_domain_mozda_date”: null,
“src_domain_yandex_x”: null,
“src_domain_yandex_x_date”: null,
“title”: “Title”,
“to_url”: “http://tourl.ru/”,
“total_ext_links”: “2”,
“ugc”: null,
“yin_index”: “12”,
“yin_index_check_date”: “2018-10-05”
},
…
]Response parameters
| Name | Description |
| anchor | Backlink anchor text |
| id | Link ID |
| category | Target backlink category |
| charge_period | Charging period (onetime, monthly, quarterly, 6months, year) |
| charge_start | Payment start date |
| date_added | Date when the backlink was added |
| date_lost | Date when the backlink was lost |
| date_placement | Date when the backlink was placed |
| domain | Domain of the page that links back to your site |
| duration | Backlink placement duration according to the agreement with the donor |
| fb_likes | Total number of people who shared a given page on Facebook |
| from_domainid | Backlink domain ID |
| from_url | URL of the page that links back to your site |
| gin_index | Has the page containing the backlink been indexed by Google |
| gin_index_check_date | Date of check |
| http_status | HTTP status of the page containing the backlink |
| is_blocked_meta | Page is blocked via a meta header |
| is_forced_status | Status was changed manually |
| is_disavow | Backlink is disavowed |
| is_blocked_robotstxt | Page is blocked via robots.txt |
| is_image | Link in the image |
| is_link_not_found | Page backlink not found |
| is_nofollow | Link will not be indexed |
| is_redir | Page redirects to another page |
| is_sponsored | Backlink is sponsored |
| last_crawler_visit | Last crawling date |
| link_manager | Responsible individual |
| link_type | Type of backlink anchor text |
| notes | Note |
| num_links | Number of backlinks |
| price | Cost of backlink placement |
| source | Source |
| src_domain_ country | Country |
| src_domain_inlink_rank | Domain rank |
| src_domain_ ip | Referring IPs |
| src_domain_mozda_date | Date of check |
| src_domain_ yandex_x | Yandex X (ИКС) |
| src_domain_ x_date | Date of check |
| title | Page title |
| to_url | Page that is referred to |
| total_ext_links | The number of external links found on the page with a reverse link |
| ugc | UGC (user generated content) |
| yin_index | Has the page containing the backlink been indexed by Yandex |
| yin_index_check_date | Date of check |
Errors
| HTTP code | Error message |
| 403 | Access denied (wrong site_id) |
Adding a backlink
POST /backlinks/{site_id}
{
“url”: “http://backlink.test/”,
“price”: 1,
“charge_period”: “onetime”,
“charge_start”: “2018-01-01”
}Request parameters
| Name | Required | Description |
| url | Yes | Backlink URL |
| price | No | Backlink price |
| currency | No | Currency code ISO 4217 (USD, CAD, AUD, etc.) |
| charge_period | No | Payment (one-time, monthly) |
| charge_start | No | Payment start date |
Result
If successful, the server returns the ID of the added backlink.
Example
{
“id”: 1
}Errors
| HTTP code | Error message |
| 400 | Invalid URL |
| 400 | Backlinks limit exceeded |
| 400 | Backlink already exist |
| 403 | Access denied (wrong site_id) |
List of backlinks import
The method allows to import a list of a website’s backlinks.
Request format
POST /backlinks/{site_id}/list
{
“group_id”: 1,
“price”: 100,
“currency”: “USD”,
“manager”: “manager”,
“charge_period”: “onetime”,
“charge_start”: “2021-10-10”,
“list”: [
“https://google.com”,
“https://yandex.ru”
]
}
Request parameters
| Name | Required | Description |
| site_id | Yes | Website ID |
| list | Yes | Array of backlinks |
| price | No | Price |
| currency | No | Currency code ISO 4217 (USD, CAD, AUD, etc.) |
| charge_period | No | Charging period (onetime, monthly, quarterly, 6months, year) |
| charge_start | No | Payment start date (Y-m-d) |
| group_id | No | Group of backlink IDs |
| manager | No | Manager |
Result
If successful, the server returns the number of added backlinks, number of duplicates and total number of backlinks.
Response example
{
“added”: 2,
“duplicates”: 0,
“total”: 2
}Response parameters
| Name | Description |
| added | Number of added backlinks |
| duplicates | Number of backlink duplicates |
| total | Total number of backlinks |
Updating settings for running backlink import
The method allows to update settings for automatic backlink import from Google Search Console.
Request format
PUT /backlinks/{site_id}/settings
{
“gsc_autoimport”: true,
} Request parameters
| Name | Required | Description |
| site_id | Yes | Website ID |
| gsc_autoimport | Yes | true or false, enable or disable auto import from GSC |
Result
If successful, the server returns the 204 HTTP code.
Errors
| HTTP code | Error message |
| 403 | Access denied (wrong site_id) |
Running a backlink import from Google Search Console
The method allows to run a backlink import from Google Search Console.
Request format
POST /backlinks/{site_id}/import-gscRequest parameters
| Name | Required | Description |
| site_id | Yes | Website ID |
Result
If successful, the server returns the import task status and import task token that can be used to check its status in the future.
Response example
{
“status”: “queued”,
“token”: “1c84d0375d44725521647919c17f1cb9”
}Response parameters
| Name | Description |
| status | Import task status |
| token | Import task token |
Errors
| HTTP code | Error message |
| 403 | Access denied (wrong site_id) |
Getting a backlink import status from Google Search Console
The method allows to get a backlink import status from Google Search Console.
Request format
GET /backlinks/{site_id}/import-statusRequest parameters
| Name | Required | Description |
| site_id | Yes | Website ID |
| token | Yes | Import task token obtained in the Running of backlink import method |
Result
If successful, the server returns the import task status and the time in the timestamp format.
Response example
{
“time”: 1635417036150,
“status”: “queued”
}Response parameters
| Name | Description |
| status | Import task status |
| time | Time in timestamp format |
Errors
| HTTP code | Error message |
| 403 | Access denied (wrong site_id) |
Deleting a backlink list
The method allows to delete a website’s backlink list.
Request format
POST /backlinks/{site_id}/delete
{
“backlink_ids”: [
1,
2,
3
]
}Request parameters
| Name | Required | Description |
| site_id | Yes | Website ID |
| backlink_ids | Yes | Array of backlink IDs |
Result
If successful, the server returns the 204 HTTP code.
Errors
| HTTP code | Error message |
| 403 | Access denied (wrong site_id) |
| 400 | Invalid ids |
Running a backlink index/status check
The method allows to run an index or status check for a backlink list.
Request format
POST /backlinks/{site_id}/recheck
{
“backlink_ids”: [
1,
2
],
“recheck_type”:”index”
}Request parameters
| Name | Required | Description |
| site_id | Yes | Website ID |
| backlink_ids | Yes | Array of backlink IDs |
| recheck_type | No | Check type, possible values: status, index. If you do not pass the parameter, recheck_type=status will be used by default |
Result
If successful, the server returns the 204 HTTP code.
Errors
| HTTP code | Error message |
| 403 | Access denied (wrong site_id) |
| 400 | Invalid IDs |
Backlink statistics
Request format
GET /backlinks/{site_id}/stat Request parameters
| Name | Required | Description |
| site_id | Yes | Website ID |
Response example
{
“total”: 9,
“anchors”: 1,
“ip”: 8,
“domains”: 9,
“dofollow”: 0,
“nofollow”: 1,
“limit”: 988
}Response parameters
| Name | Description |
| total | Total number of backlinks |
| anchors | Total number of unique anchor texts |
| ip | Total number of unique IP addresses |
| domains | Total number of unique domains |
| dofollow | Total number of dofollow links |
| nofollow | Total number of nofollow links |
| limit | Limit on adding links. Available for adding today |
Errors
| HTTP code | Error message |
| 403 | Access denied (wrong site_id) |
List of disavowed backlinks
The method allows to get a list and number of disavowed backlinks.
Request format
GET /backlink-disavow/{site_id}?limit=100&offset=0Request parameters
| Name | Required | Description |
| site_id | Yes | Website ID |
| limit | No | Number of disavowed backlinks |
| offset | No | Offset |
Result
If successful, the server returns a list and number of disavowed backlinks.
Response example
{
“total_disavow_links”: 2,
“disavow_links”: [
{
“id”: 3,
“url”: “https://yandex.ru”,
“type”: “url”,
“exported”: 0,
“yandex_x”: null,
“domain_inlink_rank”: 96
},
{
“id”: 4,
“url”: “https://google.com”,
“type”: “url”,
“exported”: 0,
“yandex_x”: null,
“domain_inlink_rank”: 100
}
]
}Response parameters
| Name | Description |
| total_disavow_links | Total number of disavowed backlinks |
| disavow_links | Array of disavowed backlinks |
| id | Disavowed backlink ID |
| url | Disavowed backlink URL |
| type | Backlink type |
| exported | Whether the backlink is exported |
| yandex_x | Yandex X rating value |
| domain_inlink_rank | Domain rank |
Errors
| HTTP code | Error message |
| 403 | Access denied (wrong site_id) |
Adding a disavowed backlink list
The method allows to add a list of disavowed backlinks.
Request format
POST /backlink-disavow/{site_id}
{
“list”: [
“https://google.com”,
“https://yandex.ru”
]
}Request parameters
| Name | Required | Description |
| site_id | Yes | Website ID |
| list | Yes | Array of backlinks |
Result
If successful, the server returns the number of added disavowed backlinks.
Response example
{
“added”: 2
}Response parameters
| Name | Description |
| added | Number of added disavowed backlinks |
Errors
| HTTP code | Error message |
| 403 | Access denied (wrong site_id) |
| 400 | Invalid list |
Deleting a disavowed backlink
The method allows to delete a disavowed backlink from the list of disavowed backlinks.
Request format
DELETE /backlink-disavow/{site_id}?id={disavow_link_id}Request parameters
| Name | Required | Description |
| site_id | Yes | Website ID |
| disavow_link_id | Yes | Disavowed backlink ID |
Errors
| HTTP code | Error message |
| 403 | Access denied (wrong site_id) |
| 400 | Invalid disawov link ID |
| 400 | Disawov link does not exist |
Result
If successful, the server returns the 204 HTTP code.