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

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

Список бэклинков

Описание

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

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

 GET /backlinks/{site_id}?limit=100&offset=100 

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

ИмяОбязательныйОписание
limitНетКоличество ссылок. Максимум 1000
offsetНетСмещение

Результат

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

Пример

[
{
«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»: «https://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»: «»,
«notes»: «ghjg»,
«num_links»: 10,
«price»: null,
«source»: null,
«src_domain_alexa»: null,
«src_domain_alexa_date»: 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,
«src_domain_yandex_x»: null,
«src_domain_yandex_x_date»: null,
«title»: «Title»,
«to_url»: «https://tourl.ru/»,
«total_ext_links»: «2»,
«ugc»: null,
«yin_index»: «12»,
«yin_index_check_date»: «2018-10-05»
},

]

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

ИмяОписание
anchorАнкор обратной ссылки
idID ссылки
categoryЦелевая категория обратной ссылки
charge_periodПериод оплаты стоимости (onetime – единоразово, monthly – за месяц, quarterly – за квартал, 6months – за полгода, year – за год)
charge_startДата начала оплаты
date_addedДата добавления ссылки
date_lostДата потери ссылки
date_placementДата размещения обратной ссылки
domainДомен страницы, ссылающейся на ваш сайт
durationПродолжительность размещения обратной ссылки согласно договоренностям с донором
fb_likesСколько человек поделились данной страницей в Facebook
from_domainidID домена ссылки
from_urlАдрес страницы, ссылающейся на ваш сайт
gin_indexПроиндексирована ли страница с обратной ссылкой в Google
gin_index_check_dateДата проверки
http_statusHttp-статус страницы с ссылкой
is_blocked_metaСтраница блокирована через meta-заголовок
is_forced_statusСтатус был изменен вручную
is_blocked_robotstxtБлокирована через robots.txt
is_disavowСсылка является disavow
is_forced_statusСтатус был изменен вручную
is_imageСсылка на изображении
is_link_not_foundОбратная ссылка на странице не найдена
is_nofollowСсылка закрыта от индексации
is_redirСтраница перенаправляет на другую страницу
is_sponsoredСсылка является спонсорской
last_crawler_visitДата последней проверки
link_managerОтветственное лицо
link_typeТип анкора обратной ссылки
notesПримечание
num_linksКол-во ссылок
priceЦена размещения ссылки
sourceИсточник
src_domain_alexaAlexa домена обратной ссылки
src_domain_alexa_dateДата проверки Alexa
src_domain_countryСтрана
src_domain_inlink_rankРанк домена
src_domain_ipСсылающиеся IP адреса
src_domain_mozda_dateДата проверки
src_domain_region_idId региона
src_domain_yandex_xYandex X (ИКС)
src_domain_yandex_x_dateДата проверки
titleTitle страницы
to_urlСсылается на страницу
total_ext_linksЧисло внешних ссылок, найденных на странице с обратной ссылкой
ugcUGC (пользовательский контент)
yin_indexПроиндексирована ли страница с обратной ссылкой в Yandex
yin_index_check_dateДата проверки

Error

HTTP-кодСообщение об ошибке
403Access denied (wrong site_id)

Добавление бэклинка

POST /backlinks/{site_id}
{
«url»: «https://backlink.test/»,
«price»: 1,
«charge_period»: «onetime»,
«charge_start»: «2018-01-01»
}

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

ИмяОбязательныйОписание
urlДаСсылка
priceНетСтоимость
currencyНетКод валюты ISO 4217 (USD, CAD, AUD, etc.)
charge_periodНетОплата стоимости (onetime – единоразово, monthly – за месяц)
charge_startНетОплата с даты

Результат

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

Пример

{
«id»: 1
}

Ошибки

HTTP-кодСообщение об ошибке
400Invalid URL
400Backlinks limit exceeded
400Backlink already exist
403Access denied (wrong site_id)

Импорт списка бэклинков

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

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

 POST /backlinks/{site_id}/list
{
«group_id»: 1,
«price»: 100,
«currency»: «USD»,
«manager»: «manager»,
«charge_period»: «onetime»,
«charge_start»: «2021-10-10»,
«list»: [
«https://google.com»,
«https://yandex.ru»
]
}

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

ИмяОбязательныйОписание
site_idДаid сайта
listДаМассив бэклинков
priceНетСтоимость
currencyНетКод валюты ISO 4217 (USD, CAD, AUD, etc.)
charge_periodНетПериод оплаты стоимости (onetime – единоразово, monthly – за месяц, quarterly – за квартал, 6months – за полгода, year – за год)
charge_startНетОплата с даты, формат (Y-m-d)
group_idНетid группы бэклинков
managerНетМенеджер

Результат

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

Пример

 {
«added»: 2,
«duplicates»: 0,
«total»: 2
}

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

ИмяОписание
addedКол-во добавленных бэклинков
duplicatesКол-во дубликатов бэклинков
totalОбщее кол-во бэклинков

Error

HTTP-кодСообщение об ошибке
403Access denied (wrong site_id)

Обновление настроек запуска импорта бэклинков

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

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

 PUT /backlinks/{site_id}/settings
{
«gsc_autoimport»: true,
}

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

ИмяОбязательныйОписание
site_idДаid сайта
gsc_autoimportДаtrue или false, включить или отключить автоимпорт из GSC

Результат

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

Ошибки

HTTP-кодСообщение об ошибке
403Access denied (wrong site_id)

Запуск импорта бэклинков из Google Search Console

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

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

POST /backlinks/{site_id}/import-gsc

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

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

Результат

В случае успеха сервер возвращает статус задачи импорта и токен задачи импорта, по которому можно проверять статус в дальнейшем.

Пример

{
«status»: «queued»,
«token»: «1c84d0375d44725521647919c17f1cb9»
}

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

ИмяОписание
statusСтатус задачи импорта
tokenТокен задачи импорта

Ошибки

HTTP-кодСообщение об ошибке
403Access denied (wrong site_id)

Получение статуса импорта бэклинков из Google Search Console

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

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

GET /backlinks/{site_id}/import-status

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

ИмяОбязательныйОписание
site_idДаid сайта
tokenДаtoken задачи импорта, полученный в методе запуска импорта бэклинков

Результат

В случае успеха сервер возвращает статус задачи импорта и время в формате timestamp.

Пример

{
«time»: 1635417036150,
«status»: «queued»
}

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

ИмяОписание
statusСтатус задачи импорта
timeВремя в формате timestamp

Ошибки

HTTP-кодСообщение об ошибке
403Access denied (wrong site_id)

Удаление списка бэклинков

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

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

POST /backlinks/{site_id}/delete
{
«backlink_ids»: [
1,
2,
3
]
}

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

ИмяОбязательныйОписание
site_idДаid сайта
backlink_idsДаМассив ids бэклинков

Результат

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

Ошибки

HTTP-кодСообщение об ошибке
403Access denied (wrong site_id)
400Invalid ids

Запуск проверки индекса/статуса бэклинков

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

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

POST /backlinks/{site_id}/recheck
{
«backlink_ids»: [
1,
2
],
«recheck_type»:»index»
}

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

ИмяОбязательныйОписание
site_idДаid сайта
backlink_idsДаМассив ids бэклинков
recheck_typeНетТип проверки, возможные значения: status, index. Если не передать параметр, по умолчанию будет использоваться recheck_type=status

Результат

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

Ошибки

HTTP-кодСообщение об ошибке
403Access denied (wrong site_id)
400Invalid ids

Статистика по бэклинкам

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

 GET /backlinks/{site_id}/stat 

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

ИмяОбязательныйОписание
site_idДаID сайта

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

{
«total»: 9,
«anchors»: 1,
«ip»: 8,
«domains»: 9,
«dofollow»: 0,
«nofollow»: 1,
«limit»: 988
}

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

ИмяОписание
totalВсего ссылок
anchorsКоличество уникальных анкоров
ipКоличество уникальных IP адресов
domainsКоличество уникальных доменов
dofollowКоличество ссылок dofollow
nofollowКоличество ссылок nofollow
limitЛимит на добавление ссылок. Доступно для добавления сегодня

Ошибки

HTTP-кодСообщение об ошибке
403Access denied (wrong site_id)

Список disavow-ссылок

Метод позволяет получить список и количество disavow-ссылок для сайта.

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

GET /backlink-disavow/{site_id}?limit=100&offset=0

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

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

Результат

В случае успеха сервер возвращает список и количество disavow-ссылок для сайта.

Пример

{
«total_disavow_links»: 2,
«disavow_links»: [
{
«id»: 3,
«url»: «https://yandex.ru»,
«type»: «url»,
«exported»: 0,
«alexa»: null,
«yandex_x»: null,
«domain_inlink_rank»: 96
},
{
«id»: 4,
«url»: «https://google.com»,
«type»: «url»,
«exported»: 0,
«alexa»: null,
«yandex_x»: null,
«domain_inlink_rank»: 100
}
]
}

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

ИмяОписание
total_disavow_linksОбщее кол-во disavow-ссылок
disavow_linksМассив disavow-ссылок
idid disavow-ссылки
urlurl disavow-ссылки
typeТип ссылки
exportedЭкспортирована ли ссылка
alexaЗначение рейтинга в Alexa
yandex_xЗначение рейтинга в Яндекс ИКС
domain_inlink_rankРанк домена

Ошибки

HTTP-кодСообщение об ошибке
403Access denied (wrong site_id)

Добавление списка disavow-ссылок

Метод позволяет добавить список disavow-ссылок для сайта.

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

POST /backlink-disavow/{site_id}
{
«list»: [
«https://google.com»,
«https://yandex.ru»
]
}

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

ИмяОбязательныйОписание
site_idДаid сайта
listДаМассив ссылок

Результат

В случае успеха сервер возвращает кол-во добавленных disavow-ссылок.

Пример

{
«added»: 2
}

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

ИмяОписание
addedКол-во добавленных disavow-ссылок

Ошибки

HTTP-кодСообщение об ошибке
403Access denied (wrong site_id)
400Invalid list

Удаление disavow-ссылки

Метод позволяет удалить disavow-ссылку из списка disavow-ссылок для сайта.

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

DELETE /backlink-disavow/{site_id}?id={disavow_link_id}

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

ИмяОбязательныйОписание
site_idДаid сайта
disavow_link_idДаid disavow-ссылки

Результат

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

Ошибки

HTTP-кодСообщение об ошибке
403Access denied (wrong site_id)
400Invalid disawov link id
400Disawov link does not exist