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

`fastcheck` Позиции сайта в Яндексе по списку запросов

Снимает позиции сайта в Яндексе по списку запросов в выбранном регионе: позицию, релевантную страницу и сводку по ТОПам. Можно проверить мобильную выдачу или сравнить её с десктопной. Метод асинхронный: POST ставит задачу и возвращает report_id, результат забирается GET-запросом. Тот же инструмент в интерфейсе — Быстрый чек позиций.

Стоимость: 1 лимит за запрос при глубине 100, 2 — для мобильной выдачи
Режим: асинхронный: report_id
Запросов за задачу: до 300, на тарифах Эксперт, Гуру и Специальный — до 1000

Постановка задачи

POST /api/fastcheck

key передаётся в query-строке, остальные параметры — в теле формы. Лимиты списываются сразу при постановке задачи.

Параметры query и тело формы

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

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

Сайт, позиции которого ищем. Сравнивается по домену; www. не важен.
lr int обязательный

Регион Яндекса, например 213 — Москва.
requests array обязательный

Запросы: массив requests[] или одна строка, запросы через перенос строки. Дубли схлопываются.
ismobile int

Проверять мобильную выдачу.

0
десктоп

1
мобильная

По умолчанию 0
compare int

Снять обе выдачи и добавить в ответ таблицу сравнения comparePositionsArray.

0
нет

1
да

По умолчанию 0
subdomains int

Засчитывать позиции поддоменов сайта. Передавайте 1, только если нужно.

1
учитывать поддомены
deep int

Глубина проверки, не больше 200. Влияет на цену: множитель round(deep / 100).

По умолчанию 100

Ответ

report_id int

ID задачи — передайте его в GET-запросе за результатом.

POST /api/fastcheck

curl -X POST 'https://tools.pixelplus.ru/api/fastcheck?key=ВАШ_КЛЮЧ' \
  --data-urlencode 'url=example.ru' \
  --data-urlencode 'lr=213' \
  --data-urlencode 'requests[]=купить диван' \
  --data-urlencode 'requests[]=диван угловой'

<?php
$url = 'https://tools.pixelplus.ru/api/fastcheck?' . http_build_query([
    'key' => 'ВАШ_КЛЮЧ',
]);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_POSTFIELDS => http_build_query([
        'url' => 'example.ru',
        'lr' => 213,
        'requests' => [
            'купить диван',
            'диван угловой',
        ],
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($response);

import requests

response = requests.post(
    "https://tools.pixelplus.ru/api/fastcheck",
    params={
        "key": "ВАШ_КЛЮЧ",
    },
    data=[
        ("url", "example.ru"),
        ("lr", 213),
        ("requests[]", "купить диван"),
        ("requests[]", "диван угловой"),
    ],
    timeout=60,
)
print(response.json())

url обязательный Сайт, позиции которого ищем lr обязательный Регион Яндекса, например 213 — Москва requests обязательный Запросы: массив requests[] или одна строка, запросы через перенос строки · по одному на строку

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

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

{
    "report_id": 51234567
}

Получение результата

GET /api/fastcheck

Пока задача выполняется, приходит ошибка 50 — повторите запрос позже. Готовый ответ содержит параметры задачи (request) и результат (response).

Параметры query

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

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

ID задачи из ответа на постановку.

Ответ

request object

Параметры задачи: req_array (массив запросов), url, lr, ismobile, compare, subdomains, deep.
response object

Результат проверки.
Вложенные поля
- top1, top3, top5, top10, top20, top30, top50, top100 int
  
  Сколько запросов в ТОП-N.
- top100+ int
  
  Сколько запросов за пределами ТОП-100 или не найдено.
- queries object
  
  Запрос → результат по нему.
  Вложенные поля
  - position int
    
    Позиция сайта; 1000 — сайт не найден.
  - relevant_URL string
    
    Релевантная страница; "-", если не найдена.
  - full_relevant_URL string
    
    Та же страница полным адресом.
  - name string
    
    Запрос.
  - platform string
    
    desktop или mobile.
- queries_count int
  
  Сколько запросов проверено.
- subdomains string
  
  Значение subdomains из задачи.
- comparePositionsArray object
  
  Только при compare=1: запрос → name, desktopPosition, mobilePosition, difference (десктоп минус мобильная). Если сайт не найден, вместо числа "-".

GET /api/fastcheck

curl -G 'https://tools.pixelplus.ru/api/fastcheck' \
  --data-urlencode 'key=ВАШ_КЛЮЧ' \
  --data-urlencode 'report_id=51234567'

<?php
$url = 'https://tools.pixelplus.ru/api/fastcheck?' . http_build_query([
    'key' => 'ВАШ_КЛЮЧ',
    'report_id' => 51234567,
]);

$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/fastcheck",
    params={
        "key": "ВАШ_КЛЮЧ",
        "report_id": 51234567,
    },
    timeout=60,
)
print(response.json())

report_id обязательный ID задачи из ответа на постановку

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

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

{
    "request": {
        "req_array": [
            "купить диван",
            "диван угловой"
        ],
        "url": "example.ru",
        "lr": "213",
        "subdomains": null,
        "ismobile": "0",
        "compare": "0",
        "deep": 100
    },
    "response": {
        "top1": 0,
        "top3": 1,
        "top5": 1,
        "top10": 1,
        "top20": 1,
        "top30": 1,
        "top50": 1,
        "top100": 1,
        "top100+": 1,
        "queries": {
            "купить диван": {
                "relevant_URL": "example.ru/catalog/divany/",
                "full_relevant_URL": "https://example.ru/catalog/divany/",
                "position": 3,
                "name": "купить диван",
                "platform": "desktop"
            },
            "диван угловой": {
                "relevant_URL": "-",
                "full_relevant_URL": "-",
                "position": 1000,
                "name": "диван угловой",
                "platform": "desktop"
            }
        },
        "queries_count": 2,
        "subdomains": null
    }
}

Ошибки

Код	Сообщение	Когда
`-50`	`Not set`	Не передан `url`, `lr` или `requests` — каждый пропущенный параметр приходит ключом. GET без `report_id` тоже даёт `{"requests":"Not set"}`. При `deep` больше 200 — `{"deep":"Max value: 200"}`.
`-67`	`To much requests`	Запросов больше, чем позволяет тариф (300 или 1000).
`-60`	`To many tasks from one user. Try again later.`	У пользователя уже больше трёх задач этого инструмента в работе.
`50`	`In progress`	Задача ещё выполняется.
`-4`	`Access denied`	`report_id` принадлежит другому пользователю или другому инструменту.
`-104`	`Processing error`	Задача завершилась с ошибкой.
`-105`	`Limits run out`	Во время выполнения закончились лимиты.
`-106`	`The process was canceled by a user`	Задачу отменили.
`-107`	`The process took more than 6 hours and was canceled`	Задача шла дольше 6 часов и была остановлена.
`-125`	`Processing error`	Непредвиденный статус задачи.
`-68`	`Not enough daily limits`	На аккаунте не осталось лимитов. Для тарифов с ограничением по периодам — также `-80` (час), `-81` (неделя), `-82` (месяц), `-83` (год).
`-1`	`Access denied`	Не передан `key`. HTTP-код 404.
`-2`	`Access denied`	Ключ не найден. HTTP-код 403.

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

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

Стоимость

Уникальные запросы × round(deep / 100) × 2 при ismobile=1 (иначе × 1). При глубине 100 — 1 лимит за запрос десктопа, 2 — мобильной выдачи; при 200 — вдвое больше. compare=1 цену не меняет.

Перед постановкой метод проверяет только, что на аккаунте есть хотя бы 1 лимит, а не всю стоимость задачи. Сверяйте остаток заранее через getlimits.

Как ищется сайт

Позиция — первое вхождение домена из url в выдаче. Если в выдаче сайт не найден, метод дополнительно ищет релевантную страницу запросом с site: (для десктопной выдачи): relevant_URL заполняется, а позиция остаётся 1000.

fastcheck Позиции сайта в Яндексе по списку запросов

Постановка задачи

Параметры query и тело формы

Ответ

Получение результата

Параметры query

Ответ

Ошибки

Стоимость

Как ищется сайт

`fastcheck` Позиции сайта в Яндексе по списку запросов