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

`filtercomplex` Комплексная проверка страницы на фильтры Яндекса

Проверяет страницу по запросу и региону на типичные причины, по которым она не ранжируется в Яндексе: индексация и запрет индексации, кворум, Adult-фильтр, фильтр одинаковых сниппетов, возраст документа, дубли по Title, текстовые пост-фильтры. Метод синхронный: ответ приходит, когда проверка закончена. То же, что инструмент Комплексная проверка на фильтры Яндекса.

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

Проверка на фильтры

GET /api/filtercomplex

Проверки идут по порядку и останавливаются на первой найденной причине: если документа нет в индексе, дальше проверяются только код ответа и запреты индексации; если найден Adult-фильтр или фильтр одинаковых сниппетов — остальное не проверяется.

Каждая проверка — десятки запросов к выдаче, поэтому ответ может идти несколько минут. Ставьте таймаут HTTP-клиента не меньше 5 минут.

Параметры query

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

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

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

Адрес проверяемой страницы. Без протокола подставляется https://.
lr int обязательный

Регион Яндекса, например 213 — Москва.
rel_url string

Проверять не url, а релевантную страницу сайта по выдаче. Только в query-строке.

on
определить релевантную страницу

Ответ

text string

Вывод проверки по-русски; строки разделены <br>, может содержать HTML.
flag string

Итог: ok — фильтров нет, warning — есть риски, error — найден фильтр или проблема, alert — документа нет в индексе, остальные проверки не проводились.
position int|string

Позиция сайта по запросу в ТОП-100; "-", если сайта нет.
relevant_URL string

Релевантная страница сайта в выдаче; "-", если сайта нет.
relevant_URL_status bool

true, если релевантная страница не совпадает с проверяемой.
filters_status object

Проведённые проверки: название → Да, Нет или Вероятно.
analyzed_URL string

Страница, которую проверили на самом деле (с rel_url=on — релевантная).
user_query string

Запрос.

GET /api/filtercomplex

curl -G 'https://tools.pixelplus.ru/api/filtercomplex' \
  --data-urlencode 'key=ВАШ_КЛЮЧ' \
  --data-urlencode 'query=купить диван' \
  --data-urlencode 'url=https://example.ru/catalog/divany/' \
  --data-urlencode 'lr=213'

<?php
$url = 'https://tools.pixelplus.ru/api/filtercomplex?' . http_build_query([
    'key' => 'ВАШ_КЛЮЧ',
    'query' => 'купить диван',
    'url' => 'https://example.ru/catalog/divany/',
    '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/filtercomplex",
    params={
        "key": "ВАШ_КЛЮЧ",
        "query": "купить диван",
        "url": "https://example.ru/catalog/divany/",
        "lr": 213,
    },
    timeout=60,
)
print(response.json())

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

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

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

{
    "text": "Фильтров не обнаружено.",
    "flag": "ok",
    "position": 7,
    "relevant_URL": "https://example.ru/catalog/divany/",
    "relevant_URL_status": false,
    "filters_status": {
        "Adult-фильтр": "Нет",
        "Фильтр на одинаковые сниппеты": "Нет",
        "Дубли документа по тегу Title": "Нет",
        "Проверка на текстовые пост-фильтры": "Нет"
    },
    "analyzed_URL": "https://example.ru/catalog/divany/",
    "user_query": "купить диван"
}

Ошибки

Код	Сообщение	Когда
`-50`	`Not set`	Не передан `query`, `url` или `lr`. Сообщается первый недостающий; имя параметра — ключ в ответе.
`-68`	`Not enough daily limits`	На аккаунте не осталось лимитов. Для тарифов с ограничением по периодам — также `-80`, `-81`, `-82`, `-83`.
`-1`	`Access denied`	Не передан `key`. HTTP-код 404.
`-2`	`Access denied`	Ключ не найден. HTTP-код 403.

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

{
    "url": "Not set",
    "code": "-50"
}

query, url и lr можно передать и в query-строке, и в теле POST; rel_url читается только из query-строки. Проверяется лишь наличие параметра: пустое значение ошибкой не считается.