Содержание

Поиск по ключевым словам

Выгрузка ключевых слов на сайте

Выгрузка ключевых слов - getkeywords

Поиск по ключевым словам

В веб-версии продуктовой базы api.systeme.ru предусмотрено поле поиска по описанию референсов.

В поле вводится искомое наименование референса. Если по указанному сочетанию символов есть совпадение в БД, в выпадающем списке отобразятся первые 10 вариантов, максимально подходящих под запрос. При нажатии на любой из результатов выдачи сайт перенаправляет в карточку референса. Если нужно отобразить весь результат поиска, необходимо нажать кнопку "Найти" после ввода данных в поисковое поле. В таком случае на странице отобразится весь список референсов, содержащих указаное сочетание символов.

Также был добавлен поиск по ключевым словам. Принцип отображения результата поиска аналогичен поиску по референсам. Например, при вводе слова "розетки" в поисковое поле, отображаются первые 10 наиболее релевантных вариантов выдачи.

Система автоматически определяет тип вводимых данных в поисковое поле и отображает результаты по следующим параметрам референсов:

Наименование референса
Описание (стандартное)
Ключевые слова

В ключевые слова дополнительно входят жаргоны, всевозможные словоформы произношений и написаний, в том числе и с ошибками - потенциально возможные варианты написания пользователем.

Результат выдачи можно выгрузить в файлы Excel с разбивкой на папки по типам контента.

Ключевые слова доступны для очень ограниченного списка референсов, порядка 2 000. Если вы заинтересованы в получении большего списка, напишите в поддержку API (контакты внизу страницы).

Выгрузка ключевых слов на сайте

Ключевые слова есть трех типов:

Ключевые слова референса;
Ключевые слова каталогов;
Ключевые слова технической документации.

Все типы ключевых слов, вы можете скачать в разделах: Каталог товаров, выгрузка по Активити, выгрузка по Каналам продаж.

Экспорт ключевых слов из раздела Активити:

Для того чтобы скачать ключевые слова всех типов по всем референсам, перейдите в раздел Активити и скачайте любой из суммарных файлов.

Экспорт ключевых слов из Канала продаж:

Для того чтобы скачать ключевые слова по необходимым референсам, вам необходимо нажать на кнопку Экспорт и установить чек-бокс в параметах в зависимости от того какие ключевые слова вас интересуют:

“Данные по референсам” - содержат ключевые слова для референса;
“Каталоги” - содержат ключевые слова для каталогов;
“Техническая документация” - содержит ключевые слова для тех. документации.

В разделе Каналы продаж все референсы разделены на категории, поэтому если вы не нашли ключевые слова по необходимому референсу, рекомендуем посмотреть в другой категории или воспользоваться поиском в разделе Каталог и скачать там.

Экспорт ключевых слов из раздела Каталог:

Для того чтобы скачать ключевые слова по необходимым референсам, следуйте инструкции:

В поиске укажите один или несколько референсов и нажмите Поиск.
После того как вам отобразятся результаты поиска, нажмите кнопку “Экспортировать все”.
Установите чек-боксы в тех параметрах которые вас интересуют.
Укажите свою почту и ожидайте архив с ключевыми словами.

Рекомендации:
Самый простой способ скачать сразу все ключевые слова, это скачать “Суммарный файл” из раздела Активити.

В полученном файле можно скрыть все референсы в которых отсутствуют ключевые слова с помощью фильтра.

Для того что бы долго не ждать архив на почту, выберите только необходимые параметры с ключевыми словами.

Выгрузка ключевых слов - getkeywords

Поддерживаемые параметры: commercialRef, pageSize, page, brand

Метод позволяет выгрузить все ключевые слова в полном объеме, имеющимся в БД API. В ответ приходит список слов для каждого такого референса.

Пример запроса:
https://api.systeme.ru/new-api/XML/getkeywords?accessCode={YouApiToken}

Пример выдачи:

<content>
    <result>success</result>
    <data>
        <reference>
            <commercialRef>A9A15222</commercialRef>
            <description>ТРАНСФОРМАТОР БЕЗОПАСН. iTR 63ВА 12/24В</description>
            <keywords>
                <item>акти9</item>
                <item>акти 9</item>
                <item>акти</item>
                <item>acti 9</item>
                <item>флеш</item>
                <item>frnb</item>
                <item>флеш9</item>
                <item>трансформатор безопасности itr 63ва 12/24в</item>
                <item>frnb207</item>
            </keywords>
        </reference>
        <reference>
            <commercialRef>A9A15306</commercialRef>
            <description>ЩИТ.РОЗ. iPC DIN 2П+T 16A 250В</description>
            <keywords>
                <item>акти9</item>
                <item>акти 9</item>
                <item>акти</item>
                <item>acti 9</item>
                <item>флеш</item>
                <item>frnb</item>
                <item>флеш9</item>
                <item>розетка щитовая</item>
                <item>щитовая розетка</item>
                <item>розетка для щита</item>
                <item>розетка в щит</item>
                <item>ipc din 2п</item>
                <item>t 16a 250в</item>
                <item>frnb225</item>
            </keywords>
        </reference>
    </data>
</content>

Описание параметров запроса

&page={N} - пагинация, осуществляет переход к указанной странице, где N - ее номер. Общее количество страниц в выдаче системой не определяется (нецелесообразно), поэтому осуществлять перебор данных постранично нужно до тех пор, пока ответ не перестанет возвращать продуктовые данные (выдача станет пустой).

Пример запроса:
https://api.systeme.ru/new-api/XML/getkeywords?accessCode={YourApiToken}&page=2

&pageSize={N} – задает количество записей в выдаче, где N - числовое значение. По умолчанию большинство методов содержит лимит в 50 записей на страницу. Максимальное значение лимита 50.

Пример запроса:
https://api.systeme.ru/new-api/XML/getkeywords?accessCode={YourApiToken}&pageSize=50

&commercialRef={N} – запрос данных по конкретному референсу или списку референсов, где N - точное обозначение референса, например GSL000434. Если в качестве значения задается список референсов, то они должны перечисляться через запятую без пробелов: GSL000434,16765,18636. Максимальное значение лимита 50.

Примеры запросов:
https://api.systeme.ru/new-api/XML/getkeywords?accessCode={YourApiToken}&commercialRef=GSL000434
https://api.systeme.ru/new-api/XML/getkeywords?accessCode={YourApiToken}&commercialRef=GSL000434,16765,18636

&brand - бренд товара.

Поддерживается сортировка товара по бренду, для этого используйте: https://api.systeme.ru/new-api/XML/getkeywords?accessCode={YourApiToken}&brand={ID-бренда}

Чтобы получить список брендов с их идентификаторами (ID) используйте метод API getbrands https://api.systeme.ru/new-api/XML/getbrands?accessCode={YourApiToken}