Skip to content
W

Wiki

Главная страница API поиска товаров

Наш API предоставляет мощные и быстрые инструменты для полнотекстового поиска товаров по множеству магазинов, сравнения цен и получения детальной аналитики (включая AI-сводки).

📚 Возможности

  • 🔎 Умный поиск товаров – поиск по названию с поддержкой неточного поиска (fuzzy), фильтрация по городу, магазинам, скидкам и диапазонам цен.
  • 📦 Массовый поиск (Bulk Search) – возможность отправлять до 50 поисковых запросов одновременно для параллельной обработки.
  • 🏷️ Детальная карточка товара – получение полной информации о конкретном товаре по его ID (включая характеристики, историю цен и похожие товары).
  • 🔑 Управление лицензиями – проверка статуса и срока действия вашего API-ключа.

🔑 Авторизация и API-ключи

Для выполнения любых запросов к API необходимо использовать лицензионный ключ. Приобрести его можно на портале keys.poisk.im.

Ключ передается в каждом запросе через HTTP-заголовок API-KEY.

Типы ключей:

  • Демо-ключ: Ограничение 10 RPM (запросов в минуту), срок действия 7 дней.
  • Коммерческие ключи: Ограничение 60 RPM, доступны на 1 месяц, 3 месяца и 1 год.

💡 Вы всегда можете проверить статус и срок действия вашего ключа через метод GET /api_dev/keys/info?key=ВАШ_КЛЮЧ.

📖 Разделы документации

Полное описание параметров, моделей ответов и кодов ошибок доступно в профильных разделах:

🚀 Быстрый старт

Ниже приведены базовые примеры вызова основных методов API.

1️⃣ Поиск товаров

Метод: POST /api_dev/search/

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

Заголовки:

  • Content-Type: application/json; charset=utf-8
  • API-KEY: RPM10-xxxx-xxxx-xxxx-D7

Тело запроса:

{
  "query": "ноутбук",
  "city": 1,
  "page": 0,
  "page_limit": 40
}

2️⃣ Получение товара по ID

Метод: POST /api_dev/product/?product={id}

Обратите внимание: ID продукта передается в URL, а ID города — в теле запроса.

Пример URL: POST /api_dev/product/?product=414349955171223140

Тело запроса:

{
  "city": 1
}

💻 Примеры кода

Пример на 1С (Поиск товаров)

Перем HTTPСоединение, Запрос, Ответ, ТелоЗапросаJSON, ОтветJSON;

HTTPСоединение = Новый HTTPСоединение("poisk.im", , , , , Истина); 

ТелоЗапросаJSON = Новый ЗаписьJSON;
ТелоЗапросаJSON.ОткрытьСтроку();
ЗаписатьJSON(ТелоЗапросаJSON, Новый Структура(
    "query", "ноутбук",
    "city", 1
));
ТелоЗапроса = ТелоЗапросаJSON.ЗакрытьСтроку();

Запрос = Новый HTTPЗапрос("/api_dev/search/");
Запрос.УстановитьТелоИзСтроки(ТелоЗапроса, "application/json; charset=utf-8");
Запрос.УстановитьЗаголовок("API-KEY", "ВАШ_КЛЮЧ_ЗДЕСЬ");

Попытка
    Ответ = HTTPСоединение.ОтправитьДляОбработки(Запрос);
    ОтветJSON = ПрочитатьJSON(Ответ.ПолучитьТелоКакСтроку());
    Сообщить(ОтветJSON);
Исключение
    Сообщить("Ошибка выполнения запроса: " + ОписаниеОшибки());
КонецПопытки;

Пример на Python (Поиск товаров)

import requests
import json

url = "https://poisk.im/api_dev/search/" 
headers = {
    'Content-Type': 'application/json',
    'API-KEY': 'ВАШ_КЛЮЧ_ЗДЕСЬ'
}
data = {
    "query": "ноутбук",
    "city": 1
}

try:
    response = requests.post(url, data=json.dumps(data), headers=headers)
    response.raise_for_status()
    print(response.json())
except requests.exceptions.RequestException as e:
    print(f"Ошибка выполнения запроса: {e}")

🛠️ Технологический стек

  • Backend: C# / ASP.NET Core
  • Поисковый движок: Manticore Search (для молниеносного полнотекстового поиска и фасетной фильтрации).
  • База данных: MariaDB (основное хранилище контента).