API документация для lfood.com.ua

API позволяет сделать поисковый GET запрос и получить результат в формате JSON в виде отранжированных id товаров, категорий и других данных.

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

Параметр	Значение	Пример	Обязательный параметр
id	идентификатор сайта	https://api.multisearch.io/?id=12515&query=ніж &key=88d22a39f2adf7b10e2a434fa1d21acd	Да
key	секретный ключ	https://api.multisearch.io/?id=12515&query=ніж &key=88d22a39f2adf7b10e2a434fa1d21acd	Да
query	поисковый запрос	https://api.multisearch.io/?id=12515&query=ніж &key=88d22a39f2adf7b10e2a434fa1d21acd	Опциональный
uid	сессия или id пользователя	https://api.multisearch.io/?id=12515&query=ніж &uid=cc441f080 &key=88d22a39f2adf7b10e2a434fa1d21acd	Опциональный
t[]	id категории, для фильтрации по категориям	https://api.multisearch.io/?id=12515&query=ніж &t[]=110043948 &key=88d22a39f2adf7b10e2a434fa1d21acd	Опциональный
	фильтр по нескольким категориям	https://api.multisearch.io/?id=12515&query=ніж &t[]=110043948&t[]=110043947 &key=88d22a39f2adf7b10e2a434fa1d21acd
lang	язык результатов поиска (uk, en, ru и т.д.)	https://api.multisearch.io/?id=12515&query=ніж &uid=cc441f080&lang=uk &key=88d22a39f2adf7b10e2a434fa1d21acd	Опциональный
categories	0 - без группировки	https://api.multisearch.io/?id=12515&query=ніж &categories=0 &key=88d22a39f2adf7b10e2a434fa1d21acd	Опциональный, по умолчанию all
	all - группировать по всем найденным категориям	https://api.multisearch.io/?id=12515&query=ніж &categories=all &key=88d22a39f2adf7b10e2a434fa1d21acd
	n - группировать по первым n категориям	https://api.multisearch.io/?id=12515&query=ніж &categories=1 &key=88d22a39f2adf7b10e2a434fa1d21acd
limit	количество позиций (по умолчанию 4)	https://api.multisearch.io/?id=12515&query=ніж &categories=0&limit=10 &key=88d22a39f2adf7b10e2a434fa1d21acd	Опциональный, max=50
offset	смещение для выборки (постраничная выдача)	https://api.multisearch.io/?id=12515&query=ніж &categories=0&limit=1&offset=1 &key=88d22a39f2adf7b10e2a434fa1d21acd	Опциональный
fields	вывод дополнительных полей:		Опциональный
	true - показать все поля	https://api.multisearch.io/?id=12515&query=ніж &fields=true &key=88d22a39f2adf7b10e2a434fa1d21acd
	name,price,picture… - показать выбранные поля	https://api.multisearch.io/?id=12515&query=ніж &fields=name,price,picture &key=88d22a39f2adf7b10e2a434fa1d21acd
sort	сортировка результатов направление сортировки: asc - по возрастанию desc - по убыванию		Опциональный, по умолчанию relevance
	relevance (сортировка по релевантности)
	name (сортировка по названию)	https://api.multisearch.io/?id=12515&query=ніж &categories=0&fields=name&sort=name.asc &key=88d22a39f2adf7b10e2a434fa1d21acd https://api.multisearch.io/?id=12515&query=ніж &categories=0&fields=name&sort=name.desc &key=88d22a39f2adf7b10e2a434fa1d21acd
	price (сортировка по цене)	https://api.multisearch.io/?id=12515&query=ніж &categories=0&fields=name,price&sort=price.asc &key=88d22a39f2adf7b10e2a434fa1d21acd https://api.multisearch.io/?id=12515&query=ніж &categories=0&fields=name,price&sort=price.desc &key=88d22a39f2adf7b10e2a434fa1d21acd
	ordering (сортировка по популярности, если значение ordering передается в фиде)	https://api.multisearch.io/?id=12515&query=ніж &categories=0&fields=name&sort=ordering.asc &key=88d22a39f2adf7b10e2a434fa1d21acd https://api.multisearch.io/?id=12515&query=ніж &categories=0&fields=name&sort=ordering.desc &key=88d22a39f2adf7b10e2a434fa1d21acd
	created_at (сортировка по новинкам, если значение передается в фиде)	https://api.multisearch.io/?id=12515&query=ніж &categories=0&fields=name&sort=created_at.asc &key=88d22a39f2adf7b10e2a434fa1d21acd https://api.multisearch.io/?id=12515&query=ніж &categories=0&fields=name&sort=created_at.desc &key=88d22a39f2adf7b10e2a434fa1d21acd
	profit (сортировка по выгоде, разница между старой и новой ценой товара)	https://api.multisearch.io/?id=12515&query=ніж &categories=0&fields=name,price,oldprice&sort=profit.asc &key=88d22a39f2adf7b10e2a434fa1d21acd https://api.multisearch.io/?id=12515&query=ніж &categories=0&fields=name,price,oldprice&sort=profit.desc &key=88d22a39f2adf7b10e2a434fa1d21acd
	presence (сортировка по наличию)	https://api.multisearch.io/?id=12515&query=ніж &categories=0&fields=name,price,oldprice&sort=presence.asc &key=88d22a39f2adf7b10e2a434fa1d21acd https://api.multisearch.io/?id=12515&query=ніж &categories=0&fields=name,price,oldprice&sort=presence.desc &key=88d22a39f2adf7b10e2a434fa1d21acd

История запросов

Описание	Метод HTTP	Пример
Запрос отправляется без параметра query	GET	https://api.multisearch.io/?id=12515&uid=cc441f080&key=88d22a39f2adf7b10e2a434fa1d21acd
Удаление истории запросов пользователя	DELETE	https://api.multisearch.io/history?id=12515&uid=cc441f080&key=88d22a39f2adf7b10e2a434fa1d21acd
Удаление определенного запроса в истории пользователя	DELETE	https://api.multisearch.io/history?id=12515&uid=cc441f080&query=ніж&key=88d22a39f2adf7b10e2a434fa1d21acd

Примеры запросов

Описание	Пример
с пагинацией, с группировкой по категории	https://api.multisearch.io/?id=12515&query=ніж&uid=cc441f080&limit=10&offset=10&categories=all &key=88d22a39f2adf7b10e2a434fa1d21acd
с фильтром по 2 категориям и пагинацией, со списком категорий	https://api.multisearch.io/?id=12515&query=ніж&uid=cc441f080&limit=18&offset=18&t[]=110043948&t[]=110043947&categories=0 &key=88d22a39f2adf7b10e2a434fa1d21acd
с дополнительными полями и списком категорий	https://api.multisearch.io/?id=12515&query=ніж&uid=cc441f080&limit=10&categories=0&fields=true &key=88d22a39f2adf7b10e2a434fa1d21acd
с дополнительными полями, списком категорий и сортировкой по цене	https://api.multisearch.io/?id=12515&query=ніж&uid=cc441f080&limit=10&categories=0&fields=true&sort=price.asc &key=88d22a39f2adf7b10e2a434fa1d21acd
со списком категорий и пагинацией	https://api.multisearch.io/?id=12515&query=ніж&uid=cc441f080&limit=10&categories=0&offset=10 &key=88d22a39f2adf7b10e2a434fa1d21acd

HTTP-заголовки

Заголовок	Значение	Описание	Обязательный параметр	Пример
X-Forwarded-For	IP конечного пользователя, который отправил поисковый запрос	Можно использовать для: • защиты от ботов и парсинга через поиск • исключения записи данных в аналитику поиска Срок хранения: 1 месяц	Необязательный	curl -H 'X-Forwarded-For: 1.2.3.4' 'https://api.multisearch.io/?id=12515&query=ніж &key=88d22a39f2adf7b10e2a434fa1d21acd'