tiktok-shop/
products

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

TikTok Shop Products API

URL одного магазина
Топ или новинки
20–2 000 товаров в запросе
Нормализованные записи товаров
0,7 кредита за результат
Готово
Готово

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

README

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

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 с необязательными параметрами сбора, отслеживайте асинхронную задачу и читайте нормализованные записи товаров с курсорной пагинацией.

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

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

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

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

TikTok Shop Products API — FAQ

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

url должен быть на tiktok.com или поддомене TikTok и иметь вид /shop/store/{slug}/{numeric_shop_id}. Запрос также принимает results_limit от 20 до 2 000, sort_by со значением top или new_releases и одно документированное значение region.

top запрашивает сортировку источника по самым продаваемым товарам, а new_releases — сортировку по новинкам. Это режимы сортировки источника, и они не гарантируют прибыльность, трендовость или полный рейтинг ассортимента.

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

results_limit — это максимум, а не гарантированное количество. Сбор останавливается, когда в выбранном регионе больше нет доступных товаров или курсора, а повторяющиеся ID товаров сохраняются в задаче один раз.

После успешного завершения задачи читайте data.results.items из GET /v1/tasks/{task_id}. Пока has_more равно true, передавайте next_cursor в тот же эндпоинт задачи, пока has_more не станет false.

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