TikTok Shopисследование товаровэлектронная коммерцияпоисковые подсказкируководство по API

API для исследования товаров TikTok Shop: хиты продаж, категории и поисковые подсказки

Четыре новых эндпоинта SocQ для TikTok Shop возвращают хиты продаж по рынкам, полное дерево категорий, товары в категории и поисковые подсказки, которые видят покупатели.

SocQОбновлено 19 ноября 2026 г.7 мин чтения

Исследование товаров в TikTok Shop начинается с трех вопросов: что продается на рынке, что входит в категорию и что покупатели вводят в поиск. SocQ уже возвращал поиск товаров, каталоги магазинов, страницы товаров, отзывы и витрины авторов; они сравниваются в статье 7 лучших API и парсеров TikTok Shop. 2026-11-17 на страницу платформы TikTok Shop добавились четыре эндпоинта, которые напрямую отвечают на эти три вопроса.

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

Коротко: отправьте JSON-тело на POST https://api.socq.ai/v1/tiktok-shop/<endpoint>. Сохраните возвращенный task_id, опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded, затем читайте data.results.items.

Новые эндпоинты TikTok Shop

1 кредит SocQ = $0.005.

ЭндпоинтЧто возвращаетЦена
TikTok Shop Hot Products APIХиты продаж рынка в порядке TikTok Shop, с ценой, числом проданных единиц, рейтингом и магазином0.5 кредита ($0.0025) за товар
TikTok Shop Categories APIПолное дерево категорий рынка, по одной строке на категорию с ID, уровнем и родителем0.5 кредита ($0.0025) за вызов
TikTok Shop Category Products APIТовары одной категории с ценой, числом проданных единиц, рейтингом, отзывами и магазином0.5 кредита ($0.0025) за товар
TikTok Shop Search Suggestions APIДо 20 вариантов автодополнения для начала запроса, по порядку0.5 кредита ($0.0025) за вызов

Поддерживаемые рынки

ЭндпоинтЗначения regionПо умолчанию
Hot ProductsID, JP, MX, MY, PH, SG, TH, VNнет, обязательный параметр
Categories, Category Products, Search SuggestionsUS, SG, MY, PH, TH, VN, ID, JP, MXUS

В Hot Products нет US. Для исследования товаров в США используйте Categories и Category Products.

Аутентификация и асинхронные задачи

Все запросы аутентифицируются API-ключом. Один и тот же заголовок используется для отправки задачи, проверки статуса и получения результатов:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Каждый сбор данных выполняется как фоновая задача:

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

Вызов отправки сразу возвращает data.task_id и data.status. Опрашивайте задачу по этому ID:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Когда status равен succeeded, ответ содержит result_count, credits_amount и первую страницу нормализованных записей в data.results.items. По умолчанию limit равен 50, максимум 500. Если results.has_more равно true, передайте results.next_cursor как cursor, чтобы прочитать следующую страницу. Задача с ошибкой содержит error_message.

Каждый эндпоинт также принимает необязательный callback_url. SocQ отправит один POST со сводкой задачи после ее завершения; записи читайте через эндпоинт задачи. Тайм-аут на стороне клиента не отменяет задачу, поэтому продолжайте с тем же ID задачи, а не отправляйте ее повторно. 402 означает, что у аккаунта закончились кредиты, а 429 — что ключ достиг лимита запросов или кредитов.

Hot Products: что продается на рынке

Hot Products API возвращает хиты продаж рынка в том порядке, в каком их ранжирует TikTok Shop. У каждого товара есть название, price (сумма, валюта и форматированная строка), sold_count, rating, reviews_count, seller и изображения, а также url страницы товара. region обязателен. По умолчанию results_limit равен 50, допустимы значения от 1 до 200. (документация)

curl -X POST "https://api.socq.ai/v1/tiktok-shop/hot-products" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"region": "MY", "results_limit": 50}'

Когда использовать: еженедельный снимок по каждому рынку, чтобы замечать товары-прорывы, сравнивать цены или выбирать товары для закупки и продвижения. Цены возвращаются в местной валюте, например MYR для Малайзии, поэтому конвертируйте их перед сравнением рынков.

Categories: полное дерево категорий

Categories API возвращает все категории рынка за один вызов. У каждой строки есть id категории, name, английский slug, level, parent_id, is_leaf, path (названия вышестоящих категорий), cover_url и region. У категорий верхнего уровня parent_id: null и level: 1, поэтому иерархию можно восстановить как дерево или хранить как плоскую справочную таблицу. (документация)

curl -X POST "https://api.socq.ai/v1/tiktok-shop/categories" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"region": "US"}'

Когда использовать: один раз на рынок, после чего результат кешируется. ID нужны для Category Products, а дерево полезно для сопоставления категорий TikTok Shop с вашим собственным каталогом.

Category Products: просмотр категории глазами покупателя

Category Products API принимает числовой category_id из Categories API и возвращает товары этой категории с названием, ценой, числом проданных единиц, рейтингом, отзывами, магазином и изображениями. region по умолчанию US. По умолчанию results_limit равен 30, допустимы значения от 1 до 500. (документация)

curl -X POST "https://api.socq.ai/v1/tiktok-shop/category-products" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id": "601450", "region": "US", "results_limit": 30}'

Когда использовать: чтобы сравнивать ценовые диапазоны подкатегорий или следить за тем, как со временем меняются бестселлеры категории.

Search Suggestions: что вводят покупатели

Search Suggestions API принимает начало поискового запроса в query и возвращает до 20 вариантов автодополнения, пронумерованных начиная с 1, в том порядке, в каком их предлагает TikTok Shop. У каждой строки есть keyword, отправленный вами query, его rank и region. region по умолчанию US. (документация)

curl -X POST "https://api.socq.ai/v1/tiktok-shop/search-suggestions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "phone case", "region": "US"}'

Когда использовать: исследование ключевых слов для карточек товаров, рекламы и контента. Для phone case первая подсказка в примере из документации — phone cases 17 pro max, что показывает, для каких моделей устройств покупают чехлы. Передавайте подсказки в TikTok Shop Search, чтобы увидеть, какие товары ранжируются по каждой из них.

Обход категорий за три вызова

Типичный исследовательский прогон для одного рынка:

  1. Один раз вызовите Categories для рынка и сохраните дерево (0.5 кредита).
  2. Выберите интересующие вас конечные категории (is_leaf: true) и вызовите Category Products для каждой.
  3. Вызовите Search Suggestions с основными товарными словами каждой категории, чтобы увидеть, как покупатели формулируют запросы.

Десять категорий по 30 товаров — это 300 товаров, или 150 кредитов. Добавьте дерево (0.5) и десять вызовов подсказок (5), и прогон обойдется в 155.5 кредита, около $0.78. На рынке, который поддерживает Hot Products, снимок из 50 товаров добавит 25 кредитов ($0.125).

Внимательно читайте поля

Строки товаров имеют одинаковую нормализованную структуру во всех трех эндпоинтах товаров. Как и в других полях SocQ, значение, которое источник не предоставляет, равно null, а не 0. В примерах из документации rating, reviews_count и sold_count для показанных товаров равны null, поэтому считайте отсутствующие продажи или рейтинги неизвестными, а не нулевыми, прежде чем ранжировать по ним товары.

Чтобы глубже изучить отдельный товар, передайте его url в TikTok Shop Product API, который сейчас обслуживает только регион США, и в Product Reviews API. Другие способы получить данные TikTok Shop описаны в статье Альтернативы API TikTok Shop. Товары, которые продаются во время LIVE-эфиров, покрывает TikTok Live Shopping API из руководства по новым эндпоинтам TikTok.

FAQ

Нужен ли аккаунт продавца или партнера TikTok Shop?

Нет. Эндпоинты читают публичные данные TikTok Shop, а аутентификация выполняется API-ключом SocQ.

Почему Hot Products не принимает US?

US не входит в его значения region. Hot Products охватывает ID, JP, MX, MY, PH, SG, TH и VN. Остальные три эндпоинта поддерживают US и используют его по умолчанию.

Откуда берутся ID категорий?

Из Categories API. id каждой строки — это category_id, который принимает Category Products, для того же region.

Как тарифицируется каждый эндпоинт?

Categories и Search Suggestions стоят 0.5 кредита за вызов независимо от числа возвращенных строк. Hot Products и Category Products стоят 0.5 кредита за каждый возвращенный товар.

Сколько подсказок возвращает один запрос?

До 20, пронумерованных начиная с 1 в порядке TikTok Shop.

TIKTOK SHOP API

Проверить сценарий на публичном URL TikTok Shop

Отправляйте публичные входные данные и получайте нормализованные записи с отслеживаемым источником.

API для TikTok Shop