Backlink Checker

Backlink Checker API provides endpoints to retrieve, manage, import, group, and disavow backlinks, as well as monitor backlink import status and statistics.

List backlinks

GET https://api4.seranking.com/backlinks/{site_id}

Retrieves a paginated list of backlinks for the specified website.

Request parameters

Request example

curl --location --request GET 'https://api4.seranking.com/backlinks/12345?limit=100&offset=100' \

--header 'Authorization: Token YOUR_API_KEY'

Response parameters

If successful, the server returns the 200 HTTP status code and an array of backlink objects. Returns HTTP 403 if site_id is wrong (for more information, see Error handling).

Each backlink object has the following structure:

Response 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_region_id": null,

        "title": "Title",

        "to_url": "http://tourl.ru/",

        "total_ext_links": "2",

        "ugc": null

    }

]

Add backlink

POST https://api4.seranking.com/backlinks/{site_id}

Adds a new backlink to the specified website.

Request parameters

Request example

curl --location --request POST 'https://api4.seranking.com/backlinks/12345' \

--header 'Content-Type: application/json' \

--header 'Authorization: Token YOUR_API_KEY' \

--data '{

  "url": "http://backlink.test/",

  "price": 1,

  "charge_period": "onetime",

  "charge_start": "2018-01-01"

}'

Response parameters

If successful, the server returns the 200 HTTP status code and an object containing the backlink ID. Returns HTTP 400 for invalid input or duplicate backlinks. Returns HTTP 403 if access is denied (for more information, see Error handling).

Response example

{"id": 1}

Import backlinks list

POST https://api4.seranking.com/backlinks/{site_id}/list

Imports a list of backlinks for the specified website.

Request parameters

Request example

curl --location --request POST 'https://api4.seranking.com/backlinks/12345/list' \

--header 'Content-Type: application/json' \

--header 'Authorization: Token YOUR_API_KEY' \

--data '{

  "group_id": 1,

  "price": 100,

  "currency": "USD",

  "manager": "manager",

  "charge_period": "onetime",

  "charge_start": "2021-10-10",

  "list": ["https://google.com"]

}'

Response parameters

If successful, the server returns the 200 HTTP status code and an object containing import results. Returns HTTP 400 for invalid input and HTTP 403 if access is denied (for more information, see Error handling).

Response example

{

  "added": 1,

  "duplicates": 0,

  "total": 1

}

Update backlink import settings

PUT https://api4.seranking.com/backlinks/{site_id}/settings

Updates automatic backlink import settings from Google Search Console.

Request parameters

Request example

curl --location --request PUT 'https://api4.seranking.com/backlinks/12345/settings' \

--header 'Content-Type: application/json' \

--header 'Authorization: Token YOUR_API_KEY' \

--data '{

  "gsc_autoimport": true

}'

Response parameters

If successful, the server returns the 204 HTTP status code with no response body. Returns HTTP 403 if access is denied (for more information, see Error handling).

Response example

No response body.

Start backlink import from Google Search Console

POST https://api4.seranking.com/backlinks/{site_id}/import-gsc

Starts importing backlinks from Google Search Console.

Request parameters

Request example

curl --location --request POST 'https://api4.seranking.com/backlinks/12345/import-gsc' \

--header 'Authorization: Token YOUR_API_KEY'

Response parameters

If successful, the server returns the 200 HTTP status code and an import task object. Returns HTTP 403 if access is denied (for more information, see Error handling).

Response example

{

  "status": "queued",

  "token": "1c84d0375d44725521647919c17f1cb9"

}

Get backlink import status from Google Search Console

GET https://api4.seranking.com/backlinks/{site_id}/import-gsc/{token}

Returns the status of a Google Search Console backlink import task.

Request parameters

Request example

curl --location --request GET 'https://api4.seranking.com/backlinks/12345/import-gsc/1c84d0375d44725521647919c17f1cb9' \

--header 'Authorization: Token YOUR_API_KEY'

Response parameters

If successful, the server returns the 200 HTTP status code and import task status. Returns HTTP 403 if access is denied (for more information, see Error handling).

Response example

{

  "time": 1635417036150,

  "status": "queued"

}

Delete backlinks

POST https://api4.seranking.com/backlinks/{site_id}/delete

Deletes backlinks for the specified website.

Request parameters

Request example

curl --location --request POST 'https://api4.seranking.com/backlinks/12345/delete' \

--header 'Content-Type: application/json' \

--header 'Authorization: Token YOUR_API_KEY' \

--data '{

  "backlink_ids": [1, 2, 3]

}'

Response parameters

If successful, the server returns the 204 HTTP status code with no response body. Returns HTTP 400 for invalid input and HTTP 403 if access is denied (for more information, see Error handling).

Response example

No response body.

Recheck backlinks

POST https://api4.seranking.com/backlinks/{site_id}/recheck

Runs an index or HTTP status check for the specified backlinks.

Request parameters

Request example

curl --location --request POST 'https://api4.seranking.com/backlinks/12345/recheck' \

--header 'Content-Type: application/json' \

--header 'Authorization: Token YOUR_API_KEY' \

--data '{

  "backlink_ids": [1, 2],

  "recheck_type": "index"

}'

Response parameters

If successful, the server returns the 204 HTTP status code with no response body. Returns HTTP 400 for invalid input and HTTP 403 if access is denied (for more information, see Error handling).

Response example

No response body.

Get backlink statistics

GET https://api4.seranking.com/backlinks/{site_id}/stat

Returns backlink statistics for the specified website.

Request parameters

Request example

curl --location --request GET 'https://api4.seranking.com/backlinks/12345/stat' \

--header 'Authorization: Token YOUR_API_KEY'

Response parameters

If successful, the server returns the 200 HTTP status code and backlink statistics. Returns HTTP 403 if site_id is wrong (for more information, see Error handling).

Response example

{

  "total": 9,

  "anchors": 1,

  "ip": 8,

  "domains": 9,

  "dofollow": 0,

  "nofollow": 1,

  "limit": 988

}

List disavowed backlinks

GET https://api4.seranking.com/backlink-disavow/{site_id}

Returns a list of disavowed backlinks.

Request parameters

Request example

curl --location --request GET 'https://api4.seranking.com/backlink-disavow/12345?limit=100&offset=0' \

--header 'Authorization: Token YOUR_API_KEY'

Response parameters

If successful, the server returns the 200 HTTP status code and disavowed backlinks. Returns HTTP 403 if access is denied (for more information, see Error handling).

Response example

{

    "total_disavow_links": 2,

    "disavow_links": [

        { "id": 3, "url": "https://google.com", "type": "url", "exported": 0, "domain_inlink_rank": 96 },

        { "id": 4, "url": "https://google.com", "type": "url", "exported": 0, "domain_inlink_rank": 100 }

    ]

}

Add disavowed backlinks

POST https://api4.seranking.com/backlink-disavow/{site_id}

Adds a list of disavowed backlinks.

Request parameters

Request example

curl --location --request POST 'https://api4.seranking.com/backlink-disavow/12345' \

--header 'Content-Type: application/json' \

--header 'Authorization: Token YOUR_API_KEY' \

--data '{

  "list": [

    "https://google.com",

    "https://example.com"

  ]

}'

Response parameters

If successful, the server returns the 200 HTTP status code and the number of added disavowed backlinks. Returns HTTP 400 for invalid input and HTTP 403 if access is denied (for more information, see Error handling).

Response example

{ "added": 2 }

Delete disavowed backlink 

DELETE https://api4.seranking.com/backlink-disavow/{site_id}

Deletes a backlink from the disavow list.

Request parameters

Request example

curl --location --request DELETE 'https://api4.seranking.com/backlink-disavow/12345?id=3' \

--header 'Authorization: Token YOUR_API_KEY'

Response parameters

If successful, the server returns the 204 HTTP status code with no response body. Returns HTTP 400 for invalid input and HTTP 403 if access is denied (for more information, see Error handling).

Response example

No response body.

List backlink groups

GET https://api4.seranking.com/backlink-groups/{site_id}

Returns all backlink groups for the specified website.

Request parameters

Request example

curl --location --request GET 'https://api4.seranking.com/backlink-groups/12345' \

--header 'Authorization: Token YOUR_API_KEY'

Response parameters

If successful, the server returns the 200 HTTP status code and a list of backlink groups. Returns HTTP 403 if access is denied (for more information, see Error handling).

Response example

{

  "total_groups": 2,

  "groups": [

    {

      "id": 1,

      "name": "General",

      "count": 5

    },

    {

      "id": 2,

      "name": "Second group",

      "count": 1

    }

  ]

}

Create backlink group

POST https://api4.seranking.com/backlink-groups/{site_id}

Creates a new backlink group.

Request parameters

Request example

curl --location --request POST 'https://api4.seranking.com/backlink-groups/12345' \

--header 'Content-Type: application/json' \

--header 'Authorization: Token YOUR_API_KEY' \

--data '{

  "name": "Outreach links"

}'

Response parameters

If successful, the server returns the 200 HTTP status code and the created group ID. Returns HTTP 400 for invalid input and HTTP 403 if access is denied (for more information, see Error handling).

Response example

{ "group_id": 2 }

Delete backlink group

DELETE https://api4.seranking.com/backlink-groups/{site_id}

Deletes the specified backlink group.

Request parameters

Request example

curl --location --request DELETE 'https://api4.seranking.com/backlink-groups/12345?id=2' \

--header 'Authorization: Token YOUR_API_KEY'

Response parameters

If successful, the server returns the 204 HTTP status code. Returns HTTP 400 if the group ID is invalid or the group doesn’t exist. Returns HTTP 403 if access is denied (for more information, see Error handling).

Response example

No response body.

Rename backlink group

PUT https://api4.seranking.com/backlink-groups/{site_id}

Renames an existing backlink group.

Request parameters

Request example

curl --location --request PUT 'https://api4.seranking.com/backlink-groups/12345' \

--header 'Content-Type: application/json' \

--header 'Authorization: Token YOUR_API_KEY' \

--data '{

  "id": 2,

  "name": "Guest posts"

}'

Response parameters

If successful, the server returns the 204 HTTP status code with no response body. Returns HTTP 400 for invalid input and HTTP 403 if access is denied (for more information, see Error handling).

Response example

No response body.

Move backlinks to group

POST https://api4.seranking.com/backlink-groups/{site_id}/move

Moves backlinks or backlink groups into the specified backlink group.

Request parameters

Request example

curl --location --request POST 'https://api4.seranking.com/backlink-groups/12345/move' \

--header 'Content-Type: application/json' \

--header 'Authorization: Token YOUR_API_KEY' \

--data '{

  "id": 1,

  "backlink_ids": [10, 11],

  "group_ids": [2]

}'

Response parameters

If successful, the server returns the 204 HTTP status code with no response body. Returns HTTP 400 for invalid input and HTTP 403 if access is denied (for more information, see Error handling).

Response example

No response body.