DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Сводка обратных ссылок
Весь профиль обратных ссылок одного target за один вызов: first_seen, lost_date, rank, backlinks, backlinks_spam_score, crawled_pages, internal_links_count и блок info, а также счётчики ссылающихся доменов и анкоров. Это центр семейства: начинайте здесь, затем углубляйтесь в нужную часть — post_dataforseo_backlinks_backlinks_live для отдельных ссылок, post_dataforseo_backlinks_referring_domains_live для того, кто ссылается, post_dataforseo_backlinks_anchors_live для используемого текста. Здесь нет параметра limit, поэтому единственный способ сократить расходы — вызывать эндпоинт реже.
Справочные цены
- Тарификация: стоимость ответа по данным провайдера.
- Справочная оценка запроса: USD 0.024.
- Справочный множитель для клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента.
Только справочные метаданные, а не коммерческое предложение для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo.
- Тип: array (object | null)[]
- backlinksТип: array (object | null)[] | null
_filters фильтрует обратные ссылки вашего
target
необязательное поле
это поле позволяет отфильтровать исходные обратные ссылки, которые войдут в набор данных для агрегированных метрик по вашемуtarget
обратные ссылки можно фильтровать по всем полям, доступным в ответе этого эндпоинта
с помощью этого параметра можно включить в ответ только dofollow-обратные ссылки и создать гибкий набор данных обратных ссылок для расчёта метрик
пример:"backlinks_filters": ["dofollow", "=", true]Пустой объект - backlinksТип: string | null
_status _type выбор возвращаемых и учитываемых обратных ссылок
необязательное поле
это поле позволяет выбрать, какие обратные ссылки будут возвращены и использованы для агрегированных метрик по вашемуtarget;
возможные значения:all— возвращаются и учитываются все обратные ссылки;live— возвращаются и учитываются обратные ссылки, найденные при последней проверке;lost— возвращаются и учитываются потерянные обратные ссылки;значение по умолчанию:
live - excludeТип: boolean | null
_internal _backlinks указывает, исключаются ли из результатов внутренние обратные ссылки с поддоменов на
target
необязательное поле
если заданоtrue, результаты не будут содержать данные о внутренних обратных ссылках с поддоменов того же домена, что иtarget
если заданоfalse, внутренние ссылки будут включены в результаты
значение по умолчанию:true - includeТип: boolean | null
_indirect _links указывает, будут ли включены в результаты косвенные ссылки на
target
необязательное поле
если заданоtrue, результаты будут включать данные о косвенных ссылках, ведущих на страницу, которая либо перенаправляет на target, либо указывает на каноническую страницу
если заданоfalse, косвенные ссылки игнорируются
значение по умолчанию:true - includeТип: boolean | null
_subdomains указывает, включаются ли поддомены
targetв поиск
необязательное поле
если заданоfalse, поддомены игнорируются
значение по умолчанию:true - internalТип: integer | null
_list _limit максимальное количество элементов во внутренних массивах
необязательное поле
это поле ограничивает количество элементов в следующих массивах:referring_links_tldreferring_links_typesreferring_links_attributesreferring_links_platform_typesreferring_links_semantic_locationsзначение по умолчанию:
10
максимальное значение:1000 - rankТип: string | null
_scale определяет шкалу, используемую для расчёта и отображения значений
rank,domain_from_rankиpage_from_rank
необязательное полеэтот параметр позволяет выбрать, будут ли значения ранга представлены по шкале 0–100 или 0–1000
возможные значения:
one_hundred— значения ранга отображаются по шкале 0–100one_thousand— значения ранга отображаются по шкале 0–1000значение по умолчанию:
one_thousandКак работает этот параметр и как рассчитываются метрики ранжирования, описано в этой статье Help Center
- tagТип: string | null
пользовательский идентификатор задачи
необязательное поле
ограничение — 255 символов
этот параметр позволяет идентифицировать задачу и сопоставить её с результатом
указанное значениеtagвы найдёте в объектеdataответа - targetТип: string
домен, поддомен или веб-страница, для которых нужно получить данные
обязательное поле
домен или поддомен указывается безhttps://иwww.
страница указывается абсолютным URL (включаяhttp://илиhttps://)
- Тип: object | null · Response36Afe1097B20_BacklinksSummaryLiveResponseInfo200
- Тип: number | null Формат: doublecost
общая стоимость задач, USD
- Тип: integer | nullstatus
_code общий код состояния. Полный список кодов ответа можно найти здесь.
- Тип: string | nullstatus
_message общее информационное сообщение. Полный список общих информационных сообщений можно найти здесь.
- Тип: array (object | null)[] | nulltasks
массив задач
- Тип: object | null · Response36Afe1097B20_BacklinksSummaryLiveTaskInfo
- costТип: number | null Формат: double
общая стоимость задач, USD
- dataТип: object | null
содержит те же параметры, что вы указали в POST-запросе
- propertyТип: object | null
Name
- idТип: string | null
идентификатор задачи уникальный идентификатор задачи в нашей системе в формате UUID
- pathТип: array (string | null)[] | null
путь URL
- resultТип: array (object | null)[] | null
массив результатов
- backlinksТип: integer | null Формат: int64
указывает количество обратных ссылок
- backlinksТип: integer | null Формат: int64
_spam _score - brokenТип: integer | null Формат: int64
_backlinks количество битых обратных ссылок
количество битых обратных ссылок, указывающих наtarget - brokenТип: integer | null
_pages количество битых страниц
количество страниц наtarget, отвечающих кодами состояния 4xx или 5xxучтите, что количество битых страниц включает страницы на
target, обнаруженные переходом по внешним ссылкам, но также может включать страницы, обнаруженные по карте сайта target - crawledТип: integer | null
_pages количество просканированных страниц для
target - externalТип: integer | null Формат: int64
_links _count количество внешних ссылок на странице
вычисляется как сумма внешних ссылок на страницах указанногоtarget - firstТип: string | null
_seen дата и время, когда наш краулер впервые обнаружил обратную ссылку для
target
в формате UTC: “yyyy-mm-dd hh-mm-ss +00:00”
пример:2019-11-15 12:57:46 +00:00 - infoТип: object | null · Response36Afe1097B20_TargetInfo
информация о
target- cmsТип: string | null
система управления контентом
- countryТип: string | null
код страны, к которой, как определено, относится домен
target - ipТип: string | null
_address IP-адрес
target - isТип: boolean | null
_ip указывает, является ли
targetIP-адресом
еслиtrue, домен, поддомен или веб-страница функционирует как IP-адрес и не имеет доменного имени - platformТип: array (string | null)[] | null
_type тип платформы
- serverТип: string | null
сервер
- targetТип: integer | null
_spam _score
- internalТип: integer | null Формат: int64
_links _count количество внутренних ссылок
вычисляется как сумма внутренних ссылок на страницах указанногоtarget - lostТип: string | null
_date дата и время, когда обратная ссылка была потеряна
указывает дату и время, когда наш краулер посетил target и он ответил кодом состояния 4xx или 5xx, либо когда его последняя обратная ссылка была удалена
в формате UTC: “yyyy-mm-dd hh-mm-ss +00:00”
пример:2019-11-15 12:57:46 +00:00 - rankТип: integer | null
- referringТип: integer | null Формат: int64
_domains указывает количество ссылающихся доменов
ссылающиеся домены включают поддомены, которые для этой метрики считаются отдельными доменами - referringТип: integer | null Формат: int64
_domains _nofollow количество доменов, передающих
targetхотя бы одну nofollow-ссылку - referringТип: integer | null Формат: int64
_ips количество ссылающихся IP-адресов
количество IP-адресов, указывающих на эту страницу - referringТип: object | null
_links _attributes атрибуты ссылающихся ссылок
указывает атрибуты ссылающихся ссылок и количество ссылок для каждого атрибута
примеры значений:nofollow,noopener,noreferrer,external,ugc,sponsored- propertyТип: integer | null Формат: int64
Name Signed 64-bit integers (long type).
- referringТип: object | null
_links _countries коды стран ISO ссылающихся ссылок
указывает коды стран ISO доменов, где расположены ссылающиеся ссылки, и количество ссылок для каждой страны- propertyТип: integer | null Формат: int64
Name Signed 64-bit integers (long type).
- referringТип: object | null
_links _platform _types типы ссылающихся платформ
указывает типы ссылающихся платформ и количество ссылок для каждой платформывозможные значения:
cms,blogs,ecommerce,message-boards,wikis,news,organization- propertyТип: integer | null Формат: int64
Name Signed 64-bit integers (long type).
- referringТип: object | null
_links _semantic _locations - propertyТип: integer | null Формат: int64
Name Signed 64-bit integers (long type).
- referringТип: object | null
_links _tld домены верхнего уровня ссылающихся ссылок
содержит домены верхнего уровня и количество ссылающихся ссылок для каждого- propertyТип: integer | null Формат: int64
Name Signed 64-bit integers (long type).
- referringТип: object | null
_links _types типы ссылающихся ссылок
указывает типы ссылающихся ссылок и количество ссылок каждого типа
возможные значения:anchor,image,link,meta,canonical,alternate,redirect- propertyТип: integer | null Формат: int64
Name Signed 64-bit integers (long type).
- referringТип: integer | null Формат: int64
_main _domains указывает количество ссылающихся основных доменов
- referringТип: integer | null Формат: int64
_main _domains _nofollow количество основных доменов, передающих
targetхотя бы одну nofollow-ссылку - referringТип: integer | null Формат: int64
_pages указывает количество страниц, ссылающихся на target
- referringТип: integer | null Формат: int64
_pages _nofollow количество ссылающихся страниц, передающих
targetхотя бы одну nofollow-ссылку - referringТип: integer | null Формат: int64
_subnets количество ссылающихся подсетей
- targetТип: string | null
targetв POST-массиве
- resultТип: integer | null Формат: int64
_count число элементов в массиве result
- statusТип: integer | null
_code код состояния задачи формируется DataForSEO, может находиться в диапазоне 10000-60000 Полный список кодов ответа можно найти здесь.
- statusТип: string | null
_message информационное сообщение задачи Полный список общих информационных сообщений можно найти здесь.
- timeТип: string | null
время выполнения, секунды
- Тип: integer | null Формат: int64tasks
_count число задач в массиве tasks
- Тип: integer | null Формат: int64tasks
_error число задач в массиве tasks, возвращённых с ошибкой
- Тип: string | nulltime
общее время выполнения, секунды
- Тип: string | nullversion
текущая версия API
application/json - 400
Запрос не удалось обработать. Проверьте параметры запроса.
- 401
Требуется действительный API-ключ Felo.
- 402
Запрос не может быть выполнен: не выполнено требование биллинга.
- 403
Аккаунту не разрешено выполнять эту операцию.
- 429
Достигнут лимит запросов или расходов.
- 502
Сервис не смог выполнить запрос.
- 503
API или сервис биллинга временно недоступны.
- 504
Истекло время ожидания обработки запроса.
- default
Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/summary/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "explodingtopics.com",
"internal_list_limit": 10,
"include_subdomains": true,
"backlinks_filters": [
"dofollow",
"=",
true
],
"backlinks_status_type": "all"
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"target": null,
"first_seen": null,
"lost_date": null,
"rank": null,
"backlinks": null,
"backlinks_spam_score": null,
"crawled_pages": null,
"info": {
"server": null,
"cms": null,
"platform_type": [
"[Max Depth Exceeded]"
],
"ip_address": null,
"country": null,
"is_ip": null,
"target_spam_score": null
},
"internal_links_count": null,
"external_links_count": null,
"broken_backlinks": null,
"broken_pages": null,
"referring_domains": null,
"referring_domains_nofollow": null,
"referring_main_domains": null,
"referring_main_domains_nofollow": null,
"referring_ips": null,
"referring_subnets": null,
"referring_pages": null,
"referring_pages_nofollow": null,
"referring_links_tld": null,
"referring_links_types": null,
"referring_links_attributes": null,
"referring_links_platform_types": null,
"referring_links_semantic_locations": null,
"referring_links_countries": null
}
]
}
]
}