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

`podskazkiyoutube` Сбор поисковых подсказок YouTube

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

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

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

GET /api/podskazkiyoutube

Все параметры — в query-строке. Если предыдущая задача ещё не закончилась, новая не ставится: придёт код -32 и report_id текущей.

Параметры query

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

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

Фраза для сбора подсказок. Обратите внимание: параметр называется request, а не query.
region string

Код страны для подсказок (параметр gl YouTube), например RU, KZ, BY, UA.
deep int

Глубина сбора. Без параметра собирается только первый уровень.

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

2
два уровня

3
три уровня

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

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

on
включить
cb_with_numbers string

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

on
включить
cb_with_cyrillic string

Перебрать буквы русского алфавита. +33 лимита.

on
включить
cb_with_english string

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

on
включить
stop_list string

Стоп-слова через запятую: подсказки с ними отбрасываются на всех уровнях.

Ответ

report_id int

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

GET /api/podskazkiyoutube

curl -G 'https://tools.pixelplus.ru/api/podskazkiyoutube' \
  --data-urlencode 'key=ВАШ_КЛЮЧ' \
  --data-urlencode 'request=обзор смартфона' \
  --data-urlencode 'region=RU' \
  --data-urlencode 'deep=1' \
  --data-urlencode 'stop_list=бесплатно,скачать'

<?php
$url = 'https://tools.pixelplus.ru/api/podskazkiyoutube?' . http_build_query([
    'key' => 'ВАШ_КЛЮЧ',
    'request' => 'обзор смартфона',
    'region' => 'RU',
    'deep' => 1,
    'stop_list' => 'бесплатно,скачать',
]);

$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/podskazkiyoutube",
    params={
        "key": "ВАШ_КЛЮЧ",
        "request": "обзор смартфона",
        "region": "RU",
        "deep": 1,
        "stop_list": "бесплатно,скачать",
    },
    timeout=60,
)
print(response.json())

request обязательный Фраза для сбора подсказок region Код страны для подсказок (параметр gl YouTube), например RU, KZ, BY, UA deep Глубина сбора stop_list Стоп-слова через запятую: подсказки с ними отбрасываются на всех уровнях

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

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

{
    "report_id": 18734540
}

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

GET /api/podskazkiyoutube

Пока задача выполняется, приходит {"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
  
  true, если вариантов первого уровня больше 2 000 и часть не запрашивалась.
- not_parsed_phrases array
  
  Варианты, которые не запрашивались из-за ограничения.
- warning_text string
  
  Предупреждение, если сбор оборвался раньше заданной глубины.

GET /api/podskazkiyoutube

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

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

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

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

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

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

{
    "request": {
        "request": "обзор смартфона",
        "region": "RU",
        "deep": "1",
        "requests": [
            "обзор смартфона"
        ],
        "stop_list": [
            "бесплатно",
            "скачать"
        ]
    },
    "response": {
        "warning_text": "",
        "count_words": {
            "обзор смартфона": 2,
            "обзор смартфона 2026": 3
        },
        "count_phrases": 2,
        "excess_requests_flag": false,
        "not_parsed_phrases": []
    }
}

Ошибки

Код	Сообщение	Когда
`-50`	`Not set`	Не передан `request`.
`-32`	`In progress`	Предыдущая задача ещё выполняется; её номер — в `report_id`.
`-68, -80…-83`	`Not enough … limits`	Не хватает лимитов за период; в ответе есть `available` и `need`.
`-4`	`Access denied`	`report_id` не найден или чужой.
`50`	`In progress`	Задача по `report_id` ещё выполняется.
`-104…-107, -125`	`Processing error / Limits run out / …`	Задача завершилась ошибкой, закончились лимиты, отменена или шла дольше 6 часов.
`-1, -2`	`Access denied`	Ключ не передан или не найден.

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

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

Стоимость

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

Подсказки запрашиваются на русском языке интерфейса (hl=ru) — region меняет только страну.

podskazkiyoutube Сбор поисковых подсказок YouTube

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

Параметры query

Ответ

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

Параметры query

Ответ

Ошибки

Стоимость

`podskazkiyoutube` Сбор поисковых подсказок YouTube