API Description

Backlinks

List of reports

The method allows to get a list of all backlink reports.

Request format

Title of the code block
Copy
GET /backlink-reports?limit=100&offset=0&query=host

Request parameters

NameRequiredDescription
limitNoNumber of reports
offsetNoOffset
queryNoSearch string


Result

If successful, the server returns the list of backlink reports from the Backlink Checker tool and the total number of reports.

Response example

Title of the code block
Copy
{

    "total_reports": 6,

    "reports": [

        { "id": "11", "target": "goods.ru", "mode": "host", "backlinks": "402717", "refdomains": "2264", "created": "2021-10-06 13:03:20" },

        { "id": "9", "target": "gismeteo.by", "mode": "host", "backlinks": "10829727", "refdomains": "2211", "created": "2021-10-06 10:03:28" },

        { "id": "7", "target": "travelbama.com", "mode": "domain", "backlinks": "785", "refdomains": "199", "created": "2021-10-06 09:56:05" },

        { "id": "6", "target": "seranking.ru", "mode": "domain", "backlinks": "66160", "refdomains": "1002", "created": "2021-10-06 09:55:19" },

        { "id": "5", "target": "seranking.com", "mode": "domain", "backlinks": "425573", "refdomains": "5682", "created": "2021-10-06 09:52:10" },

        { "id": "4", "target": "niab.by", "mode": "domain", "backlinks": "9709", "refdomains": "261", "created": "2021-10-06 09:47:51" }

    ]

}

Response parameters

NameDescription
total_reportsTotal number of reports
reportsArray of reports
idReport ID
targetTarget URL
modehost | domain | url
backlinksTotal number of backlinks for URL
refdomainsTotal number of referring domains for URL
createdDate and time of report creation


New report data

The method allows to get new backlink report data and the amount that will be withdrawn from the account for creating the report.



Request format

Title of the code block
Copy
GET /backlink-reports/info?mode=host&target=hh.ru


Request parameters

NameRequiredDescription
modeYesdomain | host | url
targetYesDomain or exact URL


Result

If successful, the server returns new backlink report data and the amount that will be withdrawn from the account for creating the report.

Response example

Title of the code block
Copy
{ "backlinks": 12750493, "domains": 56528, "price": { "amount": 0.6, "currency": "USD" }, "note": "Note that only the first 10000 backlinks will be shown." }

Response parameters

NameDescription
backlinksTotal number of backlinks for the site
domainsTotal number of domains for the site
amountThe amount that will be withdrawn from the account for creating a report
currencyCurrency
noteNote

Errors

HTTP code Error message
400Invalid url
400Invalid domain
400Invalid mode
400Not enough money in your balance


Creating a report


The method allows to create a new backlink report.


Request format

Title of the code block
Copy
POST /backlink-reports

{ "mode": "domain", "target": "http://host/url" }


Request parameters

NameRequiredDescription
modeYesdomain | host | url
targetYesDomain or exact URL


Result

If successful, the server returns the ID of the created report.

Response example

Title of the code block
Copy
{   "report_id":1}

Response parameters

NameDescription
report_idReport ID

Errors

HTTP code Error message
400Invalid url
400Invalid domain
400Invalid mode
400Failed to get backlinks. Try again later
400Not enough money in your balance



Deleting a report



The method allows to delete a backlink report.

Request format

Title of the code block
Copy
DELETE /backlink-reports/{report_id}


Request parameters

NameRequiredDescription
report_idYesReport ID


Result

If successful, the server returns the 204 HTTP code.

Errors

HTTP code Error message
404Backlink report not found

Updating a report



The method allows to update a backlink report.


Request format

Title of the code block
Copy
PUT /backlink-reports

{   "report_id":1}


Request parameters

NameRequiredDescription
report_idYesReport ID


Result

If successful, the server returns the 204 HTTP code.


Errors

HTTP code Error message
400Invalid report ID
404Backlink report not found
400Failed to get backlinks. Try again later
400Not enough money in your balance

Report overview


The method allows to get detailed information on all backlinks in the report.

Request format

Title of the code block
Copy
GET /backlink-reports/{report_id}/overview


Request parameters

NameRequiredDescription
report_idYesReport ID


Result

If successful, the server returns detailed information on all backlinks in the report.

Response example

Title of the code block
Copy
{

    "report_id": 5,

    "created": "2021-10-06",

    "target": "seranking.com",

    "mode": "domain",

    "inlink_rank": 58,

    "domain_inlink_rank": 82,

    "backlinks": { "total": 425573, "nofollow_backlinks": 18667, "edu_backlinks": 11, "gov_backlinks": 4, "backlinks_to_homepage": 5915, "backlinks_saved": 15284, "per_domain": 0 },

    "domains": {

        "total": 5682,

        "domains_to_homepage": 2665,

        "domains_to_otherpage": 2846,

        "domains_saved": 5492,

        "top_domains": [

            { "domain": "nl", "count": "3410", "name": "Netherlands", "country": "NL" },

            { "domain": "it", "count": "161", "name": "Italy", "country": "IT" },

            { "domain": "uk", "count": "160", "name": "United Kingdom", "country": "GB" },

            { "domain": "jp", "count": "136", "name": "Japan", "country": "JP" },

            { "domain": "ru", "count": "128", "name": "Russia", "country": "RU" },

            { "domain": "pw", "count": "121", "name": "Palau", "country": "PW" }

        ]

    },

    "anchors": {

        "total": 1817,

        "top_anchors": {

            "links": [

                { "anchor": "", "count": "9613" },

                { "anchor": "SE Ranking", "count": "1224" },

                { "anchor": "seranking.com", "count": "363" },

                { "anchor": "SERanking", "count": "272" },

                { "anchor": "SEO Software for 360 SEO Analysis of your Website.", "count": "138" },

                { "anchor": "SERanking SEO monitaring", "count": "117" },

                { "anchor": "https://seranking.com/", "count": "110" },

                { "anchor": "Seranking LTD", "count": "77" },

                { "anchor": "無料で試してみる", "count": "71" },

                { "anchor": "301", "count": "67" }

            ],

            "domains": [

                { "anchor": "SE Ranking", "count": "1136" },

                { "anchor": "", "count": "424" },

                { "anchor": "seranking.com", "count": "360" },

                { "anchor": "SERanking", "count": "272" },

                { "anchor": "SEO Software for 360 SEO Analysis of your Website.", "count": "134" },

                { "anchor": "https://seranking.com/", "count": "99" },

                { "anchor": "Seranking LTD", "count": "77" },

                { "anchor": "301", "count": "67" },

                { "anchor": ".", "count": "42" },

                { "anchor": "Backlink Checker: Spy on Competitor Backlinks.", "count": "38" }

            ]

        }

    },

    "ips": null,

    "subnets": null

}

Errors

HTTP code Error message
400Invalid report ID
404Backlink report not found


The method allows to get a list and the number of website backlinks for the report.


Request format

Title of the code block
Copy
GET /backlink-reports/{report_id}/backlinks?limit=100&offset=0


Request parameters

NameRequiredDescription
report_idYesReport ID
limitNoNumber of backlinks
offsetNoOffset


Result

If successful, the server returns a list and the number of website backlinks for the report.

Response example

Title of the code block
Copy
{

    "total_backlinks": 15284,

    "backlinks": [

        {

            "id": 40624,

            "url": "http://operomagna.it/web-seo-consultant/website-seo-checker.htm",

            "title": "checker > web seo consultant > website seo checker",

            "anchor_id": 786,

            "domain_id": 639,

            "image": 1,

            "nofollow": 1,

            "inlink_rank": 1,

            "first_seen": "2021-05-24",

            "last_visited": "2021-05-24",

            "page_id": 605,

            "ugc": 0,

            "sponsored": 0,

            "lost_date": null,

            "anchor": "On-Page SEO Checker SE Ranking.",

            "url_to": "https://help.seranking.com/tools/on-page-seo-checker/",

            "domain_inlink_rank": 11,

            "alexa": null

        },

        {

            "id": 40626,

            "url": "https://webbaohiem.net/bo-him-dao-cong-c-bo-v-doanh-nhan.html",

            "title": "Bảo hiểm D&O: Công cụ bảo vệ doanh nhân - Web Bảo Hiểm",

            "anchor_id": 788,

            "domain_id": 641,

            "image": 1,

            "nofollow": 1,

            "inlink_rank": 3,

            "first_seen": "2021-05-24",

            "last_visited": "2021-05-24",

            "page_id": 607,

            "ugc": 0,

            "sponsored": 0,

            "lost_date": null,

            "anchor": "link",

            "url_to": "https://online.seranking.com/research.overview.html?filter=base_domain&input=gayincesttube.com",

            "domain_inlink_rank": 37,

            "alexa": null

        }

    ]

}

Errors

HTTP code Error message
400Invalid report ID
404Backlink report not found

Domain list for the report



The method allows to get a list and the number of domains for the backlink report.


Request format

Title of the code block
Copy
GET /backlink-reports/{report_id}/domains?limit=100&offset=0


Request parameters

NameRequiredDescription
report_idYesReport ID
limitNoNumber of domains
offsetNoOffset


Result

If successful, the server returns a list and the number of domains for the backlink report.

Response example

Title of the code block
Copy
{

    "total_domains": 5491,

    "domains": [

        { "id": "2", "alexa": null, "domain_inlink_rank": "64", "backlinks": "13", "first_seen": "2021-05-23", "lost_date": null, "domain": "seranking.ru" },

        { "id": "21", "alexa": null, "domain_inlink_rank": "9", "backlinks": "1", "first_seen": "2021-03-16", "lost_date": null, "domain": "www.ruecouponcode.com" },

        { "id": "22", "alexa": null, "domain_inlink_rank": "60", "backlinks": "1", "first_seen": "2021-04-05", "lost_date": null, "domain": "p.eurekster.com" }

    ]

}

Errors

HTTP code Error message
400Invalid report ID
404Backlink report not found

Anchor list for the report


The method allows to get a list and the number of anchor texts for the backlink report.


Request format

Title of the code block
Copy
GET /backlink-reports/{report_id}/anchors?limit=100&offset=0


Request parameters

NameRequiredDescription
report_idYesReport ID
limitNoNumber of anchor texts
offsetNoOffset

Result

If successful, the server returns a list and the number of anchor texts for the backlink report.

Response example

Title of the code block
Copy
{

    "total_anchors": 1808,

    "anchors": [

        { "id": "786", "anchor": "On-Page SEO Checker SE Ranking.", "domains": "3", "backlinks": "3", "first_seen": "2021-05-11", "last_visited": "2021-05-24", "dofollow": "0", "words": "5" },

        { "id": "787", "anchor": "feat", "domains": "1", "backlinks": "1", "first_seen": "2021-05-24", "last_visited": "2021-05-24", "dofollow": "0", "words": "1" },

        { "id": "788", "anchor": "link", "domains": "20", "backlinks": "20", "first_seen": "2019-02-25", "last_visited": "2021-05-24", "dofollow": "3", "words": "1" }

    ]

}

Errors

HTTP code Error message
400Invalid report ID
404Backlink report not found