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

`fastcheckgoogle` Позиции сайта в Google по списку запросов

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

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

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

POST /api/fastcheckgoogle

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

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

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

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

Сайт, позиции которого ищем. Должен содержать точку — иначе Not set.
lr int обязательный

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

Запросы: массив requests[] или одна строка, запросы через перенос строки.
mobile int

Проверять мобильную выдачу. Именно mobile, не ismobile, как в fastcheck.

0
десктоп

1
мобильная

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

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

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

Глубина проверки. Выдача Google снимается не глубже 100; больше 200 — ошибка.

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

Сохраняется в параметрах задачи, но на проверку не влияет: регион задаёт lr.

Ответ

report_id int

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

POST /api/fastcheckgoogle

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

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

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

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

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

{
    "report_id": 51234568
}

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

GET /api/fastcheckgoogle

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

Параметры query

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

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

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

Ответ

request object

Параметры задачи: req_array (массив запросов), url, lr, mobile, subdomains, search_engine, 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
    
    Та же страница полным адресом.
- queries_count int
  
  Сколько уникальных запросов проверено.
- subdomains string
  
  Значение subdomains из задачи.
- plarform string
  
  desktop или mobile. Имя поля с опечаткой — так в ответе.

GET /api/fastcheckgoogle

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

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

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

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

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

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

{
    "request": {
        "req_array": [
            "купить диван",
            "диван угловой"
        ],
        "url": "example.ru",
        "lr": "213",
        "mobile": "0",
        "subdomains": null,
        "search_engine": null,
        "deep": 100
    },
    "response": {
        "top1": 0,
        "top3": 0,
        "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": 5
            },
            "диван угловой": {
                "relevant_URL": "-",
                "full_relevant_URL": "-",
                "position": 1000
            }
        },
        "queries_count": 2,
        "subdomains": null,
        "plarform": "desktop"
    }
}

Ошибки

Код	Сообщение	Когда
`-50`	`Not set`	Не передан `url`, `lr` или `requests` — каждый пропущенный параметр приходит ключом. При `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",
    "lr": "Not set",
    "requests": "Not set",
    "code": -50
}

Стоимость

Число строк в requests × цена запроса Google по глубине:

deep	Лимитов за запрос
10	1
20	2
30	3
50	4
100	6
200	12

Дубли запросов оплачиваются, хотя проверяются один раз — уберите их до отправки. Глубина больше 100 стоит дороже, но выдача всё равно снимается до 100 позиций — передавайте deep не больше 100.

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

fastcheckgoogle Позиции сайта в Google по списку запросов

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

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

Ответ

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

Параметры query

Ответ

Ошибки

Стоимость

`fastcheckgoogle` Позиции сайта в Google по списку запросов