Содержание
Бэклинки
Список бэклинков
Описание
Список бэклинков сайта.
Формат запроса
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_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_forced_status»: «0»,
«is_image»: «1»,
«is_link_not_found»: «1»,
«is_nofollow»: «1»,
«is_redir»: «1»,
«last_crawler_visit»: «2018-10-05»,
«link_manager»: «»,
«link_type»: «»,
«notes»: «ghjg»,
«price»: null,
«source»: null,
«src_domain_alexa»: null,
«src_domain_alexa_date»: null,
«src_domain_country»: «USA»,
«src_domain_ip»: «184.168.221.40»,
«src_domain_yandex_x»: null,
«src_domain_yandex_x_date»: null,
«to_url»: «https://tourl.ru/»,
«total_ext_links»: «2»,
«yin_index»: «12»,
«yin_index_check_date»: «2018-10-05»
},
…
]Парамеры ответа
| Имя | Описание |
| anchor | Анкор обратной ссылки |
| id | ID ссылки |
| category | Целевая категория обратной ссылки |
| charge_period | Период оплаты стоимости. (onetime, monthly, quaterly, 6months, year) |
| charge_start | Дата начала оплаты |
| date_added | Дата добавления ссылки |
| date_placement | Дата размещения обратной ссылки |
| domain | Домен страницы, ссылающейся на ваш сайт |
| duration | Продолжительность размещения обратной ссылки согласно договоренностям с донором |
| fb_likes | Сколько человек поделились данной страницей в Facebook |
| from_domainid | ID домена ссылки |
| from_url | Адрес страницы, ссылающейся на ваш сайт |
| gin_index | Проиндексирована ли страница с обратной ссылкой в Google |
| gin_index_check_date | Дата проверки |
| http_status | Http-статус страницы с ссылкой |
| is_blocked_meta | Страница блокирована через meta-заголовок |
| is_forced_status | Статус был изменен вручную |
| is_blocked_robotstxt | Блокирована через robots.txt |
| is_forced_status | Статус был изменен вручную |
| is_image | Ссылка на изображении |
| is_link_not_found | Обратная ссылка на странице не найдена |
| is_nofollow | Ссылка закрыта от индексации |
| is_redir | Страница перенаправляет на другую страницу |
| last_crawler_visit | Дата последней проверки |
| link_manager | Ответственное лицо |
| link_type | Тип анкора обратной ссылки |
| notes | Примечание |
| price | Цена размещения ссылки |
| source | Источник |
| src_domain_ alexa | Alexa домена обратной ссылки |
| src_domain_ alexa_date | Дата проверки Alexa |
| src_domain_ country | Страна |
| src_domain_ ip | Ссылающиеся IP адреса |
| src_domain_ yandex_x | Yandex X (ИКС) |
| src_domain_ x_date | Дата проверки |
| to_url | Ссылается на страницу |
| total_ext_links | Число внешних ссылок, найденных на странице с обратной ссылкой |
| yin_index | Проиндексирована ли страница с обратной ссылкой в Yandex |
| yin_index_check_date | Дата проверки |
Добавление бэклинка
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-код | Сообщение об ошибке |
| 400 | Invalid URL |
| 400 | Backlinks limit exceeded |
| 400 | Backlink already exist |
Удаление бэклинка
Формат запроса
DELETE /backlinks/{backlink_id}Параметры в запросе
| Имя | Обязательный | Описание |
| backlink_id | Да | ID ссылки |
Result
В случае успеха сервер возвращает HTTP 204.
Статистика по бэклинкам
Формат запроса
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 | Лимит на добавление ссылок. Доступно для добавления сегодня |