Исследование товаров в 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 Products | ID, JP, MX, MY, PH, SG, TH, VN | нет, обязательный параметр |
| Categories, Category Products, Search Suggestions | US, SG, MY, PH, TH, VN, ID, JP, MX | US |
В 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, чтобы увидеть, какие товары ранжируются по каждой из них.
Обход категорий за три вызова
Типичный исследовательский прогон для одного рынка:
- Один раз вызовите Categories для рынка и сохраните дерево (0.5 кредита).
- Выберите интересующие вас конечные категории (
is_leaf: true) и вызовите Category Products для каждой. - Вызовите 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