How You Can Help Ukrainians Today (SE Ranking Team Included)Learn here

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Массив отчетов
idid отчета
targetURL, для которого произведен поиск бэклинков
modehost | 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-кодСообщение об ошибке
400Invalid url
400Invalid domain
400Invalid mode
400Not 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_idid созданного отчета

Ошибки

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

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

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

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

DELETE /backlink-reports/{report_id}

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

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

Результат

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

Ошибки

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

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

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

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

PUT /backlink-reports
{
«report_id»:1
}

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

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

Результат

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

Ошибки

HTTP-кодСообщение об ошибке
400Invalid report id
404Backlink report not found
400Failed to get backlinks. Try again later
400Not 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-кодСообщение об ошибке
400Invalid report id
404Backlink 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,
«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
}
]
}

Ошибки

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

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

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

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

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

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

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

Результат

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

Пример

{
«total_domains»:5491,
«domains»:[
{
«id»:»2″,
«alexa»:null,
«yandex_x»:null,
«domain_inlink_rank»:»64″,
«backlinks»:»13″,
«first_seen»:»2021-05-23″,
«lost_date»:null,
«domain»:»seranking.ru»
},
{
«id»:»21″,
«alexa»:null,
«yandex_x»:null,
«domain_inlink_rank»:»9″,
«backlinks»:»1″,
«first_seen»:»2021-03-16″,
«lost_date»:null,
«domain»:»www.ruecouponcode.com»
},
{
«id»:»22″,
«alexa»:null,
«yandex_x»:null,
«domain_inlink_rank»:»60″,
«backlinks»:»1″,
«first_seen»:»2021-04-05″,
«lost_date»:null,
«domain»:»p.eurekster.com»
}
]
}

Ошибки

HTTP-кодСообщение об ошибке
400Invalid report id
404Backlinks 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-кодСообщение об ошибке
400Invalid report id
404Backlink report not found