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-gsc

Request 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-status

Request 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=0

Request 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.