TikTok Shop Products
Товары TikTok Shop — это публичные позиции витрины магазина с данными о товаре и продавце, изображениями, ценами, категориями, данными SKU, рейтингами, числом отзывов и числом продаж. Эти записи помогают делать снимки каталога витрины, сравнивать ассортимент, отслеживать публичные цены и обогащать данные на уровне отдельных товаров.
Возможности TikTok Shop Products API
- Настройки сбора каталога магазинаСобирайте товары по одному поддерживаемому URL публичного магазина с заданным лимитом результатов, сортировкой по топу или новинкам и документированным регионом рынка.
- Идентификация товара, продавца и медиаВозвращает в каждой записи ID товаров, названия, доступные описания, канонические URL, данные о продавце или магазине и ссылки на публичные изображения без дубликатов.
- Цены и видимые торговые показателиСохраняет доступные цену продажи и исходную цену, валюту, отформатированные значения, скидки, рейтинги, число отзывов и число продаж для сравнения товаров.
- Структурированные строки каталогаСохраняет доступные статус, категорию и структуры SKU в нормализованных строках товаров и исключает счетчики уровня магазина, не привязанные к отдельному товару.
Параметры TikTok Shop Products API
| Параметры | Обязательный | Описание |
|---|---|---|
url | Обязательный | Обязательный URL публичного магазина TikTok Shop вида /shop/store/{slug}/{numeric_shop_id}; одна задача принимает один магазин. |
results_limit | Необязательный | Максимальное число уникальных товаров, сохраняемых со всех страниц источника; по умолчанию 100, допускаются целые числа от 20 до 2 000. |
sort_by | Необязательный | Порядок сортировки каталога магазина в источнике: top — по самым продаваемым товарам, new_releases — по новинкам; по умолчанию top. |
region | Необязательный | Регион рынка TikTok Shop; по умолчанию US, доступность публичного каталога в других поддерживаемых регионах может различаться. |
Как использовать TikTok Shop Products API
Отправьте один URL публичного магазина TikTok Shop с необязательными параметрами сбора, отслеживайте асинхронную задачу и читайте нормализованные записи товаров с курсорной пагинацией.
- Подготовьте один поддерживаемый URL вида /shop/store/{slug}/{numeric_shop_id} и выберите значения results_limit, sort_by и region.
- Отправьте запрос методом POST на /v1/tiktok-shop/products и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- Читайте data.results.items и запрашивайте возвращенный next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/products" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079","results_limit":100,"sort_by":"top","region":"US"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueСценарии использования TikTok Shop Products API
- Снимки каталога витрины: Используйте ID товаров, названия, URL, продавцов, цены, изображения, категории, структуры SKU и collected_at, чтобы собрать публичный каталог магазина на определенный момент.
- Сравнение ассортимента топа и новинок: Соберите один и тот же магазин с сортировкой top и new_releases, а затем сравните возвращенные данные о товарах, цены, категории и видимые показатели.
- Отслеживание публичных цен и показателей: Сравнивайте независимо собранные поля цены, скидки, рейтинга, числа отзывов, числа продаж, статуса и времени сбора для совпадающих ID товаров.
- Подготовка шорт-листа URL товаров: Используйте канонические URL товаров, названия, изображения, данные о продавце и видимые метрики, чтобы отбирать возвращенные товары для получения деталей или анализа отзывов.
Практические советы по TikTok Shop Products API
- Перед отправкой задачи проверяйте, что на входе публичный путь /shop/store/ на tiktok.com с числовым ID магазина.
- Указывайте в region рынок магазина, который вы хотите изучить; если корректный магазин не вернул записей, проверьте региональную доступность перед повторной попыткой.
- Используйте top для сортировки источника по самым продаваемым товарам или new_releases для сортировки по новинкам и не считайте ни один из режимов гарантией прибыльности или трендовости.
- Считайте results_limit максимумом сбора и переходите по отдельному курсору результатов задачи, пока has_more не станет false, чтобы прочитать все сохраненные строки.
- Связывайте повторные снимки по ID товара, сохраняйте collected_at и обрабатывайте поля продавца, цены, статуса, категории, SKU, медиа и метрик как необязательные.
Связанные API
Помимо TikTok Shop Products API, используйте эти API, когда нужен другой тип публичных данных TikTok Shop.
- TikTok Shop Search API — Ищите публичные товары TikTok Shop по ключевому слову и региону рынка: продавец, цена, медиа, рейтинг, отзывы и число продаж.
- TikTok Shop Product API — Получайте один публичный товар TikTok Shop по URL карточки товара: продавец, цена, медиа, категория, SKU, рейтинг, отзывы и число продаж.
- TikTok Shop Product Reviews API — Собирайте публичные отзывы по URL одной карточки товара TikTok Shop: текст, оценка, автор, изображения, SKU, страна и контекст покупки.
- TikTok Shop User Showcase API — Собирайте публичные товары с витрины одного пользователя TikTok: цена, продавец, медиа, рейтинг, отзывы, число продаж и региональный контекст.
- TikTok Shop Hot Products API — Собирайте самые продаваемые товары рынка TikTok Shop по коду региона в порядке рейтинга: цена, валюта, продажи, оценка и магазин.
- TikTok Shop Categories API — Получайте полное дерево категорий рынка TikTok Shop: ID, названия, английские slug, уровни, родители и пути.