SEOWIZARD.RU XML-RPC

Наш xml-rpc интерфейс доступен по адресу http://api.seowizard.ru/xmlrpc/. Обращаться нужно по 80-ому порту, тело xml-запроса класть в POST_DATA. Всё общение происходит полностью в кодировке UTF-8.

Если Вы ещё ничего не знаете про XML-RPC, то рекомендуем почитать на сайте www.xmlrpc.com:



Описание существующих функций

  • (int) seowizard.loginpass((string) login, (string) token) — авторизация в системе, необходимо вызывать в начале каждой сессии. Далее при каждом следующем запросе нужно передавать все вернувшиеся cookie. Если параметр md5 == true, то пароль должен быть захеширован алгоритмом MD5. Результатом выполнения функции является id пользователя.
  • (array) seowizard.user_stats_get([(int) date_from, (int) date_to]) — данные по расходам средств. Каждый элемент массива содержит:
    • дата списания,
    • ID проекта,
    • суммы на различные активности.
  • (struct) seowizard.project_list() — список проектов пользователя, каждый элемeнт содержит:
    • ID проекта,
    • дополнительный ID проекта для синхронизации в API Sape,
    • домен,
    • регион,
    • язык интерфейса google,
    • ID папки,
    • название проекта,
    • дата создания,
    • прогнозируемый бюджет в месяц,
    • текущий бюджет в месяц,
    • пользовательский лимит прироста ссылок в сутки,
    • флаг использования пользовательского лимита прироста ссылок в сутки,
    • флаг учета поддоменов сайта в анализе позиций.
  • (struct) seowizard.project_get((int) id_project) — параметры проекта пользователя:
    • ID проекта,
    • ID проекта SAPE,
    • домен,
    • регион,
    • язык интерфейса google,
    • ID папки,
    • название проекта,
    • дата создания,
    • прогнозируемый бюджет в месяц,
    • текущий бюджет в месяц,
    • пользовательский лимит прироста ссылок в сутки,
    • флаг использования пользовательского лимита прироста ссылок в сутки,
    • флаг учета поддоменов сайта в анализе позиций.
  • (struct) seowizard.project_stats_get((int) id_project [, (string) type_stats, (int) date_from, (int) date_to]) — получение таблицы статистики переходов и позиций по проекту, каждый элемент это структура, где ключ - дата сбора данных, а значение это массив, где ключ элемента - ID УРЛа проекта, а сам элемент может содержать:
    • позицию по Яндекс,
    • позицию по Google,
    • переходы по Яндекс,
    • переходы по Google.
  • (struct) seowizard.url_list((int) id_project) — список УРЛов проекта, каждый элемент содержит:
    • ID УРЛа,
    • ID проекта,
    • ключевая фраза,
    • УРЛ,
    • статус УРЛа,
    • флаг приостановки проекта,
    • геозависимость ключевой фразы,
    • текущая позиция по Яндекс,
    • текущая позиция по Google,
    • цель по Яндекс,
    • цель по Google,
    • тип метода автопродвижения,
    • название метода автопродвижения,
    • частотность ключевой фразы,
    • количество купленных ссылок,
    • прогнозируемый бюджет в месяц,
    • текущий бюджет в месяц,
    • рассчитанный бюджет в месяц.
  • (struct) seowizard.url_get((int) id_url) — параметры УРЛа пользователя, каждый элемент содержит:
    • ID УРЛа,
    • ID проекта,
    • ключевая фраза,
    • УРЛ,
    • статус УРЛа,
    • флаг приостановки проекта,
    • геозависимость ключевой фразы,
    • текущая позиция по Яндекс,
    • текущая позиция по Google,
    • цель по Яндекс,
    • цель по Google,
    • тип метода автопродвижения,
    • название метода автопродвижения,
    • частотность ключевой фразы,
    • количество купленных ссылок,
    • прогнозируемый бюджет в месяц,
    • текущий бюджет в месяц,
    • рассчитанный бюджет в месяц.
  • (struct) seowizard.url_analyse_get((int) id_url[, (string) type_activity = "rent"]) — получить результаты последнего анализа УРЛа (по умолчанию, из арендной активности); доступные варианты для type_activity - rent, pr или social. Каждый элемент содержит:
    • date_analyzed - дата создания анализа;
    • last_analyze_datetime - дата последнего выполнения анализа;
    • percent_optimization - процент оптимизации;
    • phrases - фразы, по которым проводился анализ;
    • excluded_phrases - фразы, принудительно исключенные из анализа;
    • url - страница, по которой проводился анализ;
    • recommendations - рекомендации;
    • concurrents_stat - статистика по конкурентам.
  • (struct) seowizard.url_anchors_list((int) id_url[, (int) id_type]) — получение списка анкоров (всех или заданного типа) УРЛа, каждый элемент содержит:
    • ID анкора,
    • ID типа анкора:
      •  1  — ТВ - точное вхождение,
      •  2  — ТВО - точное вхождение с окружением,
      •  3  — ТВРО - точное вхождение с разбавлением и окружением,
      •  4  — ТВР - точное вхождение с разбавлением,
      •  5  — НВРО - неточное вхождение с разбавлением и окружением,
      •  6  — НВР - неточное вхождение с разбавлением;
      •  7  — БА - безанкорные ссылки;
    • текст анкора,
    • длина текста анкора.
  • (struct) seowizard.urls_anchors_list((int) id_project, (array/int) id_url[, (int) id_type]) — получение списка анкоров (всех или заданного типа) УРЛов одного проекта, каждый элемент содержит:
    • ID анкора,
    • ID типа анкора:
      •  1  — ТВ - точное вхождение,
      •  2  — ТВО - точное вхождение с окружением,
      •  3  — ТВРО - точное вхождение с разбавлением и окружением,
      •  4  — ТВР - точное вхождение с разбавлением,
      •  5  — НВРО - неточное вхождение с разбавлением и окружением,
      •  6  — НВР - неточное вхождение с разбавлением;
      •  7  — БА - безанкорные ссылки;
    • текст анкора,
    • длина текста анкора.
  • (struct) seowizard.url_stats_get((int) id_url) — получение таблицы статистики переходов и позиций по УРЛу, каждый элемент это структура, где ключ - дата сбора данных, а сам элемент может содержать:
    • позицию по Яндекс,
    • позицию по Google,
    • переходы по Яндекс,
    • переходы по Google.
  • (struct) seowizard.messages_list([(struct) filter]) — получить извещения из системы по заданному фильтру. Параметры фильтра передаются как элементы структуры и могут содержать:
    • (int) id_project; ID проекта,
    • (int) id_url; ID УРЛа,
    • (int) date_from; дата от,
    • (int) date_to; дата до,
    • (bool) is_show_critical; флаг показа только критических / не критических извещений,
    • (bool) is_show_fixed; флаг показа только исправленных / не исправленных извещений;

      • Возвращается массив, каждый элемент содержит:
    • ID проекта,
    • ID урла,
    • тип активности извещения,
    • дата создания извещения,
    • дата обновления извещения,
    • дата исправления извещения,
    • тип извещения,
    • сообщение,
    • флаг критичности,
    • дополнительная информация в формате JSON.
  • (struct) seowizard.update_list() — получение списка дат последних трех апдейтов Яндекса и Google, каждый элемент содержит:
    • тип апдейта,
    • время апдейта,
    • дата определения апдейта в читаемом формате.