🏠 Главная API TOOLS Сбор поисковых подсказок

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 - результат с собранными поисковыми фразами.