tiktok-shop/
product-reviews

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

TikTok Shop Product Reviews API

URL одной страницы товара
Публичный текст отзывов и оценки
SKU и контекст покупки
Сбор с учетом региона
0,3 кредита за результат
Готово
Готово

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

README

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

TikTok Shop Product Reviews

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

Возможности TikTok Shop Product Reviews API

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

Параметры TikTok Shop Product Reviews API

ПараметрыОбязательныйОписание
urlОбязательныйОбязательный URL публичного товара TikTok Shop вида /shop/pdp/{numeric_id} или /shop/pdp/{slug}/{numeric_id}; одна задача принимает один товар.
results_limitНеобязательныйМаксимальное число уникальных отзывов, сохраняемых со всех страниц источника; по умолчанию 100, допускаются целые числа от 20 до 2 000.
regionНеобязательныйРегион рынка TikTok Shop; по умолчанию US, доступность публичных товаров и отзывов в других поддерживаемых регионах может различаться.

Как использовать TikTok Shop Product Reviews API

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

  1. Подготовьте один поддерживаемый url страницы товара TikTok Shop, results_limit от 20 до 2 000 и region рынка товара.
  2. Отправьте запрос методом POST на /v1/tiktok-shop/product-reviews и сохраните возвращенный task_id.
  3. Опрашивайте GET /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
  4. Читайте data.results.items и запрашивайте возвращенный next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/product-reviews" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.tiktok.com/shop/pdp/example-product/1729587769570529799","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 Product Reviews API

  • Анализ отзывов о товаре: Используйте текст отзывов, числовые оценки, метки времени и данные о товаре, чтобы изучать публичные отзывы, полученные для одного известного товара.
  • Сравнение отзывов по SKU и регионам: Группируйте записи по характеристикам SKU или стране отзыва и сравнивайте их текст и оценки, не додумывая значения отсутствующих полей.
  • Контекст покупки и медиа в отзывах: Просматривайте изображения, добавленные покупателями, и сегментируйте записи по явным признакам подтвержденной покупки или отзыва за вознаграждение, если эти значения есть.

Практические советы по TikTok Shop Product Reviews API

  • Перед отправкой проверяйте, что на входе полный URL страницы товара на tiktok.com с числовым ID товара: URL профилей, видео, магазинов и другие URL TikTok отклоняются.
  • Выбирайте регион, соответствующий рынку товара: корректный URL может не вернуть публичных отзывов, если на выбранном рынке товар или его лента отзывов недоступны.
  • Задавайте results_limit от 20 до 2 000 для нужного охвата сбора, а затем переходите по next_cursor, пока has_more не станет false, чтобы прочитать все сохраненные страницы результатов.
  • Считайте отсутствующие текст отзыва, данные об авторе, сведения о SKU и признаки статуса покупки неизвестными: отсутствующее логическое значение не равно false, а запись только с оценкой остается корректной.

Помимо TikTok Shop Product Reviews 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 User Showcase API — Собирайте публичные товары с витрины одного пользователя TikTok: цена, продавец, медиа, рейтинг, отзывы, число продаж и региональный контекст.
  • TikTok Shop Hot Products API — Собирайте самые продаваемые товары рынка TikTok Shop по коду региона в порядке рейтинга: цена, валюта, продажи, оценка и магазин.
  • TikTok Shop Categories API — Получайте полное дерево категорий рынка TikTok Shop: ID, названия, английские slug, уровни, родители и пути.

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

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

TikTok Shop Product Reviews API — FAQ

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

Используйте URL на tiktok.com или поддомене TikTok, путь которого имеет вид /shop/pdp/{numeric_id} или /shop/pdp/{slug}/{numeric_id}. По умолчанию region равен US; допустимые значения — US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP и IE.

Эти поля передают только явные значения, указанные в публичном отзыве. Если какое-либо из них отсутствует, считайте его значение неизвестным, а не false, и не делайте выводов о подтверждении покупки или вознаграждении.

results_limit — это максимум, а не гарантированное количество. Сбор останавливается, когда заканчивается доступная лента отзывов, источник сообщает границу has_more или достигнут лимит; удаленный, недоступный, ограниченный по региону или закрытый для публичного доступа товар может не дать записей.

Каждый сохраненный отзыв стоит 0,3 кредита SocQ, включая все уникальные отзывы, сохраненные со всех страниц источника. За задачу без сохраненных отзывов плата за результаты не взимается.