Author: Olga Murina

Backlink Checker API

Posted on by Olga Murina

List of reports

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

Request format

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

{

    “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

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

{

    “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 codeError 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

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

{

   “report_id”:1

}

Response parameters

NameDescription
report_idReport ID

Errors

HTTP codeError 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

DELETE /backlink-reports/{report_id}

Request parameters

NameRequiredDescription
report_idYesReport ID

Result

If successful, the server returns the 204 HTTP code.

Errors

HTTP codeError message
404Backlink report not found

Updating a report

The method allows to update a backlink report.

Request format

PUT /backlink-reports

{

   “report_id”:1

}

Request parameters

NameRequiredDescription
report_idYesReport ID

Result

If successful, the server returns the 204 HTTP code.

Errors

HTTP codeError 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

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

{

   “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 codeError message
400Invalid report ID
404Backlink report not found

Backlink list for the report

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

Request format

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

{

   “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

      },

      {

         “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

      }

   ]

}

Errors

HTTP codeError 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

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

{

   “total_domains”:5491,

   “domains”:[

      {

         “id”:”2″,

         “yandex_x”:null,

         “domain_inlink_rank”:”64″,

         “backlinks”:”13″,

         “first_seen”:”2021-05-23″,

         “lost_date”:null,

         “domain”:”seranking.ru”

      },

      {

         “id”:”21″,

         “yandex_x”:null,

         “domain_inlink_rank”:”9″,

         “backlinks”:”1″,

         “first_seen”:”2021-03-16″,

         “lost_date”:null,

         “domain”:”www.ruecouponcode.com”

      },

      {

         “id”:”22″,

         “yandex_x”:null,

         “domain_inlink_rank”:”60″,

         “backlinks”:”1″,

         “first_seen”:”2021-04-05″,

         “lost_date”:null,

         “domain”:”p.eurekster.com”

      }

   ]

}

Errors

HTTP codeError 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

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

{

   “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 codeError message
400Invalid report ID
404Backlink report not found

Backlink groups API

Posted on by Olga Murina

Getting a list of backlink groups

The method allows to get a list and number of backlink groups.

Request format

GET /backlink-groups/{site_id}

Request parameters

NameRequiredDescription
site_idYesWebsite ID

Result

If successful, the server returns the list and number of backlink groups.

Response example

{

    “total_groups”: 2,

    “groups”: [

        {

            “id”: 1,

            “name”: “General”,

            “count”: 5

        },

        {

            “id”: 2,

            “name”: “Second group”,

            “count”: 1

        }

    ]

}

Response parameters

NameDescription
total_groupsTotal number of groups
groupsArray of groups
idGroup ID
nameGroup name
countNumber of backlinks in group

Errors

HTTP codeError message
403Access denied (wrong site_id)

Creating a group of backlinks

The method allows to create a group of website backlinks.

Request format

POST /backlink-groups/{site_id}

{

    “name”: “Group name”

}

Request parameters

NameRequiredDescription
site_idYesWebsite ID
nameYesGroup name

Result

If successful, the server returns a backlink group ID.

Response example

{

    “group_id”: 2

}

Response parameters

NameDescription
group_idBacklink group ID

Errors

HTTP codeError message
403Access denied (wrong site_id)
400Invalid name
400Group already exists

Deleting a backlink group

The method allows to delete a group of a website’s backlinks.

Request format

DELETE /backlink-groups/{site_id}?id={id}

Request parameters

NameRequiredDescription
site_idYesWebsite ID
idYesBacklink group ID

Result

If successful, the server returns the 204 HTTP code.

Errors

HTTP codeError message
403Access denied (wrong site_id)
400Invalid group ID
400Group does not exist

Renaming a backlink group

The method allows to change the name of a backlink group.

Request format

PUT /backlink-groups/{site_id}

{

    “id”: 2,

    “name”: “New group name”

}

Request parameters

NameRequiredDescription
site_idYesWebsite ID
idYesBacklink group ID
nameYesNew backlink group name

Result

If successful, the server returns the 204 HTTP code.

Errors

HTTP codeError message
403Access denied (wrong site_id)
400Invalid name
400Group already exists

Moving backlinks to another group

The method allows to move backlinks from one group to another.

Request format

POST /backlink-groups/{site_id}/move

{

    “id”: 1,

    “backlink_ids”: [1],

    “group_ids”: [2]

}

Request parameters

NameRequiredDescription
site_idYesWebsite ID
idYesBacklink group ID to move to
backlink_idsNoArray of IDs of backlinks to be moved
group_idsNoArray of IDs of backlink groups to be moved

Result

If successful, the server returns the 204 HTTP code.

Errors

HTTP codeError message
403Access denied (wrong site_id)
400Invalid group IDs
400Backlink group IDs
400IDs of groups or backlinks are required

Keyword Research API

Posted on by Olga Murina

Getting data on keywords

Description

The method allows getting various data on keywords.

Request format

POST https://api4.seranking.com/research/{source}/analyze-keywords/

Parameters

Name Required Description
sourceYesThe database that is requested.
keywordsYesKeywords to analyze. 5,000 max per single request.
sort NoSorting (CPC by default)
sort_order NoSorting order: asc or desc (desc by default)
colsNoThe list of return values (separated by commas)

Result

If successful, the server returns the list of keywords with their parameters.

Example

[

 {

      is_data_found: true,

      keyword: “seranking.com”,

      volume: 10,

      cpc: 0.00,

      competition: “0.00”,

      difficulty: 90,

      history_trend: {

            “2020-03-01”: 10,

            “2020-04-01”: 10,

            “2020-05-01”: 10,

            “2020-06-01”: 10,

            “2020-07-01”: 10,

            “2020-08-01”: 10,

            “2020-09-01”: 10,

            “2020-10-01”: 10,

            “2020-11-01”: 10,

            “2020-12-01”: 10,

            “2021-01-01”: 10,

            “2021-02-01”: 10

      }

},

…

]

Response parameters

Name Description
is_data_foundShows whether keyword id data is found: values are either true or false
keywordKeyword
volumeSearch volume
cpcCPC
competitionCompetition
difficultyKeyword difficulty
history_trendSearch volume history

Errors

HTTP code Error message
400Incorrect order field {sort} {sort_order}
400Number of keywords exceeded. Max keywords per single request: 10000
400Invalid keywords
400Invalid source