tiktok-shop/
user-showcase

Собирайте товары из витрины TikTok Shop одного публичного пользователя TikTok по имени пользователя и региону и получайте поля продавца, цены, медиа, рейтинга, отзывов и числа продаж.

TikTok Shop User Showcase API

Имя пользователя на входе
Товары витрины
Региональные каталоги
0,7 кредита за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

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

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

  1. Подготовьте одно публичное имя пользователя TikTok, выберите поддерживаемый region и укажите results_limit от 20 до 2 000.
  2. Отправьте запрос методом POST на /v1/tiktok-shop/user-showcase и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не перейдет в статус succeeded или failed.
  4. Читайте 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 и метрик допустимым результатом публичного источника.

Помимо 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, уровни, родители и пути.

Другие платформы

Объединяйте данные TikTok Shop с публичными данными других поддерживаемых соцсетей.

TikTok Shop User Showcase API — FAQ

TikTok Shop User Showcase API собирает публично показанные товары Shop для одного имени пользователя TikTok и выбранного рынка. Он возвращает нормализованные поля товара, продавца, цены, медиа, категории, SKU, рейтинга, числа отзывов и числа продаж, если они доступны.

Отправьте одну непустую строку username. Принимаются и mrtiktokreviews, и @mrtiktokreviews, а начальный @ удаляется перед сбором.

results_limit принимает целые числа от 20 до 2 000, по умолчанию 100. region по умолчанию равен US и также принимает GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP и IE.

Результаты могут содержать данные о товаре и продавце, канонический URL, название, описание, изображения, сведения о цене, категории, SKU, статус, рейтинг, число отзывов, число продаж, входное имя пользователя, регион и время сбора.

У публичного профиля может не быть доступных товаров витрины на выбранном рынке, а источник может не передавать значения продавца, цены, медиа, категории, SKU или метрик. Поэтому успешная задача может не содержать элементов или содержать записи с пустыми необязательными полями.

Опрашивайте /v1/tasks/{task_id}, после успешного завершения читайте data.results.items и запрашивайте следующую страницу результатов задачи с next_cursor, пока has_more равно true.

Каждый возвращенный нормализованный товар витрины стоит 0,7 кредита SocQ. За пустые результаты плата не взимается.