API для анализа бэклинков

Список отчетов

Метод позволяет получить список всех отчетов по бэклинкам.

Формат запроса

GET /backlink-reports?limit=100&offset=0&query=host

Параметры в запросе

Имя	Обязательный	Описание
limit	Нет	Кол-во отчетов
offset	Нет	Смещение
query	Нет	Поисковая строка

Результат

В случае успеха сервер возвращает список отчетов по бэклинкам сайта из «Анализа бэклинков» и общее количество отчетов.

Пример

{

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

        }

    ]

}

Параметры ответа

Имя	Описание
total_reports	Общее кол-во отчетов
reports	Массив отчетов
id	id отчета
target	URL, для которого произведен поиск бэклинков
mode	host \| domain \| url
backlinks	Общее кол-во бэклинков для URL
refdomains	Общее кол-во ссылающихся доменов для URL
created	Дата и время создания отчета

Информация о новом отчете

Метод позволяет получить данные о новом отчете по бэклинкам сайта и количестве средств, которые спишутся с аккаунта за создание отчета.

Формат запроса

GET /backlink-reports/info?mode=host&target=hh.ru

Параметры в запросе

Имя	Обязательный	Описание
mode	Да	domain \| host \| url
target	Да	Домен или точный URL

Результат

В случае успеха сервер возвращает информацию о новом отчете по бэклинкам сайта и количестве средств, которые спишутся с аккаунта за создание отчета.

Пример

{

    “backlinks”: 12750493,

    “domains”: 56528,

    “price”: {

        “amount”: 0.6,

        “currency”: “USD”

    },

    “note”: “Note that only the first 10000 backlinks will be shown.”

}

Параметры ответа

Имя	Описание
backlinks	Общее кол-во бэклинков для сайта
domains	Общее кол-во доменов для сайта
amount	Сумма, которая спишется с баланса за создание отчета
currency	Валюта
note	Примечание

Error

HTTP-код	Сообщение об ошибке
400	Invalid url
400	Invalid domain
400	Invalid mode
400	Not enough money in your balance

Создание отчета

Метод позволяет создать новый отчет по бэклинкам сайта.

Формат запроса

POST /backlink-reports

{

   “mode”:”domain”,

   “target”:”http://host/url”

}

Параметры в запросе

Имя	Обязательный	Описание
mode	Да	domain \| host \| url
target	Да	Домен или точный URL

Результат

В случае успеха сервер возвращает id созданного отчета.

Пример

{

   “report_id”:1

}

Параметры ответа

Имя	Описание
report_id	id созданного отчета

Ошибки

HTTP-код	Сообщение об ошибке
400	Invalid url
400	Invalid domain
400	Invalid mode
400	Failed to get backlinks. Try again later
400	Not enough money in your balance

Удаление отчета

Метод позволяет удалить отчет по бэклинкам сайта.

Формат запроса

DELETE /backlink-reports/{report_id}

Параметры в запросе

Имя	Обязательный	Описание
report_id	Да	id отчета

Результат

В случае успеха сервер возвращает HTTP 204.

Ошибки

HTTP-код	Сообщение об ошибке
404	Backlink report not found

Обновление отчета

Метод позволяет обновить отчет по бэклинкам сайта.

Формат запроса

PUT /backlink-reports

{

   “report_id”:1

}

Параметры в запросе

Имя	Обязательный	Описание
report_id	Да	id отчета

Результат

В случае успеха сервер возвращает HTTP 204.

Ошибки

HTTP-код	Сообщение об ошибке
400	Invalid report id
404	Backlink report not found
400	Failed to get backlinks. Try again later
400	Not enough money in your balance

Обзор отчета

Метод позволяет получить подробную информацию по всем бэклинкам в отчете.

Формат запроса

GET /backlink-reports/{report_id}/overview

Параметры в запросе

Имя	Обязательный	Описание
report_id	Да	id отчета

Результат

В случае успеха сервер возвращает подробную информацию по всем бэклинкам в отчете.

Пример

{

   “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

}

Ошибки

HTTP-код	Сообщение об ошибке
400	Invalid report id
404	Backlink report not found

Список бэклинков для отчета

Метод позволяет получить список и количество бэклинков сайта для отчета.

Формат запроса

GET /backlink-reports/{report_id}/backlinks?limit=100&offset=0

Параметры в запросе

Имя	Обязательный	Описание
report_id	Да	id отчета
limit	Нет	Кол-во бэклинков
offset	Нет	Смещение

Результат

В случае успеха сервер возвращает список и количество бэклинков сайта для отчета.

Пример

{

   “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

      }

   ]

}

Ошибки

HTTP-код	Сообщение об ошибке
400	Invalid report id
404	Backlink report not found

Список доменов для отчета

Метод позволяет получить список и количество доменов для отчета по бэклинкам.

Формат запроса

GET /backlink-reports/{report_id}/domains?limit=100&offset=0

Параметры в запросе

Имя	Обязательный	Описание
report_id	Да	id отчета
limit	Нет	Кол-во доменов
offset	Нет	Смещение

Результат

В случае успеха сервер возвращает список и количество доменов для отчета по бэклинкам.

Пример

{

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

      }

   ]

}

Ошибки

HTTP-код	Сообщение об ошибке
400	Invalid report id
404	Backlinks report not found

Список анкоров для отчета

Метод позволяет получить список и количество анкоров для отчета по бэклинкам.

Формат запроса

GET /backlink-reports/{report_id}/anchors?limit=100&offset=0

Параметры в запросе

Имя	Обязательный	Описание
report_id	Да	id отчета
limit	Нет	Кол-во анкоров
offset	Нет	Смещение

Результат

В случае успеха сервер возвращает список и количество анкоров для отчета по бэклинкам.

Пример

{

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

      }

   ]

}

Ошибки

HTTP-код	Сообщение об ошибке
400	Invalid report id
404	Backlink report not found