API для инструмента сбора поисковых подсказок в Яндексе, Google и YouTube
Для инструмента «Сбор поисковых подсказок» обязательные параметры:
- tools_name=suggest - название инструмента.
- queries= список ключевых фраз.
- se= выбор поисковой системы: Яндекс = 1, Google = 2 и YouTube = 3.
- region= регион поиска для Яндекса и Google.
- google_domain= домен Google и YouTube для парсинга поисковых подсказок. Список доменов, которые принимает инструмент, можно взять по ссылке. Например: www.google.com
- google_from= параметр страны для Google и YouTube. Список стран, который принимает инструмент, можно взять по ссылке. Например: Russia или RU
- google_lang= параметр языка для Google и YouTube. Список языков, который принимает инструмент, можно взять по ссылке. Например: русский или ru
- check= настройка парсинга поисковых подсказок. Варианты опций: 1) Фраза - nrm 2) Фраза и пробел - spc 3) Фраза и английский алфавит [a-z] - lat 4) Фраза и русский алфавит [а-я] - cyr 5) Фраза и цифры [0-9] - dig. Если вам нужны опции расширенной настройки, то указывать следующие парметры: 1) Local - loc 2) Шопинг - sho 3) Вопросительные - quo 4) Отзывы - otzyv. Пример запроса при всех выбранных опциях: &words=["nrm","spc","lat","cyr","dig","loc","sho","quo","otzyv"].
- depth= глубина парсинга, необязательный параметр, по умолчанию = 1. Возможные значения: 1, 2 и 3.
- stoplist= стоп слова в формате JSON. Пример: stoplist=["дилер","бесплатно"]
Пример JSON для отправки данных:
Пример для Google:
{
"tools_name": "suggest",
"data": {
"queries": [
"купить киа"
],
"se": 2,
"region": 1011969,
"google_domain": "www.google.bg",
"google_lang": "bg",
"google_from": "BG",
"check": [
"nrm",
"spc",
"lat",
"cyr",
"dig",
"loc",
"sho",
"quo",
"otzyv"
],
"depth": 1,
"stoplist": [
"дилер",
"бесплатно"
]
}
}
Пример для Яндекс:
{
"tools_name": "suggest",
"data": {
"queries": [
"купить киа"
],
"se": 1,
"region": 213,
"check": [
"nrm",
"spc",
"lat",
"cyr",
"dig",
"loc",
"sho",
"quo",
"otzyv"
],
"depth": 1,
"stoplist": [
"дилер",
"бесплатно"
]
}
}
Расшифровка результатов
- count - общее количество поисковых фраз;
- words - ключевые слова указанные на входе;
- types - типы поисковых подсказок.
"B" => "Есть в подсказках", "T" => "Есть в подсказках", "W" => "Перестановка слов", "Pb" => "Порно-подсказка", "Nav" => "Навигационная подсказка", "Rich" => "Расширенная подсказка", "Tail_word" => "Дополнение / исправление начала запроса", "Fast" => "Новостная подсказка", "In" => "Автосгенерированная",
- result - результат с собранными поисковыми фразами.