TikTok Shop User Showcase
Витрины пользователей TikTok Shop — это подборки товаров, привязанные к публичным профилям TikTok, с данными о товаре и продавце, ценами, медиа, рейтингами, числом отзывов и числом продаж, если они доступны. Эти торговые показатели помогают анализировать ассортимент, делать региональные снимки, сравнивать товары и обогащать исследовательские датасеты.
Возможности TikTok Shop User Showcase API
- Сбор витрины по одному имени пользователяСобирайте публичные товары, показанные для одного имени пользователя TikTok; хендл принимается как с начальным @, так и без него.
- Выбор региона рынкаВыберите одно из 16 поддерживаемых значений региона, чтобы сбор витрины был направлен на нужный публичный рынок TikTok Shop.
- Ограниченный набор уникальных товаровЗапрашивайте от 20 до 2 000 товаров витрины; страницы сбора очищаются от дубликатов по публичному идентификатору товара.
- Нормализованные данные о товаре и продавцеВозвращает ID товаров, названия, описания, канонические ссылки, изображения, поля продавца, цены, категории и структуры SKU, если они доступны.
- Видимые торговые показатели и границы публичных данныхСохраняет доступные рейтинги, число отзывов, число продаж, статус, регион и время сбора, оставляя недоступные публичные поля пустыми.
Параметры TikTok Shop User Showcase API
| Параметры | Обязательный | Описание |
|---|---|---|
username | Обязательный | Обязательное публичное имя пользователя TikTok. Одна задача принимает одно значение, с начальным @ или без него. |
results_limit | Необязательный | Запрашиваемый лимит уникальных товаров витрины от 20 до 2 000. По умолчанию 100. |
region | Необязательный | Регион рынка: US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP или IE. По умолчанию US. |
Как использовать TikTok Shop User Showcase API
Отправьте одно публичное имя пользователя и рынок как асинхронную задачу, а затем читайте сохраненные товары витрины с курсорной пагинацией.
- Подготовьте одно публичное имя пользователя TikTok, выберите поддерживаемый region и укажите results_limit от 20 до 2 000.
- Отправьте запрос методом POST на /v1/tiktok-shop/user-showcase и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не перейдет в статус succeeded или failed.
- Читайте data.results.items. Если has_more равно true, продолжайте с next_cursor.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/user-showcase" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"mrtiktokreviews","results_limit":100,"region":"US"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueСценарии использования TikTok Shop User Showcase API
- Анализ ассортимента витрины пользователя: Используйте ID товаров, названия, ссылки, данные о продавце, изображения и категории, чтобы изучить публичные товары, показанные для одного имени пользователя.
- Сравнение цен и видимого спроса: Сравнивайте доступные цены, валюты, скидки, рейтинги, число отзывов и число продаж у возвращенных товаров витрины.
- Региональные снимки витрины: Сохраняйте input_username, регион, данные о товаре, публичные торговые поля и collected_at, чтобы повторять анализ на определенный момент времени.
- Обогащение датасета для исследования товаров: Добавляйте канонические URL товаров, данные о продавце, медиа, категории, SKU и видимые метрики в существующий исследовательский набор, построенный по именам пользователей.
Практические советы по TikTok Shop User Showcase API
- Используйте одно и то же написание имени пользователя во всех запусках: эндпоинт принимает @handle или handle и сохраняет нормализованное входное имя с каждым товаром.
- Выбирайте рынок, соответствующий нужному каталогу: по умолчанию region равен US, а публичная доступность за пределами US может различаться.
- Задавайте results_limit от 20 до 2 000 в зависимости от нужного охвата и не рассчитывайте, что в каждой витрине есть 100 товаров по умолчанию.
- После успешного завершения переходите по next_cursor, пока has_more равно true, чтобы пагинация результатов задачи не оставила сохраненные товары непрочитанными.
- Удаляйте дубли в снимках по id товара и считайте пустые задачи или отсутствующие поля продавца, цены, медиа, категории, SKU и метрик допустимым результатом публичного источника.
Связанные API
Помимо TikTok Shop User Showcase API, используйте эти API, когда нужен другой тип публичных данных TikTok Shop.
- TikTok Shop Search API — Ищите публичные товары TikTok Shop по ключевому слову и региону рынка: продавец, цена, медиа, рейтинг, отзывы и число продаж.
- TikTok Shop Products API — Собирайте публичные товары по URL одного магазина TikTok Shop: продавец, цена, медиа, категория, SKU, рейтинг, отзывы и число продаж.
- TikTok Shop Product API — Получайте один публичный товар TikTok Shop по URL карточки товара: продавец, цена, медиа, категория, SKU, рейтинг, отзывы и число продаж.
- TikTok Shop Product Reviews API — Собирайте публичные отзывы по URL одной карточки товара TikTok Shop: текст, оценка, автор, изображения, SKU, страна и контекст покупки.
- TikTok Shop Hot Products API — Собирайте самые продаваемые товары рынка TikTok Shop по коду региона в порядке рейтинга: цена, валюта, продажи, оценка и магазин.
- TikTok Shop Categories API — Получайте полное дерево категорий рынка TikTok Shop: ID, названия, английские slug, уровни, родители и пути.