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

`podskazkigoogle` Сбор поисковых подсказок Google

Собирает поисковые подсказки Google для фразы (GET) или списка фраз (POST), с перебором букв и цифр и вглубь до трёх уровней. Метод асинхронный: постановка отдаёт report_id, по нему забирается результат. В интерфейсе — Поисковые подсказки Google.

Режим: асинхронный: report_id
Стоимость: 1 лимит за фразу + надбавки за перебор
Одновременно: до 3 задач на пользователя

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

GET /api/podskazkigoogle

Фраза и настройки передаются в query-строке.

Параметры query

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

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

Фраза для сбора подсказок.
deep int

Глубина: на втором и третьем уровне подсказки собираются для найденных подсказок. Любое другое значение превращается в 1.

1
только подсказки к фразе

2
два уровня

3
три уровня

По умолчанию 1
cb_with_space string

Дополнительно запросить фразу с пробелом на конце.

on
включить
cb_with_numbers string

Перебрать цифры 0–9 после фразы.

on
включить
cb_with_cyrillic string

Перебрать буквы русского алфавита после фразы.

on
включить
cb_with_english string

Перебрать буквы английского алфавита после фразы.

on
включить
stop_list string

Стоп-слова через перевод строки \r\n: подсказки с ними отбрасываются.
search_engine string

Принимается, но сейчас не используется: подсказки всегда собираются с google.com для России.

По умолчанию google.ru

Ответ

report_id int

Номер задачи.

GET /api/podskazkigoogle

curl -G 'https://tools.pixelplus.ru/api/podskazkigoogle' \
  --data-urlencode 'key=ВАШ_КЛЮЧ' \
  --data-urlencode 'query=купить велосипед'

<?php
$url = 'https://tools.pixelplus.ru/api/podskazkigoogle?' . http_build_query([
    'key' => 'ВАШ_КЛЮЧ',
    'query' => 'купить велосипед',
]);

$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/podskazkigoogle",
    params={
        "key": "ВАШ_КЛЮЧ",
        "query": "купить велосипед",
    },
    timeout=60,
)
print(response.json())

query обязательный Фраза для сбора подсказок

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

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

{
    "report_id": 18734530
}

Постановка задачи: список фраз

POST /api/podskazkigoogle

Ключ — в query-строке, фразы и настройки — в теле формы. queries — JSON-массив строк в виде строки.

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

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

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

JSON-массив фраз, например ["купить велосипед","велосипед цена"].
deep int

Глубина: на втором и третьем уровне подсказки собираются для найденных подсказок. Любое другое значение превращается в 1.

1
только подсказки к фразе

2
два уровня

3
три уровня

По умолчанию 1
cb_with_space string

Дополнительно запросить фразу с пробелом на конце.

on
включить
cb_with_numbers string

Перебрать цифры 0–9 после фразы.

on
включить
cb_with_cyrillic string

Перебрать буквы русского алфавита после фразы.

on
включить
cb_with_english string

Перебрать буквы английского алфавита после фразы.

on
включить
stop_list string

Стоп-слова через перевод строки \r\n: подсказки с ними отбрасываются.
search_engine string

Принимается, но сейчас не используется: подсказки всегда собираются с google.com для России.

По умолчанию google.ru

Ответ

report_id int

Номер задачи.

POST /api/podskazkigoogle

curl -X POST 'https://tools.pixelplus.ru/api/podskazkigoogle?key=ВАШ_КЛЮЧ' \
  --data-urlencode 'queries=["купить велосипед","велосипед цена"]'

<?php
$url = 'https://tools.pixelplus.ru/api/podskazkigoogle?' . 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([
        'queries' => '["купить велосипед","велосипед цена"]',
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($response);

import requests

response = requests.post(
    "https://tools.pixelplus.ru/api/podskazkigoogle",
    params={
        "key": "ВАШ_КЛЮЧ",
    },
    data={
        "queries": "[\"купить велосипед\",\"велосипед цена\"]",
    },
    timeout=60,
)
print(response.json())

queries обязательный JSON-массив фраз, например ["купить велосипед","велосипед цена"]

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

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

{
    "report_id": 18734531
}

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

GET /api/podskazkigoogle

Пока задача выполняется, приходит {"error":"In progress","code":50}.

Параметры query

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

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

Номер задачи из ответа на постановку.

Ответ

request object

Параметры задачи.
response object

Результат.
Вложенные поля
- count_words object
  
  Подсказки: ключ — текст подсказки, значение — число слов в ней.
- count_phrases int
  
  Сколько подсказок собрано.
- excess_requests_flag bool
  
  Сбор остановлен из-за ограничения объёма.
- not_parsed_phrases array
  
  Фразы, для которых подсказки не собирались (не больше 10 000).
- warning_text string
  
  Предупреждение, если сбор оборвался раньше заданной глубины.

GET /api/podskazkigoogle

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

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

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

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

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

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

{
    "request": {
        "query": "купить велосипед",
        "requests": "купить велосипед",
        "deep": 1,
        "search_engine": "google.ru"
    },
    "response": {
        "warning_text": "",
        "count_words": {
            "купить велосипед": 2,
            "купить велосипед взрослый": 3
        },
        "count_phrases": 2,
        "excess_requests_flag": false,
        "not_parsed_phrases": []
    }
}

Ошибки

Код	Сообщение	Когда
`-50`	`Not set`	Не передан `query` (GET) или `queries` (POST).
`-60`	`To many tasks from one user. Try again later.`	У пользователя уже больше двух незавершённых задач этого инструмента.
`-68, -80…-83`	`Not enough … limits`	Не хватает лимитов за период; в ответе есть `available` и `need`.
`-4`	`Access denied`	`report_id` не найден или чужой.
`50`	`In progress`	Задача ещё выполняется.
`-104…-107, -125`	`Processing error / Limits run out / …`	Задача завершилась ошибкой, закончились лимиты, отменена или шла дольше 6 часов.
`-1, -2`	`Access denied`	Ключ не передан или не найден.

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

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

Стоимость

1 лимит за фразу, плюс за каждый включённый перебор: пробел +1, цифры +10, русский алфавит +33, английский +26.

Ограничения

В ответе на результат нет полей time и cost, в отличие от podskazkiyandex.
Если на уровне набирается 8 000 подсказок и больше, сбор на нём останавливается.
Регион и домен Google выбрать нельзя: search_engine игнорируется.
Сама фраза запрашивается только вместе с cb_with_space=on; остальные переборы добавляют варианты «фраза + символ». Без единого перебора запрашивать нечего — включайте хотя бы cb_with_space.

Старое ограничение «не более 100 фраз в queries» в коде не действует — держите список коротким сами: стоимость и время растут линейно.

podskazkigoogle Сбор поисковых подсказок Google

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

Параметры query

Ответ

Постановка задачи: список фраз

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

Ответ

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

Параметры query

Ответ

Ошибки

Стоимость

Ограничения

`podskazkigoogle` Сбор поисковых подсказок Google