Исследуйте тренды 1688 глубже
Сопоставляйте результаты поиска, витрину и карточки с доступными аналитическими показателями. Данные зависят от метода и периода; ответ не является оценкой всего рынка.
Free: 10 успешных вызовов · 30 дней с первого ключа; до 1 API-ключей.
Для аналитики нужен отдельный API-токен, тариф и отдельная квота этого сервиса.
От поиска к показателям
POST /analytics/1688/api/v1/products/search
Выберите метод и период
Выберите задачу исследования. Для поиска и витрины передавайте keyword на упрощённом китайском: автоматического перевода нет.
rolling_7d или rolling_30d.
Billboard · ВитринаКалендарная неделя или месяц: period_type и date.
Detail · КарточкаОдин товар и его доступные показатели; структура отличается от поиска.
Image · Поиск по изображениюПохожие товары, месячные показатели и продолжение выборки через image_id, если он доступен.
Отправьте запрос отдельным ключом
Создайте ключ аналитики 1688 в кабинете и передайте его в заголовке X-API-Token. Ключ и квота обычного 1688 не заменяют доступ к аналитике.
curl -X POST "https://bhapi.ru/analytics/1688/api/v1/products/search" \
-H "X-API-Token: YOUR_ANALYTICS_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"keyword":"保温杯","period":"rolling_30d","page":1,"page_size":10}'Замените ключ своим. rolling_30d — скользящие 30 дней, а не календарный месяц. Успешный проверенный ответ расходует одну единицу BHAPI; повтор является новым вызовом.
Сопоставьте показатели
Search и Billboard возвращают data.items с объектом analytics. Сравнивайте товары в одном периоде и учитывайте единицы измерения.
orders· Заказы- Число заказов за период. Заказы не равны выкупам и не показывают количество единиц в каждом заказе.
units_sold· Единицы- Количество проданных единиц за период, отдельно от числа заказов.
estimated_sales· Оценочная сумма- Денежная оценка продаж за период:
amount— десятичная строка,currency— валюта, если известна;estimated: trueобозначает оценку.
null означает отсутствие подтверждённого значения, не ноль. meta.snapshot_date=null означает неизвестную свежесть источника; retrieved_at — время получения BHAPI. pagination.total отражает доступную выборку, не весь рынок.
У Detail и Image собственные схемы: не переносите поля и периоды Search на остальные методы.
Полная схема, единицы и ограничения →