Как создать задачу
Метод: add/projects_2/tasks/volumes
Метод создает задачу с указанными параметрами и отправляет ее на проверку. В результате работы метода возвращается:
- ID задачи, если проверка частоты запущена успешно;
- 0 и текст ошибки, если задача не создана и проверка не была запущена.
Параметр | Тип | Описание | По умолчанию |
Обязательные | |||
url | string | URL задачи. Никак не влияет на результат проверки, можно указать site.com | |
keywords | array | Массив с запросами | |
region.searcher_key | enum(0, 1) |
Ключ поисковой системы. Возможные значения:
|
|
region.key | int |
Ключ региона. Для разных поисковых систем список доступных регионов может быть разный. |
|
region.type | array(enum(0,1,2,3,4,5,6)) | Индекс типа частоты (для Яндекс 1, 2, 3, 5 или 6, для Google всегда 3). | |
Необязательные | |||
remove_special_chars | boolean | Вырезать из ключевых фраз плюсы, точки, запятые, апострофы, кавычки | 0 |
no_recheck | enum(0, 1, 2) |
Возможные значения:
|
0 |
В Google нельзя добавить российские регионы, Донецк и Луганск
В Google (searcher_key = 0) запрещено добавлять регионы России, Донецка и Луганска. Это связано с ограничениями со стороны Google.
В Google (searcher_key = 0) запрещено добавлять регионы России, Донецка и Луганска. Это связано с ограничениями со стороны Google.
Как узнать region.key?
Чтобы узнать ключ региона, выполните поиск по нашей базе регионов методом get/system_2/common/regions. Например, с помощью запроса ниже мы узнаем region key региона США для поисковой системы Google.
{ "limit": 10, "searcher_key": "1", "search": "сша" }
Пример JSON для запроса
Запрос отправляет поисковые запросы из массива keywords на проверку Частоты, "Частоты" и "[!Частоты]" в ПС Яндекс, регион Россия, и [Частоты] в ПС Google, регион США.
{ "url": "site.com", "keywords": [ "миксит отзывы", "отзывы на косметику миксит" ], "regions": [ { "key": 225, "searcher_key ": 0, "types": [1, 2, 6], }, { "key": 84, "searcher_key ": 1, "types": [3], }, ] }
Пример ответа
"result": 123456789