Table of content
Backlinks
Backlink statistics
Request format
GET /backlinks/{site_id}/stat Request parameters
| Name | Required | Description |
| backlink_id | Yes | Backlink 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 |
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 website backlinks.
Example
[
{
“anchor”: “SE Ranking”,
“category”: “”,
“charge_period”: null,
“charge_start”: null,
“date_added”: “2018-06-11”,
“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_forced_status”: “0”,
“is_image”: “1”,
“is_link_not_found”: “1”,
“is_nofollow”: “1”,
“is_redir”: “1”,
“last_crawler_visit”: “2018-10-05”,
“link_manager”: “”,
“link_type”: “”,
“notes”: “ghjg”,
“price”: null,
“source”: null,
“src_domain_alexa”: null,
“src_domain_alexa_date”: null,
“src_domain_country”: “USA”,
“src_domain_ip”: “184.168.221.40”,
“src_domain_yandex_x”: null,
“src_domain_yandex_x_date”: null,
“to_url”: “http://tourl.ru/”,
“total_ext_links”: “2”,
“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_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_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 |
| last_crawler_visit | Last crawling date |
| link_manager | Responsible individual |
| link_type | Type of backlink anchor text |
| notes | Note |
| price | Cost of backlink placement |
| source | Source |
| src_domain_ alexa | Backlink domain Alexa rank |
| src_domain_ alexa_date | Date of Alexa check |
| src_domain_ country | Country |
| src_domain_ ip | Referring IPs |
| src_domain_ yandex_x | Yandex X (ИКС) |
| src_domain_ x_date | Date of check |
| to_url | Page that is referred to |
| total_ext_links | The number of external links found on the page with a reverse link |
| yin_index | Has the page containing the backlink been indexed by Yandex |
| yin_index_check_date | Date of check |
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 |
| 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 |
Deleting a backlink
Request format
DELETE /backlinks/{backlink_id}Request parameters
| Name | Required | Description |
| backlink_id | Yes | Backlink ID |
Result
If successful, the server returns the 204 HTTP code.