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 товара, отслеживайте асинхронную задачу и читайте нормализованные записи отзывов с курсорной пагинацией.
- Подготовьте один поддерживаемый url страницы товара TikTok Shop, results_limit от 20 до 2 000 и region рынка товара.
- Отправьте запрос методом POST на /v1/tiktok-shop/product-reviews и сохраните возвращенный task_id.
- Опрашивайте GET /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- Читайте 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, а запись только с оценкой остается корректной.
Связанные API
Помимо 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, уровни, родители и пути.