Инструменты · key

`advanced` Релевантность зон документа: title, текст, точное вхождение

Показывает, какая зона документа ранжируется по запросу: снимает позицию сайта в выдаче Яндекса в пяти вариантах запроса — обычном, только по title, только по тексту, цитатном и без СПЕКТРа. Метод синхронный, ответ приходит после пяти запросов к выдаче. Веб-версия — инструмент «Релевантность зон документа».

Режим: синхронный
Поисковая система: Яндекс
Стоимость: лимиты не списываются, но на балансе должен быть хотя бы 1 лимит

Позиции сайта по зонам документа

GET /api/advanced

Из url берётся домен; позиция — первый документ этого домена или его поддоменов в выдаче. Все параметры читаются только из query-строки.

Параметры query

key string обязательный

Ключ API из настроек аккаунта.
url string обязательный

Адрес или домен сайта. Кириллический домен переводится в punycode.
query string обязательный

Поисковый запрос.
lr int обязательный

Регион Яндекса, код lr.

Ответ

Массив из пяти элементов — по одному на вариант запроса.

[].type string

Вариант запроса.

type	Что ищется
Исходный запрос	запрос как есть
Поиск по Title	`title:(запрос)` — только заголовок
Поиск по тексту	`intext:(запрос)` — только текст
Цитатный поиск	`"запрос"` — точная фраза
Без СПЕКТРа и СНСС	запрос со служебными операторами, отключающими СПЕКТР и СНСС

[].position int|string

Позиция сайта или строка Ниже ТОП-100.
[].rel_url string

Найденная страница сайта или Не определен.

GET /api/advanced

curl -G 'https://tools.pixelplus.ru/api/advanced' \
  --data-urlencode 'key=ВАШ_КЛЮЧ' \
  --data-urlencode 'url=pixelplus.ru' \
  --data-urlencode 'query=продвижение сайтов' \
  --data-urlencode 'lr=213'

<?php
$url = 'https://tools.pixelplus.ru/api/advanced?' . http_build_query([
    'key' => 'ВАШ_КЛЮЧ',
    'url' => 'pixelplus.ru',
    'query' => 'продвижение сайтов',
    'lr' => 213,
]);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($response);

import requests

response = requests.get(
    "https://tools.pixelplus.ru/api/advanced",
    params={
        "key": "ВАШ_КЛЮЧ",
        "url": "pixelplus.ru",
        "query": "продвижение сайтов",
        "lr": 213,
    },
    timeout=60,
)
print(response.json())

url обязательный Адрес или домен сайта query обязательный Поисковый запрос lr обязательный Регион Яндекса, код lr

Запрос настоящий — выполнится с вашим ключом

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

[
    {
        "type": "Исходный запрос",
        "position": 4,
        "rel_url": "https://pixelplus.ru/services/seo/"
    },
    {
        "type": "Поиск по Title",
        "position": 2,
        "rel_url": "https://pixelplus.ru/services/seo/"
    },
    {
        "type": "Поиск по тексту",
        "position": 7,
        "rel_url": "https://pixelplus.ru/"
    },
    {
        "type": "Цитатный поиск",
        "position": 3,
        "rel_url": "https://pixelplus.ru/services/seo/"
    },
    {
        "type": "Без СПЕКТРа и СНСС",
        "position": "Ниже ТОП-100",
        "rel_url": "Не определен"
    }
]

Ошибки

Код	Сообщение	Когда
`-50`	`Not set`	Не передан или пуст `query`, `url` или `lr`. Ключом ошибки служит имя параметра, в ответе только незаполненные.
`-68, -80…-83`	`Not enough … limits`	На балансе нет ни одного лимита.
`-1, -2`	`Access denied`	Ключ не передан (HTTP 404) или не найден (HTTP 403).

Ответ с ошибкой

{
    "query": "Not set",
    "lr": "Not set",
    "code": -50
}

Как читать ответ

Сравнивайте позиции между вариантами. Высокая позиция по title: при низкой по intext: — страница ранжируется за счёт заголовка, текст проработан слабее; и наоборот. Если в цитатном поиске сайт высоко, а в обычном — нет, точное вхождение есть, но документ проигрывает по другим факторам. Разные rel_url в вариантах означают, что за запрос конкурируют несколько страниц сайта.