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'