Документация на метод "podskazkigoogle"
API для парсинга подсказок в выдаче Google:
url: https://tools.pixelplus.ru/api/podskazkigoogle
Описание:
Метод позволяет создать задачу для парсинга подсказок в выдаче Google.
Для создания задачи необходимо сформировать запрос и отправить его на URL метода с обязательными GET-параметрами key параметрами необходимыми для запуска задачи. Система поставит задачу в очередь выполнения и вернет идентификатор отчета: report_id. Для получения результата проверки необходимо отправить GET запрос с параметрами key и report_id.
Принимает параметры:
1. Обязательные параметры:
- key — ключ доступа к API;
- report_id — номер отчета с подсказками Google;
- GET:
query — запрос для парсинга подсказок Google;
POST:
queries — json, запросы для парсинга подсказок Google (не более 100 запросов);
2. Необязательные параметры (набор ключей/инструментов которые нужно применить):
- deep — глубина (от 1 до 3, по умолчанию 1);
- cb_with_space=on — c пробелом и без после фразы;
- cb_with_cyrillic=on — c перебором кириллического алфавита;
- cb_with_numbers=on — c перебором цифр;
- cb_with_english=on — c перебором английского алфавита;
- search_engine — поисковая система( google.ru, google.com, google.com.ua, google.by, google.kz), по умолчанию: google.ru
Метод возвращает JSON с массивом:
В случае запроса на обработку: [{"report_id":"номер запроса"}]
В случае запроса обработки (request - отправленный запрос, response - ответ инструмента):
- [{"error":"In progress", "code":50}]
- ["count_words":{"фраза-подсказка 1":"кол-во слов в фразе-подсказке 1, "фраза-подсказка 2":"кол-во слов в фразе-подсказке 2, ..."}, "count_phrases":"кол-во полученных фраз-подсказок", "excess_requests_flag":"флаг достижения ограничений в выдаче(true/false)", "not_parsed_phrases":{"не распарсенная фраза 1", "не распарсенная фраза 2", ... }, "warning_text":"Собраны поисковые подсказки до глубины: 1(2)"]
В случае неудачи:
- {"url":"Not set","code":-50} — если запрос не валиден;
- {"error":"Not enough daily limits","code":-68} — недостаточно дневных лимитов;
- {"error":"Not enough hourly limits","code":-80} — недостаточно часовых лимитов;
- {"error":"Not enough weekly limits","code":-81} — недостаточно недельных лимитов;
- {"error":"Not enough monthly limits","code":-82} — недостаточно месячных лимитов;
- {"error":"Not enough yearly limits","code":-83} — недостаточно годовых лимитов;
- {"error":"error","code":-4} — если задан неверный report_id;
- {"error":"To many tasks from one user. Try again later.","code":-60} — превышен лимит одновременно поставленных задач для пользователя;
- {"error":"In progress","code":50} — если по запросу report_id все еще идет проверка;
- {"error":"access denided","code":-1} — если не задан ключ доступа;
- {"error":"access denided","code":-2} — если неверно задан ключ доступа;
- {"error":"unknown method","code":-3} — если неверно задано название метода;
- {"error":"Processing error","code":-104} — инструмент завершился с фатальной ошибкой;
- {"error":"Limits run out","code":-105} — во время выполнения инструмента закончились лимиты;
- {"error":"The process was canceled by a user","code":-106} — задача отменена пользователем;
- {"error":"The process took more than 6 hours and was canceled","code":-107} — инструмент очень долго работал в фоне и мы автоматически завершили процесс;
- {"error":"Processing error":-125} — непредвиденная ошибка;
Пример формирования GET:
GET:
$url = 'http://tools.pixelplus.ru/api/podskazkigoogle?key=API_KEY&query=пример&reion=RU&deep=1&cb_with_space=on;