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": "",
        "mozda": null,
        "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_mozda_date": null,
        "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, quaterly, 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_blocked_robotstxt	Page is blocked via robots.txt
is_forced_status	Status was changed manually
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
mozda	Moz Domain Authority
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_mozda_date	Date of check
src_domain_yandex_x	Yandex X (ИКС)
src_domain_yandex_x_date	Date of check
to_url	Page that is referred to
total_ext_links	Число внешних ссылок, найденных на странице с обратной ссылкой
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.