TikTok Shop Product
Товары TikTok Shop — это публичные страницы товаров с данными об идентификации, продавце, ценах, медиа, категории, вариантах, рейтинге, числе отзывов и числе продаж. Эти поля помогают обогащать данные о товарах, исследовать каталоги, анализировать мерчандайзинг и сравнивать состояние товара на определенный момент времени.
Возможности TikTok Shop Product API
- Детали одной страницы PDPОтправьте один поддерживаемый URL публичной страницы товара TikTok Shop и получите не более одной нормализованной записи товара: эндпоинт подходит для обогащения известного товара, а не для поиска товаров.
- Продавец, цена и видимые торговые показателиЗапись товара сохраняет доступные данные о продавце, цену продажи и исходную цену, валюту, скидку, рейтинг, число отзывов и число продаж для прямой оценки по каждому полю.
- Медиа, категории и SKUВозвращаемые записи содержат доступные изображения товара с размерами, а также структуру категорий и SKU или вариантов с публичной страницы товара.
Параметры TikTok Shop Product API
| Параметры | Обязательный | Описание |
|---|---|---|
url | Обязательный | Обязательный URL публичного товара TikTok Shop вида /shop/pdp/{numeric_id} или /shop/pdp/{slug}/{numeric_id}; одна задача принимает один товар. |
region | Необязательный | Необязательный регион рынка TikTok Shop; по умолчанию US, при этом доступность товаров в других поддерживаемых регионах может различаться. |
Как использовать TikTok Shop Product API
Отправьте поддерживаемый URL товара, сохраните ID асинхронной задачи и прочитайте нормализованный товар после успешного завершения задачи.
- Отправьте POST-запрос на /v1/tiktok-shop/product с одним поддерживаемым url страницы PDP и необязательным region.
- Сохраните возвращенный task_id и опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded или failed.
- После успешного завершения читайте data.results.items и переходите по next_cursor, только если has_more равно true.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/product" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.tiktok.com/shop/pdp/example-product/1729587769570529799","region":"US"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items after status becomes succeededСценарии использования TikTok Shop Product API
- Обогащение результатов поиска или каталога: Используйте известный URL страницы товара, чтобы добавить поля продавца, цены, рейтинга, медиа, категории и SKU к товару, выбранному из поиска или каталога магазина.
- Сравнение снимков показателей товара: Сравнивайте собранные цену продажи, исходную цену, скидку, рейтинг, число отзывов и число продаж в записях товара за разные моменты времени.
- Анализ категорий и вариантов: Изучайте доступные структуры категорий, изображений и SKU, чтобы понять, как организован и представлен публичный товар.
Практические советы по TikTok Shop Product API
- Перед отправкой проверяйте, что на входе полный URL страницы товара на tiktok.com с числовым ID товара, иначе запрос будет отклонен.
- Оставляйте region равным US, если товар не относится к другому поддерживаемому рынку, а пустой результат для региона вне US считайте возможной границей доступности.
- Не передавайте results_limit: одна задача принимает один URL товара и возвращает не более одной нормализованной записи.
- Считайте поля продавца, цены, показателей, медиа, категорий и SKU, которые могут быть null, снимком публичной страницы, а успешную задачу без элемента обрабатывайте, не создавая товар-заглушку.
Связанные API
Помимо TikTok Shop Product API, используйте эти API, когда нужен другой тип публичных данных TikTok Shop.
- TikTok Shop Search API — Ищите публичные товары TikTok Shop по ключевому слову и региону рынка: продавец, цена, медиа, рейтинг, отзывы и число продаж.
- TikTok Shop Products API — Собирайте публичные товары по URL одного магазина TikTok Shop: продавец, цена, медиа, категория, 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, уровни, родители и пути.